التقاط المستندات

التقاط وثائق الهوية. يدعم RG (الوجه الأمامي فقط أو الوجه الأمامي والخلفي)، CNH (الوجه الأمامي والخلفي)، وCPF، عند دمجه مع قدرة التقاط المستندات وإعادة استخدامها.

للاطلاع على القائمة الكاملة لأنواع المستندات المدعومة وقيم التعداد الخاصة بها، راجع مرجع API > التعدادات.

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

الخطوة 1 — تنفيذ AcessoBioListener

يتعامل AcessoBioListener مع استدعاءات دورة حياة SDK. قم بتنفيذ الطرق الأربع الإلزامية:

الطريقة	وقت استدعائها
onErrorAcessoBio(errorBio)	حدث خطأ أثناء تشغيل SDK
onUserClosedCameraManually()	أغلق المستخدم الكاميرا يدوياً
onSystemClosedCameraTimeoutSession()	تم بلوغ حد مهلة الجلسة — انظر حدود الجلسة
onSystemChangedTypeCameraTimeoutFaceInference()	تم بلوغ حد مهلة استنتاج الوجه — ينتقل إلى الالتقاط اليدوي — انظر حدود الجلسة

Kotlin

val callback = object : AcessoBioListener {
  override fun onErrorAcessoBio(errorBio: ErrorBio?) { }
  override fun onUserClosedCameraManually() { }
  override fun onSystemClosedCameraTimeoutSession() { }
  override fun onSystemChangedTypeCameraTimeoutFaceInference() { }
}

Java

AcessoBioListener callback = new AcessoBioListener() {
  @Override
  public void onErrorAcessoBio(ErrorBio errorBio) { }

  @Override
  public void onUserClosedCameraManually() { }

  @Override
  public void onSystemClosedCameraTimeoutSession() { }

  @Override
  public void onSystemChangedTypeCameraTimeoutFaceInference() { }
};

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

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

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

Kotlin

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

Java

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

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

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

بعد تهيئة acessoBioBuilder وتنفيذ كلا المستمعين، استدعِ prepareDocumentCamera مع تمرير إعداد SDK (الـ UnicoConfig المنشأ في التهيئة)، ونوع DocumentType المطلوب، وـDocumentCameraListener:

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

Kotlin

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

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) { }
  });

للاطلاع على معالجة النتيجة الكاملة، راجع استلام النتيجة.