---
title: معالجة الأخطاء
canonical: https://developer.unico.io/ar/dual-api/developers/sdks-and-tools/android/error-handling
locale: ar
generated_by: markdown-export
---

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

## معالجة رد الاتصال

### Kotlin

  ```kotlin
  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 */ }
    }
  }
  ```

### Java

  ```java
  @Override
  public 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.` | خطأ عام في مزود الجلسة — أعد المحاولة |

:::secondary[رموز خطأ REST API]
الرموز أعلاه هي أخطاء رد اتصال SDK. يتم توثيق رموز خطأ REST API (عائلات حالة HTTP) بشكل منفصل في [مرجع API > رموز الأخطاء](/dual-api/developers/api-reference/error-codes).
:::