الانتقال إلى المحتوى الرئيسي

رحلات المستخدم

Markdown

رحلات المستخدم هي جلسات التقاط متعددة الخطوات يُنسّقها SDK بالتزامن مع التدفق المُهيَّأ. على سبيل المثال، يُنفّذ التدفق الذي يتضمن لايفنس + درجة المخاطر + التقاط الوثائق + التوقيع الإلكتروني كلًّا من التقاط الصورة الشخصية والمستند والتوقيع في جلسة واحدة.

المنتجات

تعتمد الرحلات المتاحة على التدفق المُهيَّأ لتكاملك. راجع المنتجات للاطلاع على الخريطة الكاملة: المنتج ← التدفق ← القدرة.

آلية العمل

يقوم SDK بما يلي:

  1. قراءة تهيئة التدفق المُقدَّمة أثناء التهيئة.
  2. تنسيق تسلسل عمليات الالتقاط المطلوبة للتدفق (الصورة الشخصية، المستند، التوقيع).
  3. يُرجع processId عبر onSuccess عند اكتمال الرحلة.

يتولى SDK التنسيق بالكامل — فلا حاجة إلى تطبيق تسلسل الخطوات في تطبيقك.

بدء رحلة المستخدم
الخطوة 1 — تنفيذ AcessoBioListener

يتعامل AcessoBioListener مع استدعاءات دورة حياة SDK. قم بتنفيذ الطرق الأربع الإلزامية:

الطريقةوقت استدعائها
onErrorAcessoBio(errorBio)حدث خطأ أثناء تشغيل SDK
onUserClosedCameraManually()أغلق المستخدم الكاميرا يدوياً
onSystemClosedCameraTimeoutSession()تم بلوغ حد مهلة الجلسة — انظر حدود الجلسة
onSystemChangedTypeCameraTimeoutFaceInference()تم بلوغ حد مهلة استنتاج الوجه — ينتقل إلى الالتقاط اليدوي — انظر حدود الجلسة
val callback = object : AcessoBioListener {
override fun onErrorAcessoBio(errorBio: ErrorBio?) { }
override fun onUserClosedCameraManually() { }
override fun onSystemClosedCameraTimeoutSession() { }
override fun onSystemChangedTypeCameraTimeoutFaceInference() { }
}
الخطوة 2 — تطبيق iAcessoBioSelfie

يتعامل iAcessoBioSelfie مع ردود نداء نتيجة الالتقاط في الرحلة:

الدالةالوصف
onSuccessSelfie(result)مطلوب بموجب واجهة المستمع؛ لا يُستخدم في تكامل Unico API
onSuccess(result)اكتملت الرحلة بنجاح — يُرجع SuccessResult يحتوي على processId يُستخدم للاستعلام عن نتائج التحقق
onErrorSelfie(errorBio)فشل الالتقاط — يُرجع ErrorBio يحتوي على تفاصيل الخطأ
val cameraListener: iAcessoBioSelfie = object : iAcessoBioSelfie {
override fun onSuccessSelfie(result: ResultCamera?) { }
override fun onSuccess(result: SuccessResult) { }
override fun onErrorSelfie(errorBio: ErrorBio?) { }
}
الخطوة 3 — استدعاء prepareCamera

بعد تهيئة unicoCheckCamera وتطبيق كلا المستمعَين، استدعِ prepareCamera مع تمرير تهيئة SDK وCameraListener وwebAppToken الخاص بك:

webAppToken

الـ webAppToken هو الحقل process.webAppToken الذي يُرجعه POST /client/v1/process عند إنشاء العملية في الخادم الخلفي. راجع إنشاء عملية.

  • onCameraReady — الكاميرا جاهزة؛ استدعِ open مع تمرير cameraListener وwebAppToken الخاص بك.
  • onCameraFailed — فشل تحضير الكاميرا؛ تعامل مع رسالة الخطأ.
unicoCheckCamera.prepareCamera(unicoConfig, object : CameraListener {
override fun onCameraReady(cameraOpener: UnicoCheckCameraOpener.Camera?) {
cameraOpener?.open(cameraListener, "your_web_app_token")
}

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

للاطلاع على المعالجة الكاملة للنتائج، راجع استلام النتيجة.