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

تتمركز جميع عمليات معالجة الأخطاء في 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` | تعذّر بناء المفتاح المشفّر |

:::secondary[فهرس الأخطاء الرسمي]
تعكس الرموز أعلاه فهرس Flutter SDK. يتوفر فهرس رموز الأخطاء الرسمي عبر المنصات على [مرجع API > رموز الأخطاء](/dual-api/developers/api-reference/error-codes).
:::

## Handling the callback

```dart
@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 ثانية؛ تتحوّل عملية الالتقاط إلى الوضع اليدوي.