--- title: معالجة الأخطاء canonical: https://developer.unico.io/ar/developers/sdks-and-tools/android/error-handling locale: ar generated_by: markdown-export --- - [/ar/](/ar/) - [SDKs والأدوات](/ar/developers/sdks-and-tools/overview) - [Android SDK](/ar/developers/sdks-and-tools/android/requirements) - معالجة الأخطاء # معالجة الأخطاء تتمركز جميع عمليات معالجة أخطاء 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 */ } }} ``` ``` @Overridepublic 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 > رموز الأخطاء](/ar/developers/start/error-codes).آخر تحديث في 8 أكتوبر 2026**