الانتقال إلى المحتوى الرئيسي

حزم SDK والأدوات

تُدمج حزم SDK الخاصة بـ Unico مباشرةً في تطبيقك لإدارة تجربة الالتقاط على جانب العميل. عند الالتقاط الناجح، تُعيد حزمة SDK حمولةً مشفرة تُرسلها الواجهة الخلفية إلى محرك IDCloud للتحقق البيومتري للتحليل عبر REST API.

حزم SDK المتاحة

Android SDK

مكتبة أصيلة لتطبيقات Java وKotlin.

الإصدار الحالي6.5.0
اللغةKotlin / Java
الحد الأدنى للإصدار5.0 (API 21)
Kotlin1.8.22+
iOS SDK

مكتبة أصيلة لتطبيقات Swift وObjective-C.

الإصدار الحالي3.0.0
اللغةSwift / Objective-C
الحد الأدنى للإصدارiOS 13
Xcode16.0+
Flutter SDK

إضافة مبنية فوق حزم SDK الأصيلة لـ Android وiOS.

الإصدار الحالي4.52.0
اللغةDart
الحد الأدنى لـ Android5.0 (API 21)
الحد الأدنى لـ iOSiOS 13
Web SDK

مكتبة JavaScript لتدفقات الالتقاط عبر المتصفح.

الإصدار الحالي3.23.7
اللغةJavaScript
الوحدةESM / CommonJS
Chrome85+
Firefox94+
Safari11+

الميزات الرئيسية

التحقق من الحضور الحي

تتكامل حزم SDK مع إمكانية Liveness للتأكد من الحضور الفعلي للمستخدم لحظة الالتقاط. لا تكتمل جلسة الالتقاط إلا بعد التحقق من الحضور الحي، مما يحول دون محاولات الانتحال كالصور ومقاطع الفيديو والأقنعة.

SmartFrames

تتكيف واجهة الالتقاط تلقائيًا مع ملامح المستخدم وأبعاد الشاشة. يُحسّن ذلك صلاحية البيانات البيومترية ويُقلل من حالات رفض الالتقاط مقارنةً بتطبيقات الكاميرا القياسية، دون أن يحتاج المطور إلى أي إعدادات.

طبقات الأمان

تأتي كل حزمة SDK مزودة بضوابط أمنية متعددة تُطبَّق في وقت التشغيل:

  • تشفير الحمولة بين العميل والواجهة الخلفية
  • منع الحقن والتلاعب
  • كشف الاحتيال عبر أوضاع الكاميرا المختلفة
  • تشويش الكود البرمجي
  • حظر المحاكيات
  • التحقق من حزمة التطبيق

آلية العمل

تتولى حزمة SDK (على جانب العميل) تبسيط التكامل مع منصة Unico، إذ تتعامل مع كامل تعقيدات التحكم في الكاميرا والتقاط الصور ورحلة المستخدم.

في حال نجاح الالتقاط، تُعيد حزمة SDK حمولةً مشفرة يجب إرسالها إلى واجهة برمجة تطبيقات المحرك البيومتري، وبذلك يكتمل التحقق البيومتري كما هو موضح في المخطط أدناه:

آلية العمل

تتولى حزمة SDK تدفق الالتقاط الكامل على جانب العميل: الوصول إلى الكاميرا، والتحقق من الإطار، وفحص الحضور الحي، والتشفير. تتلقى الواجهة الخلفية الحمولة المشفرة وتُعيدها إلى محرك IDCloud للتحقق البيومتري — دون نقل أي صورة خام.

تُنتج حزم SDK هذه مخرجات لعقد Web & SDK (‏POST /client/v1/process). أما في عقد API، فيُعالَج الالتقاط على واجهتك الخاصة ويُرسل imageBase64 مباشرةً.

إدارة الإصدارات

تتبع إصدارات حزم SDK نظام الإصدار الدلالي (MAJOR.MINOR.PATCH). تعتمد مسؤولية تحديث حزمة SDK على نموذج التكامل المُعتمد. في تكاملات by-Client، يقع على عاتقك الحفاظ على تحديث حزمة SDK — فالإصدارات القديمة قد تفقد تغطية الأمان أو إمكانية الوصول إلى القدرات الجديدة. أما في تكاملات by-Unico، فتتولى Unico دفع التحديثات تلقائيًا.

  • الإصدار الرئيسي (MAJOR): عند إجراء تغييرات غير متوافقة مع واجهة برمجة التطبيقات.
  • الإصدار الثانوي (MINOR): عند إضافة وظائف مع الحفاظ على التوافق.
  • إصدار الإصلاح (PATCH): عند إصلاح الأخطاء مع الحفاظ على التوافق.
البيئات المدعومة

المدعومة: Android الأصيل، وiOS الأصيل، وFlutter عبر إضافتنا. غير المدعومة: أي إطار عمل هجين أو متعدد المنصات، بما في ذلك على سبيل المثال لا الحصر React Native وIonic.