معالجة الأخطاء
تتمركز جميع عمليات معالجة الأخطاء في Flutter SDK في هذا القسم. تستقبل ردود الاتصال onErrorUnico وonErrorSelfie وonErrorDocument كائن UnicoError بالحقول code (int) وdescription (String) وinfo (String?). يحمل الحقل info خطوة التدفق التي فشلت على iOS، ويكون دائمًا null على Android.
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 | تعذّر بناء المفتاح المشفّر |
74001 | استدعاء onSuccess غير مُنفَّذ عند فتح الكاميرا باستخدام webAppToken |
فهرس الأخطاء الرسمي
تعكس الرموز أعلاه فهرس Flutter SDK. يتوفر فهرس رموز الأخطاء الرسمي عبر المنصات على مرجع API > رموز الأخطاء.
Handling the callback
@override
void onErrorUnico(UnicoError error) {
final code = error.code;
final description = error.description;
// handle error
}
Lifecycle callbacks
بالإضافة إلى onErrorUnico، تُشغّل حزمة SDK أيضًا:
onUserClosedCameraManually()— أغل ق المستخدم الكاميرا يدويًا.onSystemClosedCameraTimeoutSession()— انتهت صلاحية الجلسة بسبب انتهاء المهلة (الافتراضية 45 ثانية، والحد الأدنى 40 ثانية).onSystemChangedTypeCameraTimeoutFaceInference()— تجاوز اكتشاف الوجه حد 13 ثانية؛ تتحوّل عملية الالتقاط إلى الوضع اليدوي.