معالجة الأخطاء
تتمركز جميع عمليات معالجة أخطاء iOS SDK في هذا القسم. يتلقى استدعاء onErrorAcessoBioManager كائن ErrorBio الذي يعرض الدالتين getCode() وgetDescription().
رموز الأخطاء
| الرمز | الوصف |
|---|---|
73000 | تم إلغاء الجلسة بسبب خطأ غير معروف وغير متوقع. يستخدم Unico Check SDK مجموعة متنوعة من واجهات برمجة تطبيقات iOS تشمل الكاميرا والتخزين والأمان والشبكة وغيرها — هذا خطأ شامل. |
73001 | السياق غير صالح |
73003 | يجب أن يكون إصدار API 13 أو أحدث |
73006 | تعذر فتح الكاميرا على المحاكيات |
73100 | تعذر الاتصال بالإنترنت |
73200 | تعذر العثور على ملف JSON الخاص بـ unico_sdk |
73202 | تعذر تحميل ملف JSON الخاص بـ unico_sdk |
73203 | تعذر تحميل AcessoBioConfigDataSource |
73204 | تعذر تهيئة SDK — قم بتهيئة البيئة عبر setEnvironment عند البناء |
73300 | تعذر الحصول على كائن مصادقة unico |
73301 | تعذر تحليل كائن مصادقة unico |
73302 | تعذر العثور على رمز unico |
73701 | تعذر العثور على استيراد الحيوية النشطة |
73702 | تعذر تهيئة الحيوية النشطة في وضع الإنتاج |
73703 | تعذر الحصول على جلسة الحيوية النشطة |
73704 | ضغط المستخدم على زر الإلغاء ولم يكمل الجلسة |
73705 | لم تُنجَز الجلسة بنجاح ولم يتم إنشاء FaceScan |
73706 | تم رفض الوصول إلى الكاميرا — رفض المستخدم صراحةً أو تحظره سياسة الجهاز |
73707 | تم إلغاء الجلسة بسبب إنهاء التطبيق، أو وضع السكون، أو إشعار من نظام التشغيل، أو الانتقال إلى الخلفية |
73708 | تم إلغاء الجلسة لأن الجهاز في الوضع الأفقي |
73709 | تم إلغاء الجلسة لأن الجهاز في وضع العمودي المعكوس |
73710 | تم إلغاء الجلسة لأن المستخدم لم يتمكن من إكمالها خلال المهلة المحددة |
73711 | تم إلغاء الجلسة بسبب ضغط الذاكرة |
73712 | تم إلغاء الجلسة لأن تطبيقك ليس في الإنتاج ويتطلب اتصالاً بالشبكة |
73713 | تم إلغاء الجلسة لأن مفتاحك يحتاج إلى التحقق مجدداً |
73714 | تم إلغاء الجلسة لأن مفتاح التشفير الذي هيأه المطور لم يكن صالحاً |
73715 | تم إلغاء الجلسة لأنه لم يتم تهيئة جميع صور التوجيه |
73716 | تم إلغاء الجلسة لأن SDK تعذر عليه تشغيل الكاميرا على هذا الجهاز |
73717 | تم إلغاء الجلسة لأن المستخدم في حالة محظورة |
73718 | خطأ غير معروف وغير متوقع أثناء الاستخدام الاعتيادي لواجهات برمجة تطبيقات iOS |
73719 | تم إلغاء الجلسة لأن المستخدم ضغط على نص الرسالة الفرعية في شاشة الاستعداد |
73720 | لم تتم معالجة الجلسة |
73721 | لا يمكن إجراء الجلسة: تجاوز حد المحاولات |
73722 | لا يمكن إجراء الجلسة: انتهت مهلة محاذاة الوجه |
73730 | تعذر تهيئة جلسة الحيوية النشطة — خطأ غير معروف في الترخيص |
73731 | تعذر تهيئة جلسة الحيوية النشطة — انتهت صلاحية الترخيص |
73800 | تعذر بناء المفتاح المشفر |
الكتالوج الرسمي للأخطاء
تعكس الرموز أعلاه كتالوج iOS SDK. يتوفر كتالوج رموز الأخطاء الرسمي متعدد المنصات في مرجع API > رموز الأخطاء.
استدعاءات دورة الحياة
بالإضافة إلى onErrorAcessoBioManager، يُطلق SDK أيضاً:
onUserClosedCameraManually()— أغلق المستخدم الكاميرا يدوياً.onSystemClosedCameraTimeoutSession()— انتهت مهلة الجلسة (الافتراضي 40 ثانية، الحد الأدنى 40 ثانية).onSystemChangedTypeCameraTimeoutFaceInference()— تجاوز الكشف عن الوجه حد الـ 13 ثانية؛ يتحول الالتقاط إلى الوضع اليدوي.
توجيه الاستدعاءات للإلغاء وانتهاء المهلة
الأخطاء 73704 (المستخدم ألغى) و73710 (انتهاء مهلة الجلسة) لا يتم تسليمها عبر onErrorAcessoBioManager. تُطلق مباشرةً استدعاءات دورة الحياة المقابلة:
73704←onUserClosedCameraManually()73710←onSystemClosedCameraTimeoutSession()