حزم SDK والأدوات
تُدمج حزم SDK الخاصة بـ Unico مباشرةً في تطبيقك لإدارة تجربة الالتقاط على جانب العميل. عند الالتقاط الناجح، تُعيد حزمة SDK حمولةً مشفرة تُرسلها الواجهة الخلفية إلى محرك IDCloud للتحقق البيومتري للتحليل عبر REST API.
حزم SDK المتاحة
مكتبة أصيلة لتطبيقات Java وKotlin.
مكتبة أصيلة لتطبيقات Swift وObjective-C.
إضافة مبنية فوق حزم SDK الأصيلة لـ Android وiOS.
مكتبة JavaScript لتدفقات الالتقاط عبر المتصفح.
إثباتات المفهوم (PoCs)
استكشف تطبيقات إثباتات المفهوم (PoCs) الرسمية لكل SDK قبل بدء عملية الدمج — تطبيقات مُتحقَّق منها ومُحدَّثة لتدفقات الالتقاط الرئيسية.
حزم SDK الأصلية
| المنصة | التدفق | المستودع |
|---|---|---|
| Android | لايفنس | GitHub — unico-sdk-poc-kotlin |
| Android | User Journeys | GitHub — unico-sdks-poc-kotlin |
| iOS | لايفنس | GitHub — unico-sdk-poc-ios-swift |
| iOS | User Journeys | GitHub — unico-sdks-poc-swift |
| Flutter | لايفنس | GitHub — unico-sdk-poc-flutter |
| Flutter | User Journeys | GitHub — unico-sdks-flutter |
تكامل تطبيق الويب (Journeys SDK)
| اللغة / الإطار | المستودع |
|---|---|
| Angular | GitHub — unico-cbu-poc-angular |
| JS Vanilla | GitHub — unico-cbu-poc-js |
| React | GitHub — unico-cbu-poc-react |
| Vue JS | GitHub — unico-cbu-poc-vuejs |
Web SDK
| اللغة / الإطار | المستودع |
|---|---|
| Angular | GitHub — unico-sdk-poc-angular |
| JS Vanilla | GitHub — unico-sdk-poc-js-vanilla |
| Next.js | GitHub — unico-sdk-poc-next-js |
| React JS مع TypeScript | GitHub — unico-webframe-poc-react |
| React JS مع JavaScript | GitHub — unico-sdk-poc-react-js |
| React JS مع Webpack + Babel | SFTP — اطلب من مدير مشروعك |
| Vue JS | GitHub — unico-sdk-poc-vuejs |
الميزات الرئيسية
تتكامل حزم SDK مع إمكانية Liveness للتأكد من الحضور الفعلي للمستخدم لحظة الالتقاط. لا تكتمل جلسة الالتقاط إلا بعد التحقق من الحضور الحي، مما يحول دون محاولات الانتحال كالصور ومقاطع الفيديو والأقنعة.
تتكيف واجهة الالتقاط تلقائيًا مع ملامح المستخدم وأبعاد الشاشة. يُحسّن ذلك صلاحية البيانات البيومترية ويُقلل من حالات رفض الالتقاط مقارنةً بتطبيقات الكاميرا القياسية، دون أن يحتاج المطور إلى أي إعدادات.
طبقات الأمان
تأتي كل حزمة 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.