التهيئة

أين تتم التهيئة

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

تضمين بيانات الاعتماد

نفّذ فئة UnicoConfig مع بيانات الاعتماد التي يوفرها فريق Onboarding:

import { UnicoConfig } from "unico-webframe"

const config = new UnicoConfig()
  .setHostname("<YOUR_HOSTNAME>")
  .setHostKey("<YOUR_HOST_KEY>");

إنشاء نسخة البناء

أنشئ نسخة جديدة من UnicoCheckBuilder:

const unicoCameraBuilder = new UnicoCheckBuilder();

تهيئة مسارات الموارد

حدد مسار الملفات الإضافية (إذا أُضيفت إلى مشروعك):

unicoCameraBuilder.setResourceDirectory("/resources");

حدد مسار ملفات نماذج الذكاء الاصطناعي (مطلوب فقط لوضع الكاميرا الذكية):

unicoCameraBuilder.setModelsPath("https://meusite.com.br/models");

الجلب التلقائي منذ 3.18.0

بدءًا من الإصدار 3.18.0، يمكن لـ SDK جلب الموارد الإضافية تلقائيًا — ما عليك سوى عدم تنفيذ setResourceDirectory والتأكد من تطبيق إعداد CSP بشكل صحيح.

تهيئة إعادة ضبط CSS (اختياري)

بشكل افتراضي، يُطبّق SDK إعادة ضبط CSS لضمان الاتساق البصري عبر المكونات. للحفاظ على أنماط CSS تطبيقك، عطّل هذه الميزة:

unicoCameraBuilder.disableCssReset();

اختيار البيئة

يتم الاختيار بين بيئة الاختبار والإنتاج أثناء التهيئة. استخدم التعداد SDKEnvironmentTypes:

• SDKEnvironmentTypes.PROD — بيئة الإنتاج
• SDKEnvironmentTypes.UAT — بيئة الاختبار

import {
  UnicoCheckBuilder,
  SDKEnvironmentTypes
} from "unico-webframe"

unicoCameraBuilder.setEnvironment(SDKEnvironmentTypes.UAT);

معلومة

إذا لم يتم تهيئته، يستخدم Web SDK بيئة الإنتاج بشكل افتراضي.

للاطلاع على القائمة الكاملة لأنواع البيئات المتاحة، راجع مرجع API > Initialization API.

دورة الحياة

تستغرق مصادقة SDK مع الخادم الخلفي بضع ثوانٍ. هيّئه مبكرًا، وليس عند نقر المستخدم على زر الالتقاط — وإلا سيعاني المستخدم من تأخر بين النقر وفتح الكاميرا.