Pengambilan dokumen

Pengambilan dokumen identitas. Mendukung RG (depan saja atau depan dan belakang), CNH (depan dan belakang), dan CPF, bila dikombinasikan dengan kemampuan Pengambilan dan Penggunaan Ulang Dokumen.

Untuk daftar lengkap jenis dokumen yang didukung beserta nilai enum-nya, lihat Referensi API > Enums.

Memulai pengambilan dokumen

Langkah 1 — Implementasikan AcessoBioListener

AcessoBioListener menangani callback siklus hidup SDK. Implementasikan empat metode wajib berikut:

Metode	Kapan dipanggil
`onErrorAcessoBio(errorBio)`	Terjadi kesalahan saat operasi SDK
`onUserClosedCameraManually()`	Pengguna menutup kamera secara manual
`onSystemClosedCameraTimeoutSession()`	Batas waktu sesi telah tercapai — lihat Batas waktu sesi
`onSystemChangedTypeCameraTimeoutFaceInference()`	Batas waktu inferensi wajah telah tercapai — beralih ke pengambilan manual — lihat Batas waktu sesi

Kotlin
Java

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

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

  @Override
  public void onUserClosedCameraManually() { }

  @Override
  public void onSystemClosedCameraTimeoutSession() { }

  @Override
  public void onSystemChangedTypeCameraTimeoutFaceInference() { }
};

Langkah 2 — Implementasikan iAcessoBioDocument

iAcessoBioDocument menangani callback hasil pengambilan dokumen:

Metode	Deskripsi
`onSuccessDocument(result)`	Pengambilan berhasil — mengembalikan `ResultCamera` dengan `base64` (pratinjau) dan `encrypted` (JWT untuk API)
`onErrorDocument(errorBio)`	Pengambilan gagal — mengembalikan `ErrorBio` dengan kode dan deskripsi

Kotlin
Java

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

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

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

Langkah 3 — Panggil prepareDocumentCamera

Dengan acessoBioBuilder yang sudah diinisialisasi dan kedua listener diimplementasikan, panggil prepareDocumentCamera dengan meneruskan konfigurasi SDK (UnicoConfig yang dibuat pada Inisialisasi), DocumentType yang diinginkan, dan sebuah DocumentCameraListener:

onCameraReady — kamera siap; panggil open dengan meneruskan documentListener dari Langkah 2.
onCameraFailed — persiapan kamera gagal; tangani pesan kesalahan.

Kotlin
Java

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

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

Untuk penanganan hasil secara lengkap, lihat Menerima hasil.