---
title: التقاط المستندات
canonical: https://developer.unico.io/ar/dual-api/developer/sdks-and-tools/android-sdk/document-capture/
locale: ar
generated_by: markdown-export
---

التقاط وثائق الهوية. يدعم **RG** (الوجه الأمامي فقط أو الوجه الأمامي والخلفي)، **CNH** (الوجه الأمامي والخلفي)، و**CPF**، عند دمجه مع قدرة [التقاط المستندات وإعادة استخدامها](/capabilities/document-reuse-and-capture).

للاطلاع على القائمة الكاملة لأنواع المستندات المدعومة وقيم التعداد الخاصة بها، راجع [مرجع API > التعدادات](/developers/sdks-and-tools/android/api-reference/enums).

## بدء التقاط المستندات

****الخطوة 2** — تنفيذ `iAcessoBioDocument`**

تتولى `iAcessoBioDocument` معالجة callbacks نتيجة التقاط المستند:

  | الطريقة | الوصف |
  |---|---|
  | `onSuccessDocument(result)` | نجح الالتقاط — يُعيد `ResultCamera` مع `base64` (معاينة) و`encrypted` (JWT لواجهة API) |
  | `onErrorDocument(errorBio)` | فشل الالتقاط — يُعيد `ErrorBio` مع الرمز والوصف |

  ### Kotlin

    ```kotlin
    val documentListener = object : iAcessoBioDocument {
      override fun onSuccessDocument(result: ResultCamera?) { }
      override fun onErrorDocument(errorBio: ErrorBio?) { }
    }
    ```

### Java

    ```java
    iAcessoBioDocument documentListener = new iAcessoBioDocument() {
      @Override
      public void onSuccessDocument(ResultCamera result) { }

      @Override
      public void onErrorDocument(ErrorBio errorBio) { }
    };
    ```

****الخطوة 3** — استدعاء `prepareDocumentCamera`**

بعد تهيئة `acessoBioBuilder` وتنفيذ كلا المستمعين، استدعِ `prepareDocumentCamera` مع تمرير إعداد SDK (الـ `UnicoConfig` المنشأ في [التهيئة](/developers/sdks-and-tools/android/initialization))، ونوع `DocumentType` المطلوب، وـ`DocumentCameraListener`:

  - `onCameraReady` — الكاميرا جاهزة؛ استدعِ `open` مع تمرير `documentListener` من الخطوة 2.
  - `onCameraFailed` — فشل تجهيز الكاميرا؛ تعامل مع رسالة الخطأ.

  ### Kotlin

    ```kotlin
    acessoBioBuilder
      .build()
      .prepareDocumentCamera(UnicoConfig(), DocumentType.CNH, object : DocumentCameraListener {
        override fun onCameraReady(cameraOpener: UnicoCheckCameraOpener.Document?) {
          cameraOpener?.open(documentListener)
        }
        override fun onCameraFailed(message: String?) { }
      })
    ```

### Java

    ```java
    acessoBioBuilder
      .build()
      .prepareDocumentCamera(new UnicoConfig(), DocumentType.CNH, new DocumentCameraListener() {
        @Override
        public void onCameraReady(UnicoCheckCameraOpener.Document cameraOpener) {
          cameraOpener.open(documentListener);
        }

        @Override
        public void onCameraFailed(String message) { }
      });
    ```

للاطلاع على معالجة النتيجة الكاملة، راجع [استلام النتيجة](/developers/sdks-and-tools/android/capture-flow/receiving-the-result).