Pengumpulan Data Pemantauan

Implementasi opsional

Pengumpulan Data Pemantauan bersifat opsional. Jika Anda menggunakannya, hanya panggilan prepareCamera yang terpengaruh — setiap langkah lain dalam alur pengambilan gambar (inisialisasi, listener, penanganan hasil) tetap tidak berubah.

Lampirkan metadata pengguna dan alur ke sesi pengambilan gambar agar dapat dikorelasikan dalam alat pemantauan dan observabilitas di sisi Unico. Ketika disediakan, data diteruskan bersama pengambilan gambar — tidak mengubah perilaku pengambilan SDK atau respons API.

Atribut PrepareInfo

Atribut	Tipe	Wajib	Deskripsi
externalUserId	String	✅	Pengenal pengguna dalam sistem Anda. Secara otomatis di-hash dengan SHA-256 sebelum transmisi — tidak pernah dikirim dalam teks biasa.
useCase	String	—	Pengenal untuk alur atau konteks yang sedang berjalan (mis., "account_opening", "password_recovery"). Dikirim sebagai teks biasa.

Implementasi

Buat objek PrepareInfo dan teruskan sebagai argumen ketiga ke prepareCamera. Semua hal lain dalam alur pengambilan gambar tetap sama.

Kotlin

val extraData = PrepareInfo(
    externalUserId = "external_user_id",
    useCase = "use_case"
)

unicoCheckCamera.prepareCamera(unicoConfig, object : CameraListener {
    override fun onCameraReady(cameraOpener: UnicoCheckCameraOpener.Camera?) {
        cameraOpener?.open(cameraListener)
    }

    override fun onCameraFailed(message: String?) {
        Log.e(TAG, message)
    }
}, extraData)

Java

PrepareInfo extraData = new PrepareInfo("external_user_id", "flow_id");

unicoCheckCamera.prepareCamera(unicoConfig, new CameraListener() {
    @Override
    public void onCameraReady(UnicoCheckCameraOpener.Camera cameraOpener) {
        cameraOpener.open(cameraListener);
    }

    @Override
    public void onCameraFailed(String message) {
        Log.e(TAG, message);
    }
}, extraData);