---
title: التهيئة
canonical: https://developer.unico.io/ar/dual-api/developers/sdks-and-tools/web/web-sdk/initialization
locale: ar
generated_by: markdown-export
---

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

هيّئ SDK في أقرب وقت ممكن — عادةً عند تحميل الصفحة أو المكوّن الذي يحتوي على إطار الالتقاط. راجع [أفضل الممارسات](/dual-api/developers/sdks-and-tools/web/web-sdk/resources) للاطلاع على تفاصيل سبب عدم تهيئة SDK عند النقر على زر الالتقاط.

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

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

```javascript
import { UnicoConfig } from "unico-webframe"

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

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

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

```javascript
const unicoCameraBuilder = new UnicoCheckBuilder();
```

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

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

```javascript
unicoCameraBuilder.setResourceDirectory("/resources");
```

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

```javascript
unicoCameraBuilder.setModelsPath("https://yoursite.com/models");
```

:::info[الجلب التلقائي منذ 3.18.0]
بدءًا من الإصدار 3.18.0، يمكن لـ SDK جلب الموارد الإضافية تلقائيًا — ما عليك سوى عدم تنفيذ `setResourceDirectory` والتأكد من تطبيق [إعداد CSP](/dual-api/developers/sdks-and-tools/web/web-sdk/installation) بشكل صحيح.
:::

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

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

```javascript
unicoCameraBuilder.disableCssReset();
```

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

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

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

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

unicoCameraBuilder.setEnvironment(SDKEnvironmentTypes.UAT);
```

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

للاطلاع على القائمة الكاملة لأنواع البيئات المتاحة، راجع [مرجع API > Initialization API](/dual-api/developers/sdks-and-tools/web/web-sdk/api-reference/initialization-api).

## دورة الحياة

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