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

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

تتمركز جميع عمليات معالجة الأخطاء في Flutter SDK في هذا القسم. تستقبل ردود الاتصال onErrorUnico وonErrorSelfie وonErrorDocument كائن UnicoError الذي يعرض getCode() وgetDescription().

Error codes
الرمزالوصف
73001السياق غير صالح
73002لم يتم منح إذن فتح الكاميرا
73003الحد الأدنى للـ API هو 21 (LOLLIPOP)
73004تعذّر العثور على واجهة تنفيذ رد الاتصال iAcessoBioSelfie
73005تعذّر العثور على واجهة تنفيذ رد الاتصال iAcessoBioDocument
73006تعذّر فتح الكاميرا على المحاكيات
73100تعذّر الاتصال بالإنترنت
73200يرجى تحديد اسم ملف JSON
73202تعذّر تحليل ملف JSON
73300تعذّر الحصول على كائن مصادقة unico
73301تعذّر تحليل الكائن
73302تعذّر العثور على رمز unico المميز
73303المضيف الحالي غير مسجّل
73400تعذّر تهيئة الكاميرا
73500تعذّر الحصول على رمز الجلسة — خطأ في استجابة الخدمة
73501تعذّر تحليل الكائن
73502تعذّر الحصول على رمز الجلسة
73701تعذّر العثور على استيراد التحقق من الحيوية النشطة
73702تعذّر تهيئة التحقق من الحيوية النشطة في وضع الإنتاج
73703تعذّر الحصول على جلسة التحقق من الحيوية النشطة
73704ضغط المستخدم على زر الإلغاء ولم يُكمل الجلسة
73705لم تُنجَز الجلسة بنجاح ولم يتم إنشاء FaceScan
73706تم رفض الوصول إلى الكاميرا — رفض المستخدم الإذن صراحةً أو تحول سياسة الجهاز دون ذلك
73707تم إلغاء الجلسة بسبب إنهاء التطبيق، أو دخوله في وضع السكون، أو ظهور إشعار من نظام التشغيل، أو الانتقال إلى الخلفية
73708تم إلغاء الجلسة لأن الجهاز في الوضع الأفقي
73709تم إلغاء الجلسة لأن الجهاز في الوضع العمودي المعكوس
73710تم إلغاء الجلسة لأن المستخدم لم يتمكن من إتمامها خلال مهلة الوقت المحددة
73712تم إلغاء الجلسة بسبب ضغط الذاكرة / التطبيق غير الإنتاجي يتطلب اتصالًا بالشبكة
73713تم إلغاء الجلسة لأن مفتاحك يحتاج إلى التحقق من صحته مجددًا
73714تم إلغاء الجلسة لأن مفتاح التشفير الذي هيّأه المطوّر لم يكن صالحًا
73715تم إلغاء الجلسة لأنه لم يتم تهيئة جميع صور الإرشاد
73716تم إلغاء الجلسة لأن حزمة SDK لم تتمكن من تشغيل الكاميرا على هذا الجهاز
73717تم إلغاء الجلسة لأن المستخدم كان في حالة مقفولة
73718خطأ مجهول وغير متوقع أثناء الاستخدام الاعتيادي لواجهات API الأصلية
73719تم إلغاء الجلسة لأن المستخدم ضغط على نص الرسالة الفرعية في شاشة "الاستعداد"
73800تعذّر بناء المفتاح المشفّر
فهرس الأخطاء الرسمي

تعكس الرموز أعلاه فهرس Flutter SDK. يتوفر فهرس رموز الأخطاء الرسمي عبر المنصات على مرجع API > رموز الأخطاء.

Handling the callback
@override
void onErrorUnico(UnicoError error) {
  final code = error.getCode();
  final description = error.getDescription();
  // handle error
}
Lifecycle callbacks

بالإضافة إلى onErrorUnico، تُشغّل حزمة SDK أيضًا:

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