Penanganan error

Markdown

Semua penanganan error untuk Flutter SDK dipusatkan di bagian ini. Callback onErrorUnico, onErrorSelfie, dan onErrorDocument menerima objek UnicoError dengan field code (int), description (String) dan info (String?). info membawa tahap alur yang gagal di iOS dan selalu null di Android.

Error codes

Kode	Deskripsi
`73001`	Konteks tidak valid
`73002`	Tidak memberikan izin untuk membuka kamera
`73003`	Level 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
`74001`	Callback `onSuccess` tidak diimplementasikan saat membuka kamera dengan `webAppToken`

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.code;
  final description = error.description;
  // handle error
}

Lifecycle callbacks

Selain onErrorUnico, SDK juga memicu:

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