معالجة الأخطاء

تتمركز جميع عمليات معالجة أخطاء Android SDK في هذا القسم. يستقبل رد الاتصال onErrorAcessoBio كائنًا من نوع ErrorBio يحتوي على code (Int) وdescription (String).

معالجة رد الاتصال

Kotlin
Java

override fun onErrorAcessoBio(error: ErrorBio) {
  when (error.code) {
    73002 -> { /* camera permission denied — redirect to app settings */ }
    73006 -> { /* running on emulator — physical device required */ }
    73100 -> { /* no internet connection */ }
    else -> { /* generic error handling */ }
  }
}

@Override
public void onErrorAcessoBio(ErrorBio error) {
  switch (error.getCode()) {
    case 73002: /* camera permission denied — redirect to app settings */ break;
    case 73006: /* running on emulator — physical device required */ break;
    case 73100: /* no internet connection */ break;
    default: /* generic error handling */
  }
}

ردود اتصال دورة الحياة

بالإضافة إلى onErrorAcessoBio، يُطلق SDK أيضًا:

onUserClosedCameraManually() — أغلق المستخدم الكاميرا يدويًا.
onSystemClosedCameraTimeoutSession() — انتهت صلاحية الجلسة بسبب انتهاء المهلة.
onSystemChangedTypeCameraTimeoutFaceInference() — لم يتم اكتشاف وجه لمدة 13 ثانية؛ يتحول SDK إلى الالتقاط اليدوي.

رموز الأخطاء

تنشأ جميع رموز الأخطاء من تعداد UnicoException وتُسلَّم عبر ErrorBio(code, message). يحتوي حقل message على السلسلة النصية الدقيقة للـ SDK — لا تعدّلها أو تترجمها.

الرمز	الرسالة	الوصف
`73001`	`Context invalid`	سياق Android غير صالح تم تمريره إلى SDK
`73002`	`Did not grant permission to open camera`	رفض المستخدم إذن الكاميرا
`73003`	`The lest API is 21(LOLLIPOP`	مستوى API للجهاز أقل من الحد الأدنى المطلوب (API 21)
`73004`	`Could not find implementation interface callback iAcessoBioSelfie`	واجهة `iAcessoBioSelfie` غير مُنفَّذة
`73005`	`Could not find implementation interface callback iAcessoBioDocument`	واجهة `iAcessoBioDocument` غير مُنفَّذة
`73006`	`Unable to open camera on emulators`	لا يعمل SDK على المحاكيات — استخدم جهازًا فعليًا
`73007`	`Unknown and unexpected error in WebApp…`	خطأ عام في WebApp (الكاميرا، التخزين، الأمان، الشبكة)
`73100`	`Unable to connect to internet.`	لا يتوفر اتصال بالإنترنت
`73200`	`Please inform the config object or json file name`	لم يتم توفير كائن الإعداد أو ملف JSON
`73202`	`Unable to parse json file`	ملف إعداد JSON تالف
`73204`	`Unable to initialize the SDK, please configure the environment on setEnviroment method of build`	لم يتم استدعاء `setEnvironment()` قبل التهيئة
`73300`	`Unable to get unico authentication object`	فشل في استرداد كائن المصادقة
`73301`	`Unable to parse object`	فشل في تحليل استجابة المصادقة
`73302`	`Could not find the unico token`	لم يتم العثور على رمز مصادقة Unico
`73303`	`Current host is not registered`	معرف الحزمة غير مسجل في مفتاح SDK
`73400`	`Could not initialize camera`	فشل تهيئة الكاميرا
`73701`	`Could not find active liveness import`	وحدة اكتشاف الحيوية النشطة غير موجودة
`73703`	`Unable to get active liveness session`	فشل في الحصول على جلسة اكتشاف الحيوية
`73718`	`The Session was cancelled because of an unknown and unexpected error…`	خطأ داخلي غير معروف في الجلسة
`73721`	`The Session can't be performed: attempts limit exceeded.`	تم إلغاء الجلسة — تجاوز حد محاولات الالتقاط
`73722`	`The Session can't be performed: face alignment timeout.`	تم إلغاء الجلسة — انتهت مهلة محاذاة الوجه
`73726`	`An error happened during video recording`	خطأ في تسجيل الفيديو أثناء اكتشاف الحيوية
`73727`	`No actions found in a video`	لم يتم اكتشاف إجراءات حيوية في الفيديو
`73740`	`The user pressed the do not consent button and did not complete the Session.`	رفض المستخدم الموافقة
`73800`	`Could not build encrypted key.`	فشل في بناء JWT المشفر
`73801`	`The Session of SDK was cancelled because of an unknown and unexpected error.`	خطأ داخلي غير معروف في جلسة SDK
`73802`	`The Session was cancelled because of an unknown and unexpected error…`	تم إلغاء الجلسة — حقول JWT المطلوبة مفقودة
`73900`	`Erro ao analisar imagem`	خطأ في تحليل الصورة الملتقطة
`73901`	`É necessário implementar a interface AcessoBioListener`	واجهة `AcessoBioListener` غير مُنفَّذة
`73902`	`É necessário insirir um valor maior que 40 segundos no método: setTimeoutSession.`	يجب أن تكون قيمة `setTimeoutSession` أكبر من 40 ثانية
`73903`	`Arquivo de configuração corrompido. Verifique o arquivo json e tente novamente.`	ملف الإعداد تالف — تحقق منه وأعد المحاولة
`73904`	`Erro ao finalizar processo`	خطأ في إنهاء عملية الالتقاط
`73905`	`Unable to open document camera`	تعذر فتح كاميرا المستند
`73906`	`Document type uninformed`	لم يتم تحديد نوع المستند
`74001`	`onSuccess: not implemented when using open:webAppToken:`	رد الاتصال `onSuccess` غير مُنفَّذ لرحلة المستخدم
`74100`	`Could not prepare SDK-S`	فشل في إعداد مكونات SDK
`74101`	`No URL token was provided.`	لم يتم توفير رمز URL للرحلة
`74102`	`Environment type was not specified.`	لم يتم تكوين البيئة (`PROD`/`UAT`)
`737120`	`Unable to initialize liveness`	تعذر تهيئة نشاط اكتشاف الحيوية
`737220`	`Capture could not start`	فشل بدء عملية الالتقاط
`737320`	`Transaction could not start`	تعذر بدء المعاملة
`737321`	`The Session was cancelled because of an unknown and unexpected error. This return value is a catch-all for errors experienced during normal usage of these APIs. Try again.`	خطأ عام في مزود الجلسة — أعد المحاولة

رموز خطأ REST API

الرموز أعلاه هي أخطاء رد اتصال SDK. يتم توثيق رموز خطأ REST API (عائلات حالة HTTP) بشكل منفصل في مرجع API > رموز الأخطاء.