---
title: الحيوية (سيلفي بيومترية)
canonical: https://developer.unico.io/ar/dual-api/developers/sdks-and-tools/android/capture-flow/capture-types/liveness
locale: ar
generated_by: markdown-export
---

التقاط سيلفي بيومترية مع التحقق المدمج من الحيوية. يرشد SDK المستخدم حتى يتم الحصول على إطار صالح بيومترياً عبر SmartFrames، ويُعيد الصورة بتنسيق Base64 + JWT (JSON Web Token — حمولة موقَّعة تُرسَل إلى الواجهة الخلفية لاستدعاء REST API).

:::secondary[القدرة]
يستخدم هذا النوع من الالتقاط قدرة **الحيوية**. للاطلاع على نظرة عامة مفاهيمية حول آلية عمل الحيوية، راجع [صفحة قدرة الحيوية](/capabilities/liveness).
:::

## آلية العمل

يدير SDK جلسة الالتقاط الكاملة:

1. يفتح الكاميرا مع طبقة SmartFrame.
2. يرشد المستخدم إلى وضع وجهه داخل الإطار.
3. يتحقق من الحيوية — تكتمل الجلسة فقط عند التحقق من الحضور الجسدي للمستخدم.
4. يُعيد كائن `ResultCamera` يحتوي على `base64` و`encrypted` (JWT).

## بدء التقاط الحيوية

****الخطوة 2** — تنفيذ `iAcessoBioSelfie`**

يتعامل `iAcessoBioSelfie` مع استدعاءات نتيجة التقاط السيلفي:

  | الطريقة | الوصف |
  |---|---|
  | `onSuccessSelfie(result)` | نجح الالتقاط — يُعيد `ResultCamera` مع `base64` (معاينة) و`encrypted` (JWT للـ API) |
  | `onErrorSelfie(errorBio)` | فشل الالتقاط — يُعيد `ErrorBio` يحتوي على رمز الخطأ ووصفه |

  :::warning[انتهاء صلاحية الرمز]
  يجب ألا تتجاوز الفترة الزمنية بين توليد `encrypted` وإرساله إلى الـ API **10 دقائق**.
  :::

  ### Kotlin

    ```kotlin
    val selfieListener = object : iAcessoBioSelfie {
      override fun onSuccessSelfie(result: ResultCamera?) { }
      override fun onErrorSelfie(errorBio: ErrorBio?) { }
    }
    ```

### Java

    ```java
    iAcessoBioSelfie selfieListener = new iAcessoBioSelfie() {
      @Override
      public void onSuccessSelfie(ResultCamera result) { }

      @Override
      public void onErrorSelfie(ErrorBio errorBio) { }
    };
    ```

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

بعد تهيئة `unicoCheckCamera` وتنفيذ كلا المستمعَين، استدعِ `prepareCamera` مع تمرير إعداد SDK (كائن `UnicoConfig` الذي تم إنشاؤه في [التهيئة](/developers/sdks-and-tools/android/initialization)) و`SelfieCameraListener`:

  - `onCameraReady` — الكاميرا جاهزة؛ استدعِ `open` مع تمرير `selfieListener` من الخطوة 2.
  - `onCameraFailed` — فشل تجهيز الكاميرا؛ تعامل مع رسالة الخطأ.

  ### Kotlin

    ```kotlin
    unicoCheckCamera
      .prepareCamera(UnicoConfig(), object : SelfieCameraListener {
        override fun onCameraReady(cameraOpener: UnicoCheckCameraOpener.Selfie?) {
          cameraOpener?.open(selfieListener)
        }
        override fun onCameraFailed(message: String?) { }
      })
    ```

### Java

    ```java
    unicoCheckCamera
      .prepareCamera(new UnicoConfig(), new SelfieCameraListener() {
        @Override
        public void onCameraReady(UnicoCheckCameraOpener.Selfie cameraOpener) {
          cameraOpener.open(selfieListener);
        }

        @Override
        public void onCameraFailed(String message) { }
      });
    ```

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