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

- [/ar/](/ar/)
- [SDKs والأدوات](/ar/developers/sdks-and-tools/overview)
- [Flutter SDK](/ar/developers/sdks-and-tools/flutter/requirements)
- معالجة الأخطاء

# معالجة الأخطاء

تتمركز جميع عمليات معالجة الأخطاء في 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 > رموز الأخطاء](/ar/developers/start/error-codes).

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 ثانية؛ تتحوّل عملية الالتقاط إلى الوضع اليدوي.
آخر تحديث في 22 أكتوبر 2026**