التثبيت

إضافة التبعية وتكوين مدير الحزم

الخطوة 1 — تكوين سياسة أمان المحتوى (CSP)

يستخدم Web SDK عمال الويب (Web Workers) للأمان والأداء. أضف التكوين التالي إلى CSP الخاص بك:

<meta
  http-equiv="Content-Security-Policy"
  content="
      script-src 'self' 'unsafe-eval' *.googleapis.com *.acesso.io *.unico.run *.unico.io *.unico.app *.sentry.io;
      worker-src 'self' blob:;
      child-src 'self' blob:;
      style-src 'self' 'unsafe-inline' *.googleapis.com *.acesso.io *.unico.run *.unico.io *.unico.app;
      font-src 'self' https://fonts.gstatic.com *.acesso.io *.unico.run *.unico.io *.unico.app;
      img-src 'self' data: blob: *.acesso.io *.unico.run *.unico.io *.unico.app;
      media-src 'self' data: *.acesso.io *.unico.run *.unico.io *.unico.app;
      script-src-elem 'self' 'unsafe-inline' blob: *.googleapis.com *.acesso.io *.unico.run *.unico.io *.unico.app;
      connect-src *.googleapis.com *.acesso.io *.unico.run *.unico.io *.unico.app *.sentry.io"
/>

تحذير

إذا كان تطبيقك يستخدم CSP، فهذا التكوين إلزامي لضمان عمل SDK بشكل صحيح.

لماذا كل توجيه مطلوب

'unsafe-eval' (script-src) — مطلوب من محرك كشف الحيوية لتجميع WebAssembly وتقييم روتينات الأمان ديناميكيًا في وقت التشغيل.
'unsafe-inline' (style-src, script-src-elem) — مطلوب بسبب الأنماط المضمّنة وتحميل البرامج النصية المضمّنة في SDK. حذفه يتسبب في تعطل واجهة الالتقاط.
*.acesso.io — نطاق البنية التحتية القديمة لـ Unico، ولا يزال ضروريًا للأصول واستدعاءات API.
*.unico.run / *.unico.io / *.unico.app — نطاقات خدمة Unico الحالية (CDN وAPI والنطاقات الفرعية للتطبيقات).
*.googleapis.com (script-src, style-src, script-src-elem, connect-src) — مطلوب لتحميل ورقة أنماط Google Fonts (CSS @font-face عبر fonts.googleapis.com) وموارد Google API الأخرى التي تستخدمها واجهة الالتقاط.
fonts.gstatic.com (font-src) — يوفر ملفات الخطوط الثنائية من Google Fonts المشار إليها في ورقة الأنماط المحمّلة من fonts.googleapis.com.
*.sentry.io — تستخدم Unico Sentry لتتبع أخطاء SDK. مطلوب في script-src وconnect-src للسماح باستدعاءات تقارير الأخطاء.
blob: (worker-src, child-src, script-src-elem) — مطلوب لأن Web Workers وبعض الموارد الفرعية لـ SDK تُنشأ كعناوين URL من نوع Blob في وقت التشغيل.

الخطوة 2 — تثبيت الحزمة

يُتاح Web SDK عبر حزمة npm أو CDN.

npm
yarn
CDN

npm install unico-webframe

yarn add unico-webframe

قم بتنزيل SDK واستيراده إلى مشروعك:

تنزيل الإصدار 3.23.7

الخطوة 3 — استيراد SDK

بعد التثبيت، استورد SDK إلى مشروعك.

من npm
من CDN

import {
  UnicoCheckBuilder,
  SelfieCameraTypes,
  UnicoThemeBuilder,
  DocumentCameraTypes,
  UnicoConfig,
  LocaleTypes
} from 'unico-webframe'

import {
  UnicoCheckBuilder,
  SelfieCameraTypes,
  UnicoThemeBuilder,
  DocumentCameraTypes,
  UnicoConfig,
  LocaleTypes
} from 'UnicoCheckBuilder.min.js'

الخطوة 4 — تنزيل ملفات الموارد الإضافية

تُعدّ ملفات الموارد الإضافية ضرورية لإجراء التقاط Liveness. قم بتنزيل الملف المطابق لإصدار SDK الخاص بك وأدرجه في مشروعك:

قائمة التحقق عند الترقية

ملفات الموارد مرتبطة بإصدار SDK. في كل مرة تقوم فيها برفع إصدار unico-webframe، يجب إعادة تنزيل الموارد المطابقة من الجدول أدناه — استخدام إصدارات غير متطابقة يتسبب في خطأ في وقت التشغيل أثناء التقاط Liveness.

بدلاً من ذلك، منذ SDK 3.18.0 يمكن للـ SDK جلب هذه الملفات تلقائيًا عند التهيئة، مما يُلغي خطوة التنزيل اليدوي. راجع التهيئة للاطلاع على خيار setResourceDirectory.

إصدار SDK	موارد FaceTec
3.23.7	9.7.114
3.23.3 → 3.23.6	9.7.107
3.23.0 → 3.23.1	9.7.102
3.22.6 → 3.22.7	9.7.100
3.22.5	9.7.99
3.22.3 → 3.22.4	9.7.98
3.22.2	9.7.96
3.22.1	9.7.93
3.22.0	9.7.90
3.21.3 → 3.21.4	9.7.85
3.21.2	9.7.82
3.21.1	9.7.80
3.20.10 → 3.21.0	9.7.76
3.20.9	9.7.75
3.20.8	9.7.73
3.20.7	9.7.68
3.20.5 → 3.20.6	9.7.65
3.20.3 → 3.20.4	9.7.64
3.20.2	9.7.63
3.20.1	9.7.61
3.20.0	9.7.55
3.19.0 → 3.19.3	9.7.45 → 9.7.51
3.18.x	9.6.92 → 9.7.41 (انظر الجدول القديم)

قم أيضًا بتنزيل ملفات الذكاء الاصطناعي الخاصة بـ SDK: models.zip.

المسار العام

يجب استضافة جميع الملفات الإضافية في موقع عام مرئي للويب داخل مشروعك.