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

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

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

## استدعاءات دورة الحياة

بالإضافة إلى `onErrorAcessoBioManager`، يُطلق SDK أيضاً:

- `onUserClosedCameraManually()` — أغلق المستخدم الكاميرا يدوياً.
- `onSystemClosedCameraTimeoutSession()` — انتهت مهلة الجلسة (الافتراضي 40 ثانية، الحد الأدنى 40 ثانية).
- `onSystemChangedTypeCameraTimeoutFaceInference()` — تجاوز الكشف عن الوجه حد الـ 13 ثانية؛ يتحول الالتقاط إلى الوضع اليدوي.

:::info[توجيه الاستدعاءات للإلغاء وانتهاء المهلة]
الأخطاء `73704` (المستخدم ألغى) و`73710` (انتهاء مهلة الجلسة) لا يتم تسليمها عبر `onErrorAcessoBioManager`. تُطلق مباشرةً استدعاءات دورة الحياة المقابلة:
- `73704` ← `onUserClosedCameraManually()`
- `73710` ← `onSystemClosedCameraTimeoutSession()`
:::