Penanganan error

Semua penanganan error untuk Flutter SDK dipusatkan di bagian ini. Callback onErrorUnico, onErrorSelfie, dan onErrorDocument menerima objek UnicoError yang mengekspos getCode() dan getDescription().

Error codes

Kode	Deskripsi
`73001`	Konteks tidak valid
`73002`	Tidak memberikan izin untuk membuka kamera
`73003`	API minimum adalah 21 (LOLLIPOP)
`73004`	Tidak dapat menemukan implementasi antarmuka callback `iAcessoBioSelfie`
`73005`	Tidak dapat menemukan implementasi antarmuka callback `iAcessoBioDocument`
`73006`	Tidak dapat membuka kamera pada emulator
`73100`	Tidak dapat terhubung ke internet
`73200`	Harap berikan nama file JSON
`73202`	Tidak dapat mengurai file JSON
`73300`	Tidak dapat mendapatkan objek autentikasi unico
`73301`	Tidak dapat mengurai objek
`73302`	Tidak dapat menemukan token unico
`73303`	Host saat ini tidak terdaftar
`73400`	Tidak dapat menginisialisasi kamera
`73500`	Tidak dapat mendapatkan token sesi — error respons layanan
`73501`	Tidak dapat mengurai objek
`73502`	Tidak dapat mendapatkan token sesi
`73701`	Tidak dapat menemukan impor active liveness
`73702`	Tidak dapat menginisialisasi active liveness dalam mode produksi
`73703`	Tidak dapat mendapatkan sesi active liveness
`73704`	Pengguna menekan tombol batal dan tidak menyelesaikan sesi
`73705`	Sesi tidak berhasil diselesaikan dan FaceScan tidak dihasilkan
`73706`	Akses kamera ditolak — pengguna secara eksplisit menolak izin atau kebijakan perangkat membloknya
`73707`	Sesi dibatalkan karena aplikasi dihentikan, tidur, notifikasi OS, atau berjalan di latar belakang
`73708`	Sesi dibatalkan karena perangkat dalam mode lanskap
`73709`	Sesi dibatalkan karena perangkat dalam mode potret terbalik
`73710`	Sesi dibatalkan karena pengguna tidak dapat menyelesaikannya dalam batas waktu yang ditentukan
`73712`	Sesi dibatalkan karena tekanan memori / aplikasi tidak dalam produksi memerlukan jaringan
`73713`	Sesi dibatalkan karena kunci Anda perlu divalidasi ulang
`73714`	Sesi dibatalkan karena kunci enkripsi yang dikonfigurasi pengembang tidak valid
`73715`	Sesi dibatalkan karena tidak semua gambar panduan dikonfigurasi
`73716`	Sesi dibatalkan karena SDK tidak dapat memulai kamera di perangkat ini
`73717`	Sesi dibatalkan karena pengguna dalam kondisi terkunci
`73718`	Error tidak dikenal dan tidak terduga selama penggunaan normal API native
`73719`	Sesi dibatalkan karena pengguna menekan pesan subteks layar Bersiaplah
`73800`	Tidak dapat membuat kunci terenkripsi

Katalog error resmi

Kode-kode di atas mencerminkan katalog Flutter SDK. Katalog kode error lintas platform resmi tersedia di API Reference > Error codes.

Handling the callback

@override
void onErrorUnico(UnicoError error) {
  final code = error.getCode();
  final description = error.getDescription();
  // handle error
}

Lifecycle callbacks

Selain onErrorUnico, SDK juga memicu:

onUserClosedCameraManually() — pengguna menutup kamera secara manual.
onSystemClosedCameraTimeoutSession() — sesi berakhir karena timeout (default 40 d, minimum 40 d).
onSystemChangedTypeCameraTimeoutFaceInference() — deteksi wajah melebihi ambang batas 13 d; pengambilan beralih ke mode manual.