---
title: واجهة برمجة تطبيقات الالتقاط
canonical: https://developer.unico.io/ar/dual-api/developers/sdks-and-tools/android/api-reference/capture-api
locale: ar
generated_by: markdown-export
---

## أساليب لتحضير جلسة

استدعِ هذه الأساليب على واجهة `UnicoCheckCamera` المستخرجة من SDK builder. بعد التحضير، يوفر استدعاء `CameraListener.onCameraReady(cameraOpener)` أداة الفتح لبدء الالتقاط.

| الأسلوب | الوصف |
|---|---|
| `prepareCamera(config, listener)` | يُحضِّر كاميرا السيلفي. `listener` هو `CameraListener`. |
| `prepareDocumentCamera(config, listener)` | يُحضِّر كاميرا المستندات. `listener` هو `DocumentCameraListener`. |

## فتح الكاميرا

بعد تشغيل `onCameraReady`، استدعِ `open` على كائن الفتح المستلم:

**صورة شخصية — `UnicoCheckCameraOpener.Camera`**

| الأسلوب | الوصف |
|---|---|
| `open(listener: iAcessoBioSelfie)` | يفتح كاميرا السيلفي |
| `open(listener: iAcessoBioSelfie, webAppToken: String)` | يفتح كاميرا السيلفي لرحلة المستخدم، مع تمرير رمز الرحلة |

**مستند — `UnicoCheckCameraOpener.Document`**

| الأسلوب | الوصف |
|---|---|
| `open(documentType: DocumentType, listener: iAcessoBioDocument)` | يفتح التقاط المستند للنوع المحدد |
| `open(documentType: DocumentType, description: String, listener: iAcessoBioDocument)` | يفتح التقاط المستند مع تسمية وصفية مخصصة |

## DocumentType

يحدد نوع المستند المراد التقاطه. راجع [التعدادات](/developers/sdks-and-tools/android/api-reference/enums) للاطلاع على القائمة الكاملة.

## أنواع النتائج والحقول

**`ResultCamera`** — الكائن المُعاد عند النجاح.

| الحقل | النوع | الوصف |
|---|---|---|
| `base64` | `String` | الصورة الملتقطة بترميز Base64 |
| `encrypted` | `String` | JWT لإرساله إلى الخادم الخلفي |