---
title: التقاط المستندات
canonical: https://developer.unico.io/ar/dual-api/developer/sdks-and-tools/flutter-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.OUTROS("descrição")` | إطار عام لأي مستند آخر |

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

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

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

****الخطوة 2** — تنفيذ مستمعات المستند**

أضف callbacks المستند إلى فئة الحالة الخاصة بك:

  | الطريقة | الوصف |
  |---|---|
  | `onSuccessDocument(ResultCamera resultCamera)` | نجح الالتقاط — يُعيد `ResultCamera` مع `base64` (معاينة) و`encrypted` (JWT لواجهة API) |
  | `onErrorDocument(UnicoError error)` | فشل الالتقاط — يُعيد `UnicoError` مع الرمز والوصف |

  ```dart
  @override
  void onSuccessDocument(ResultCamera resultCamera) { }

  @override
  void onErrorDocument(UnicoError error) { }
  ```

****الخطوة 3** — استدعاء `openCameraDocument`**

يتم توفير طريقة `openCameraDocument()` عبر الكائن المُنشأ من نسخة فئة `UnicoCheck`. تأخذ:

  - ملف JSON يحتوي على بيانات الاعتماد، مُنشأ في [خطوة إعداد بيانات الاعتماد](/developers/sdks-and-tools/flutter/installation/specific-setup)؛
  - نوع المستند المراد التقاطه (تعداد `DocumentType`)؛
  - المستمع المُهيأ في الخطوة 2.

  مثال باستخدام CNH المفتوح:

  ```dart
  _unicoCheck.build().openCameraDocument(
    jsonFileName: androidJsonFileName,
    documentType: DocumentType.CNH,
    listener: this,
  );
  ```

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