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

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

رموز الأخطاء

الرمز	الرسالة الافتراضية	متى يحدث	المعالجة الموصى بها
AUTH_FAILED	فشل مصادقة SDK	مفتاح SDK غير صالح أو منتهي الصلاحية	تحقق من بيانات الاعتماد مع فريق الإعداد
CAMERA_PERMISSION_DENIED	رُفض إذن الكاميرا	رفض المستخدم إذن الكاميرا	وجّه المستخدم إلى إعدادات التطبيق
LIVENESS_FAILED	فشل فحص Liveness	لم تجتز الصورة التحقق من الحيوية	اطلب التقاطًا جديدًا
NETWORK_ERROR	خطأ في الشبكة أثناء الالتقاط	اتصال غير كافٍ	اطلب إعادة الاتصال
SDK_NOT_INITIALIZED	SDK غير مهيّأ	استدعاء الالتقاط قبل التهيئة	تأكد من استدعاء التهيئة في Application/onCreate

رموز أخطاء SDK

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

معالجة رد النداء

Kotlin

override fun onErrorAcessoBio(error: ErrorBio) {
  when (error.code) {
    "AUTH_FAILED" -> { /* handle authentication failure */ }
    "CAMERA_PERMISSION_DENIED" -> { /* redirect to app settings */ }
    "LIVENESS_FAILED" -> { /* prompt the user to try again */ }
    else -> { /* generic error handling */ }
  }
}

Java

@Override
public void onErrorAcessoBio(ErrorBio error) {
  switch (error.getCode()) {
    case "AUTH_FAILED": /* handle authentication failure */ break;
    case "CAMERA_PERMISSION_DENIED": /* redirect to app settings */ break;
    case "LIVENESS_FAILED": /* prompt the user to try again */ break;
    default: /* generic error handling */
  }
}

ردود نداء دورة الحياة

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

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