--- title: Penanganan kesalahan canonical: https://developer.unico.io/id/dual-api/developers/sdks-and-tools/android/error-handling locale: id generated_by: markdown-export --- Semua penanganan kesalahan untuk Android SDK dipusatkan di bagian ini. Callback `onErrorAcessoBio` menerima objek `ErrorBio` dengan `code` (Int) dan `description` (String). ## Menangani callback ### Kotlin ```kotlin override fun onErrorAcessoBio(error: ErrorBio) { when (error.code) { 73002 -> { /* camera permission denied — redirect to app settings */ } 73006 -> { /* running on emulator — physical device required */ } 73100 -> { /* no internet connection */ } else -> { /* generic error handling */ } } } ``` ### Java ```java @Override public void onErrorAcessoBio(ErrorBio error) { switch (error.getCode()) { case 73002: /* camera permission denied — redirect to app settings */ break; case 73006: /* running on emulator — physical device required */ break; case 73100: /* no internet connection */ 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. ## Kode kesalahan Semua kode kesalahan berasal dari enum `UnicoException` dan disampaikan melalui `ErrorBio(code, message)`. Kolom `message` berisi string SDK yang tepat — jangan dimodifikasi atau diterjemahkan. | Kode | Pesan | Deskripsi | |---|---|---| | `73001` | `Context invalid` | Konteks Android yang tidak valid diteruskan ke SDK | | `73002` | `Did not grant permission to open camera` | Izin kamera ditolak oleh pengguna | | `73003` | `The lest API is 21(LOLLIPOP` | Level API perangkat di bawah minimum yang diperlukan (API 21) | | `73004` | `Could not find implementation interface callback iAcessoBioSelfie` | Antarmuka `iAcessoBioSelfie` belum diimplementasikan | | `73005` | `Could not find implementation interface callback iAcessoBioDocument` | Antarmuka `iAcessoBioDocument` belum diimplementasikan | | `73006` | `Unable to open camera on emulators` | SDK tidak berjalan di emulator — gunakan perangkat fisik | | `73007` | `Unknown and unexpected error in WebApp…` | Kesalahan umum WebApp (kamera, penyimpanan, keamanan, jaringan) | | `73100` | `Unable to connect to internet.` | Tidak ada koneksi internet yang tersedia | | `73200` | `Please inform the config object or json file name` | Objek konfigurasi atau file JSON tidak disediakan | | `73202` | `Unable to parse json file` | File konfigurasi JSON rusak | | `73204` | `Unable to initialize the SDK, please configure the environment on setEnviroment method of build` | `setEnvironment()` tidak dipanggil sebelum inisialisasi | | `73300` | `Unable to get unico authentication object` | Gagal mengambil objek autentikasi | | `73301` | `Unable to parse object` | Gagal mem-parse respons autentikasi | | `73302` | `Could not find the unico token` | Token autentikasi Unico tidak ditemukan | | `73303` | `Current host is not registered` | Pengenal bundle tidak terdaftar di SDK Key | | `73400` | `Could not initialize camera` | Inisialisasi kamera gagal | | `73701` | `Could not find active liveness import` | Modul deteksi kehidupan aktif tidak ditemukan | | `73703` | `Unable to get active liveness session` | Gagal mendapatkan sesi deteksi kehidupan | | `73718` | `The Session was cancelled because of an unknown and unexpected error…` | Kesalahan internal sesi yang tidak diketahui | | `73721` | `The Session can't be performed: attempts limit exceeded.` | Sesi dibatalkan — batas percobaan pengambilan gambar terlampaui | | `73722` | `The Session can't be performed: face alignment timeout.` | Sesi dibatalkan — timeout penyelarasan wajah | | `73726` | `An error happened during video recording` | Kesalahan perekaman video selama deteksi kehidupan | | `73727` | `No actions found in a video` | Tidak ada aksi deteksi kehidupan terdeteksi dalam video | | `73740` | `The user pressed the do not consent button and did not complete the Session.` | Pengguna menolak persetujuan | | `73800` | `Could not build encrypted key.` | Gagal membangun JWT terenkripsi | | `73801` | `The Session of SDK was cancelled because of an unknown and unexpected error.` | Kesalahan internal sesi SDK yang tidak diketahui | | `73802` | `The Session was cancelled because of an unknown and unexpected error…` | Sesi dibatalkan — field JWT yang diperlukan tidak ada | | `73900` | `Erro ao analisar imagem` | Kesalahan saat menganalisis gambar yang diambil | | `73901` | `É necessário implementar a interface AcessoBioListener` | Antarmuka `AcessoBioListener` belum diimplementasikan | | `73902` | `É necessário insirir um valor maior que 40 segundos no método: setTimeoutSession.` | Nilai `setTimeoutSession` harus lebih besar dari 40 detik | | `73903` | `Arquivo de configuração corrompido. Verifique o arquivo json e tente novamente.` | File konfigurasi rusak — verifikasi dan coba lagi | | `73904` | `Erro ao finalizar processo` | Kesalahan saat menyelesaikan proses pengambilan gambar | | `73905` | `Unable to open document camera` | Kamera dokumen tidak dapat dibuka | | `73906` | `Document type uninformed` | Jenis dokumen tidak ditentukan | | `74001` | `onSuccess: not implemented when using open:webAppToken:` | Callback `onSuccess` tidak diimplementasikan untuk User Journey | | `74100` | `Could not prepare SDK-S` | Gagal menyiapkan komponen SDK | | `74101` | `No URL token was provided.` | Tidak ada token URL yang disediakan untuk journey | | `74102` | `Environment type was not specified.` | Environment (`PROD`/`UAT`) tidak dikonfigurasi | | `737120` | `Unable to initialize liveness` | Aktivitas deteksi kehidupan tidak dapat diinisialisasi | | `737220` | `Capture could not start` | Proses pengambilan gambar gagal dimulai | | `737320` | `Transaction could not start` | Transaksi tidak dapat dimulai | | `737321` | `The Session was cancelled because of an unknown and unexpected error. This return value is a catch-all for errors experienced during normal usage of these APIs. Try again.` | Kesalahan umum penyedia sesi — coba lagi | :::secondary[Kode kesalahan REST API] Kode-kode di atas adalah kesalahan callback SDK. Kode kesalahan REST API (kelompok status HTTP) didokumentasikan secara terpisah di [Referensi API > Kode kesalahan](/dual-api/developers/api-reference/error-codes). :::