جمع بيانات المراقبة

تنفيذ اختياري

جمع بيانات المراقبة اختياري. إذا اعتمدته، فإن استدعاء prepareCamera فقط هو المتأثر — تبقى جميع الخطوات الأخرى في تدفق الالتقاط (التهيئة، والمستمعون، ومعالجة النتائج) دون تغيير.

أرفق بيانات المستخدم والتدفق الوصفية بجلسة الالتقاط حتى يمكن ربطها في أدوات المراقبة والرصد على جانب Unico. عند توفيرها، تُرسَل البيانات مع الالتقاط — ولا تغيّر سلوك الالتقاط في SDK أو استجابة API.

PrepareInfo attributes

السمة	النوع	مطلوب	الوصف
externalUserId	String	✅	معرّف المستخدم في نظامك. يُجزَّأ تلقائيًا باستخدام SHA-256 قبل الإرسال — لا يُرسَل أبدًا كنص عادي.
useCase	String	—	معرّف التدفق أو السياق الجاري تشغيله (مثل: "account_opening", "password_recovery"). يُرسَل كنص عادي.

Implementation

أنشئ كائن PrepareInfo ومرّره كوسيطة ثالثة إلى prepareCamera. يبقى كل شيء آخر في تدفق الالتقاط كما هو.

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);