Penanganan kesalahan

Semua penanganan kesalahan untuk Android SDK dipusatkan di bagian ini. Callback onErrorAcessoBio menerima objek ErrorBio dengan code dan description.

Kode kesalahan

Kode	Kategori	Pesan default	Kapan terjadi	Penanganan yang disarankan
AUTH_FAILED	Autentikasi	SDK authentication failed	Kunci SDK tidak valid atau kedaluwarsa	Validasi kredensial dengan tim Onboarding
CAMERA_PERMISSION_DENIED	Izin	Camera permission denied	Pengguna menolak izin kamera	Arahkan pengguna ke pengaturan aplikasi
LIVENESS_FAILED	Pengambilan gambar	Liveness check failed	Gambar tidak lulus validasi liveness	Minta pengambilan gambar ulang
NETWORK_ERROR	Jaringan	Network error during capture	Konektivitas tidak memadai	Minta koneksi ulang
SDK_NOT_INITIALIZED	Siklus hidup	SDK not initialized	Pengambilan gambar dipanggil sebelum init	Pastikan init dipanggil di Application/onCreate

Kode kesalahan SDK

Kode-kode di atas mencakup kesalahan callback SDK utama. Kode kesalahan REST API (kelompok status HTTP) didokumentasikan secara terpisah di Referensi API > Kode kesalahan.

Menangani callback

Kotlin

override fun onErrorAcessoBio(error: ErrorBio) {
  when (error.code) {
    "AUTH_FAILED" -> { /* handle authentication failure */ }
    "CAMERA_PERMISSION_DENIED" -> { /* redirect to app settings */ }
    "LIVENESS_FAILED" -> { /* prompt the user to try again */ }
    else -> { /* generic error handling */ }
  }
}

Java

@Override
public void onErrorAcessoBio(ErrorBio error) {
  switch (error.getCode()) {
    case "AUTH_FAILED": /* handle authentication failure */ break;
    case "CAMERA_PERMISSION_DENIED": /* redirect to app settings */ break;
    case "LIVENESS_FAILED": /* prompt the user to try again */ break;
    default: /* generic error handling */
  }
}

Callback siklus hidup

Selain onErrorAcessoBio, SDK juga memicu:

• onUserClosedCameraManually() — pengguna menutup kamera secara manual.
• onSystemClosedCameraTimeoutSession() — sesi berakhir karena waktu habis.
• onSystemChangedTypeCameraTimeoutFaceInference() — tidak ada wajah terdeteksi selama 13 detik; SDK beralih ke pengambilan gambar manual.