---
title: التقاط المستندات
canonical: https://developer.unico.io/ar/dual-api/developer/sdks-and-tools/web-sdk/document-capture/
locale: ar
generated_by: markdown-export
---

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

:::warning[لا يوجد تحقق من المحتوى]
لا يُجري SDK أي نوع من التحقق على ما يتم التقاطه.
:::

## إطارات المستندات المتاحة

| الإطار | الوصف |
|---|---|
| `DocumentCameraTypes.CPF` | التقاط CPF |
| `DocumentCameraTypes.CNH` | التقاط CNH المفتوح |
| `DocumentCameraTypes.CNH_FRENTE` | التقاط الوجه الأمامي للـ CNH |
| `DocumentCameraTypes.CNH_VERSO` | التقاط الوجه الخلفي للـ CNH |
| `DocumentCameraTypes.RG_FRENTE` | التقاط الوجه الأمامي للـ RG |
| `DocumentCameraTypes.RG_VERSO` | التقاط الوجه الخلفي للـ RG |
| `DocumentCameraTypes.RG_FRENTE_NOVO` | التقاط الوجه الأمامي للـ RG الجديد |
| `DocumentCameraTypes.RG_VERSO_NOVO` | التقاط الوجه الخلفي للـ RG الجديد |
| `DocumentCameraTypes.OTHERS("descrição")` | إطار عام لأي مستند آخر |

:::tip[إطار عام]
إذا كنت بحاجة إلى التقاط مستند لا يوجد له إطار محدد (مثل RNE)، استخدم `DocumentCameraTypes.OTHERS("description")` — إطار مستطيل عام يمكن استخدامه لتوجيه أي عملية التقاط.
:::

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

## حجم الإطار

يُنصح بضبط حجم الإطار داخل تطبيقك لتحسين منطقة الالتقاط.

:::info[تداخل CSS]
قد تتأثر وظيفة الإطار بأنظمة التصميم التي تحتوي على مكونات الشبكة (Bootstrap، Material-UI، إلخ). للتقليل من هذا الخطر، ضع الإطار (`id="box-camera"`) في مكان لا يرث فيه قواعد CSS غير مرغوبة.
:::

### سطح المكتب

لف الإطار في عنصر أب لتقييد أبعاده:

  ```html
  <div class="container">
    <div id="box-camera"></div>
  </div>
  ```

  ```css
  .container {
    width: 800px;
    height: 600px;
    position: relative;
  }
  ```

  حافظ على نسبة ارتفاع إلى عرض مناسبة لتسهيل تأطير وجه المستخدم.

  :::warning[تغيير الحجم عبر أدوات المطور]
  لن تعمل الاختبارات التي تتضمن تغيير حجم الشاشة عبر وضع المطور في المتصفح كما هو متوقع. قم بتغيير حجم نافذة المتصفح مباشرةً.
  :::

### الجوّال

في عروض الويب للجوّال، يجب أن يشغل إطار الالتقاط 100% من شاشة الجهاز (`100vw`/`100vh`) لتجنب مشكلات خوارزميات رؤية الحاسوب. تجنب التمرير الأفقي أو العمودي — يساعد استخدام نافذة منبثقة في تقليص هذه المشكلة.

  :::warning[الاختبار على أجهزة فعلية]
  الاختبار عبر وضع المطور في المتصفح لا يعمل — الكاميرا التي يستخدمها المتصفح هي نفس كاميرا سطح المكتب، وتختلف اختلافًا كبيرًا في الدقة عن كاميرا الجهاز المحمول. اختبر مباشرةً على الجهاز.
  :::

## بدء التقاط المستندات

****الخطوة 2** — بناء الكاميرا وتجهيز جلسة المستند**

ابنِ نسخة الكاميرا واستدعِ `prepareDocumentCamera` مع تمرير `UnicoConfig` ونوع `DocumentCameraTypes` المطلوب:

  ```javascript
  const unicoCamera = unicoCameraBuilder.build();

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

  unicoCamera.prepareDocumentCamera(
    config,
    DocumentCameraTypes.CNH
  ).then(cameraOpener => {
    cameraOpener.open(callback);
  }).catch(error => {
    console.error(error);
  });
  ```

للاطلاع على معالجة النتيجة الكاملة، راجع [استلام النتيجة](/dual-api/developers/sdks-and-tools/web/web-sdk/capture-flow/receiving-the-result).