---
title: Penanganan kesalahan
canonical: https://developer.unico.io/id/dual-api/developers/sdks-and-tools/ios/error-handling
locale: id
generated_by: markdown-export
---

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 |

:::secondary[Katalog kesalahan resmi]
Kode di atas mencerminkan katalog iOS SDK. Katalog kode kesalahan lintas platform resmi tersedia di [Referensi API > Kode kesalahan](/dual-api/developers/api-reference/error-codes).
:::

## 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.

:::info[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()`
:::