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

تتمركز جميع أعمال معالجة الأخطاء الخاصة بـ Web SDK في هذا القسم. تستقبل معاودة الاتصال `error` كائن `ErrorBio` الذي يوفر `getCode()` و`getDescription()`.

## أخطاء prepareCamera

| الرمز | الوصف |
|---|---|
| `73000` | خطأ مجهول وغير متوقع أثناء الاستخدام الطبيعي لـ SDK APIs |
| `73001` | `<property>` مطلوب |
| `73002` | يجب أن يكون `<property>` نسخة من `<class>` |
| `73003` | `<class>` بالاسم `<name>` غير متاح للحقن |
| `73004` | يجب أن يكون نوع الفئة دالة أو كلاسًا |
| `73005` | تعذر إيجاد اللغة المحلية `<locale>` |
| `73006` | تعذر إيجاد النص: `<text>` |
| `73100` | تعذر الاتصال بالإنترنت |
| `73200` | تعذر إيجاد ملف JSON لـ Unico SDK |
| `73201` | تعذر تحميل ملف JSON لـ Unico SDK |
| `73202` | ملف JSON لـ Unico SDK غير صالح |
| `73204` | تعذر تهيئة SDK — هيّئ البيئة عبر `setEnvironment` عند البناء |
| `73300` | تعذر مصادقة هذا التطبيق |
| `73301` | تعذر مصادقة هذا التطبيق |
| `73302` | لم يُعثر على رمز المصادقة |
| `73303` | المضيف الحالي غير مسجل |
| `73400` | تعذر تهيئة الكاميرا |
| `73401` | تعذر تحميل نماذج التعلم الآلي لهذه الكاميرا |
| `73402` | تعذر التحقق من المفتاح بسبب مشكلات الاتصال على جهاز المستخدم |
| `73403` | مجموعة الجهاز/المنصة/المتصفح/الإصدار هذه غير مدعومة من SDK |
| `73404` | الجهاز في وضع الاتجاه الأفقي. لا يمكن استخدام SDK إلا في الوضع العمودي |
| `73405` | تم حظر الجهاز بسبب محاولات فاشلة متعددة |
| `73406` | تم حظر تهيئة الكاميرا — تم فتح SDK في iFrame أثناء `prepareCamera` |
| `73407` | لم يتم تحميل SDK بالكامل |
| `73500` | تعذر الحصول على الجلسة |
| `73501` | تعذر الحصول على الجلسة |
| `73502` | لم يُعثر على رمز الجلسة |
| `73600` | تعذر إيجاد مورد الكاميرا |
| `73601` | تعذر تشغيل الكاميرا في وضع الإنتاج |
| `74000` | قيمة سداسية عشرية غير صالحة |
| `74001` | الكائن ليس `UnicoTheme` |

## أخطاء openCamera

| الرمز | الوصف |
|---|---|
| `73700` | تعذر تحليل استجابة الكاميرا |
| `73704` | ضغط المستخدم على زر الإلغاء ولم يكمل الجلسة |
| `73706` | رُفض الوصول إلى الكاميرا — رفض المستخدم الإذن صراحةً أو تحجب سياسة الجهاز الوصول |
| `73707` | تم إلغاء الجلسة بسبب إنهاء التطبيق أو وضع السكون أو إشعار نظام التشغيل أو العمل في الخلفية |
| `73708` | تم إلغاء الجلسة لأن الجهاز في الوضع الأفقي |
| `73710` | تم إلغاء الجلسة لأن المستخدم لم يتمكن من إكمالها خلال المهلة المحددة |
| `73715` | تم إلغاء الجلسة لأنه لم يتم تهيئة جميع صور الإرشاد |
| `73716` | تم إلغاء الجلسة لأن SDK لم يتمكن من تشغيل الكاميرا على هذا الجهاز |
| `73717` | تم إلغاء الجلسة لأن المستخدم في حالة حظر |
| `73718` | خطأ مجهول وغير متوقع أثناء الاستخدام الطبيعي لـ SDK APIs |
| `73720` | أجرى المطور إلغاء الجلسة برمجيًا عبر API الإلغاء |
| `73721` | تم إلغاء الجلسة بسبب تغيير اتجاه الجهاز أثناء الجلسة |
| `73722` | تم إلغاء الجلسة لأن المستند غير جاهز |
| `73723` | تم إلغاء الجلسة لأن هناك جلسة أخرى قيد التقدم |
| `73724` | تم إلغاء الجلسة النشطة لأن جلسة الكاميرا بدأت داخل iFrame |
| `73728` | خطأ في الاتصال — يُرجى استخدام HTTPS للاتصال |
| `73729` | المتصفح غير مدعوم — يُرجى فتحه في متصفح آخر |
| `73730` | تعذر تهيئة جلسة التحقق النشط من الحضور الحي — خطأ ترخيص مجهول |
| `73731` | تعذر تهيئة جلسة التحقق النشط من الحضور الحي — انتهت صلاحية الترخيص |
| `73732` | تعذر تهيئة جلسة التحقق النشط من الحضور الحي — الأصل غير مسموح به |
| `73750` | فشل الالتقاط لأن عيني المستخدم كانتا مغمضتين |
| `73760` | فشل الالتقاط بسبب الإضاءة في البيئة (مظلمة جدًا أو ساطعة جدًا أو غير متجانسة) |
| `73761` | فشل الالتقاط بسبب المسافة بين وجه المستخدم والشاشة (قريبة جدًا أو بعيدة جدًا) |
| `73762` | فشل الالتقاط لأن النظارات أو الإكسسوارات تغطي وجه المستخدم |
| `73763` | فشل الالتقاط لأن وجه المستخدم لم يكن ثابتًا أو محاذيًا |
| `73764` | فشل الالتقاط بسبب تأطير الوجه (الوجه غير متمركز، أو أكثر من وجه، أو خلفية مزدحمة) |
| `73800` | تعذر تشفير الاستجابة |
| `73900` | تعذر الحصول على معلومات النظام |

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

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

```javascript
const callback = {
  on: {
    success: (obj) => {
      console.log(obj.base64);
      console.log(obj.encrypted);
    },
    error: (error) => {
      const code = error.getCode();
      const description = error.getDescription();
      // handle error
    }
  }
};
```

:::danger[كائن callback إلزامي]
كائن `callback` إلزامي. إذا لم يُنفَّذ بشكل صحيح (بحيث يغطي كلًّا من حدثَي `success` و`error`)، فإن SDK يُطلق استثناءً يُعرض في وحدة تحكم المستخدم إذا لم يُعالَج.
:::