Penanganan kesalahan

Semua penanganan kesalahan untuk iOS SDK terpusat di bagian ini. Callback onErrorAcessoBioManager menerima objek ErrorBio yang mengekspos getCode() dan getDescription().

Kode kesalahan

Kode	Deskripsi
`73000`	Sesi dibatalkan karena kesalahan yang tidak diketahui dan tidak terduga. Unico Check SDK memanfaatkan berbagai iOS API termasuk kamera, penyimpanan, keamanan, jaringan, dan lainnya — ini adalah catch-all.
`73001`	Konteks tidak valid
`73003`	Versi API harus 13 atau lebih baru
`73006`	Tidak dapat membuka kamera pada emulator
`73100`	Tidak dapat terhubung ke internet
`73200`	Tidak dapat menemukan file JSON unico_sdk
`73202`	Tidak dapat memuat file JSON unico_sdk
`73203`	Tidak dapat memuat `AcessoBioConfigDataSource`
`73204`	Tidak dapat menginisialisasi SDK — konfigurasikan lingkungan melalui `setEnvironment` saat build
`73300`	Tidak dapat mendapatkan objek autentikasi unico
`73301`	Tidak dapat mengurai objek autentikasi unico
`73302`	Tidak dapat menemukan token unico
`73701`	Tidak dapat menemukan impor liveness aktif
`73702`	Tidak dapat menginisialisasi liveness aktif dalam mode produksi
`73703`	Tidak dapat mendapatkan sesi liveness aktif
`73704`	Pengguna menekan tombol batal dan tidak menyelesaikan sesi
`73705`	Sesi tidak berhasil dilakukan dan FaceScan tidak dihasilkan
`73706`	Akses kamera ditolak — pengguna secara eksplisit menolak izin atau kebijakan perangkat memblokir
`73707`	Sesi dibatalkan karena aplikasi dihentikan, tertidur, notifikasi OS, atau berjalan di latar belakang
`73708`	Sesi dibatalkan karena perangkat dalam mode landscape
`73709`	Sesi dibatalkan karena perangkat dalam mode portrait terbalik
`73710`	Sesi dibatalkan karena pengguna tidak dapat menyelesaikannya dalam batas waktu yang ditentukan
`73711`	Sesi dibatalkan karena tekanan memori
`73712`	Sesi dibatalkan karena aplikasi Anda tidak dalam produksi dan memerlukan koneksi jaringan
`73713`	Sesi dibatalkan karena kunci Anda perlu divalidasi ulang
`73714`	Sesi dibatalkan karena kunci enkripsi yang dikonfigurasi developer tidak valid
`73715`	Sesi dibatalkan karena tidak semua gambar panduan dikonfigurasi
`73716`	Sesi dibatalkan karena SDK tidak dapat memulai kamera pada perangkat ini
`73717`	Sesi dibatalkan karena pengguna berada dalam status terkunci
`73718`	Kesalahan yang tidak diketahui dan tidak terduga selama penggunaan normal iOS API
`73719`	Sesi dibatalkan karena pengguna menekan pesan subteks layar Get Ready
`73720`	Sesi tidak diproses
`73721`	Sesi tidak dapat dilakukan: batas percobaan terlampaui
`73722`	Sesi tidak dapat dilakukan: batas waktu penyelarasan wajah
`73730`	Tidak dapat menginisialisasi sesi liveness aktif — kesalahan lisensi yang tidak diketahui
`73731`	Tidak dapat menginisialisasi sesi liveness aktif — lisensi kedaluwarsa
`73800`	Tidak dapat membuat kunci terenkripsi

Katalog kesalahan resmi

Kode di atas mencerminkan katalog iOS SDK. Katalog kode kesalahan lintas platform resmi tersedia di Referensi API > Kode kesalahan.

Callback siklus hidup

Selain onErrorAcessoBioManager, SDK juga memicu:

onUserClosedCameraManually() — pengguna menutup kamera secara manual.
onSystemClosedCameraTimeoutSession() — sesi kedaluwarsa karena timeout (default 40 dtk, minimum 40 dtk).
onSystemChangedTypeCameraTimeoutFaceInference() — deteksi wajah melampaui ambang 13 dtk; pengambilan gambar beralih ke mode manual.

Perutean callback untuk pembatalan dan timeout

Kesalahan 73704 (pengguna membatalkan) dan 73710 (timeout sesi) tidak dikirimkan melalui onErrorAcessoBioManager. Mereka memicu callback siklus hidup yang sesuai secara langsung:

73704 → onUserClosedCameraManually()
73710 → onSystemClosedCameraTimeoutSession()