Lewati ke konten utama

Perjalanan Pengguna

Markdown

User Journeys adalah sesi pengambilan gambar multi-langkah yang diorkestrasikan oleh SDK bersama dengan alur yang dikonfigurasi. Misalnya, alur dengan Deteksi Kehidupan + Skor Risiko + Pengambilan Dokumen + Tanda Tangan Elektronik menjalankan selfie, pengambilan dokumen, dan tanda tangan dalam satu sesi.

Produk

Journey yang tersedia bergantung pada alur yang dikonfigurasi untuk integrasi Anda. Lihat Produk untuk pemetaan lengkap produk → alur → kemampuan.

Cara kerjanya

SDK:

  1. Membaca konfigurasi alur yang diberikan selama inisialisasi.
  2. Mengorkestrasikan urutan pengambilan gambar yang diperlukan untuk alur (selfie, dokumen, tanda tangan).
  3. Mengembalikan processId melalui onSuccess ketika journey selesai.

Orkestrasi sepenuhnya ditangani oleh SDK — Anda tidak perlu mengimplementasikan urutan langkah di aplikasi Anda.

Memulai User Journey
Langkah 1 — Implementasikan AcessoBioManagerDelegate

AcessoBioManagerDelegate menangani callback siklus hidup SDK. Implementasikan empat metode wajib berikut:

MetodeKapan dipanggil
onErrorAcessoBioManager(error)Terjadi kesalahan selama operasi SDK
onUserClosedCameraManually()Pengguna menutup kamera secara manual
onSystemClosedCameraTimeoutSession()Batas sesi 40 detik telah tercapai
onSystemChangedTypeCameraTimeoutFaceInference()Tidak ada wajah terdeteksi selama 13 detik — beralih ke pengambilan gambar manual
class ViewController: UIViewController, AcessoBioManagerDelegate {
var unicoCheck: AcessoBioManager!

override func viewDidLoad() {
super.viewDidLoad()
unicoCheck = AcessoBioManager(viewController: self)
}

func onErrorAcessoBioManager(_ error: ErrorBio!) { }
func onUserClosedCameraManually() { }
func onSystemClosedCameraTimeoutSession() { }
func onSystemChangedTypeCameraTimeoutFaceInference() { }
}
Metode delegate wajib

Keempat metode delegate di atas harus dibuat dalam proyek Anda (meskipun tanpa logika apa pun). Jika tidak, proyek tidak akan berhasil dikompilasi.

Langkah 2 — Implementasikan AcessoBioSelfieDelegate

Override metode-metode untuk menangani callback hasil pengambilan gambar pada journey:

MetodeDeskripsi
onSuccessSelfie(result)Diperlukan oleh antarmuka delegate; tidak digunakan dalam integrasi Unico API
onSuccess(result)Diperlukan dalam integrasi Unico API. Journey berhasil diselesaikan — mengembalikan processId yang digunakan untuk mengkueri hasil validasi
onErrorSelfie(errorBio)Pengambilan gambar gagal — mengembalikan ErrorBio dengan detail kesalahan
class ViewController: UIViewController, AcessoBioManagerDelegate,
SelfieCameraDelegate, AcessoBioSelfieDelegate {

func onSuccessSelfie(_ result: SelfieResult!) { }
func onSuccess(_ result: SuccessResult!) { }
func onErrorSelfie(_ errorBio: ErrorBio!) { }
}
onSuccess wajib diimplementasikan

Kamera terbuka dengan webAppToken, sehingga SDK memerlukan onSuccess: tanpa itu, SDK gagal dengan kesalahan 74001. AcessoBioSelfieDelegate mendeklarasikan onSuccess sebagai opsional, sehingga compiler tidak memeriksanya, dan signature yang tidak cocok dengan contoh di atas akan berhasil dikompilasi tetapi gagal dengan cara yang sama. Salin signature persis seperti yang ditunjukkan.

Langkah 3 — Panggil prepareSelfieCamera dan open

Panggil prepareSelfieCamera dengan memasukkan konfigurasi SDK. Saat kamera siap, event onCameraReady dipicu — buka kamera melalui metode open(), dengan meneruskan webAppToken:

webAppToken

webAppToken adalah field process.webAppToken yang dikembalikan oleh POST /client/v1/process saat membuat proses di backend Anda. Lihat Buat Proses.

  • onCameraReady(cameraOpener) — kamera siap; panggil open(self, webAppToken:).
  • onCameraFailed(message) — persiapan kamera gagal (ErrorPrepare adalah ekstensi dari ErrorBio).
@IBAction func openCamera(_ sender: Any) {
unicoCheck.build().prepareSelfieCamera(self, config: YourUnicoConfigClass())
}

func onCameraReady(_ cameraOpener: AcessoBioCameraOpenerDelegate!) {
cameraOpener.open(self, webAppToken: "your_web_app_token")
}

func onCameraFailed(_ message: ErrorPrepare!) { }

Untuk penanganan hasil secara lengkap, lihat Menerima hasil.