---
title: رحلات المستخدم
canonical: https://developer.unico.io/ar/dual-api/developers/sdks-and-tools/ios/capture-flow/capture-types/user-journeys
locale: ar
generated_by: markdown-export
---

رحلات المستخدم هي جلسات التقاط متعددة الخطوات يُنسِّقها SDK جنباً إلى جنب مع التدفق المُهيَّأ. على سبيل المثال، ينفِّذ تدفق يضم لايفنس + درجة المخاطر + التقاط الوثائق + التوقيع الإلكتروني كلاً من التقاط الصورة الشخصية والمستند والتوقيع في جلسة واحدة.

:::secondary[المنتجات]
تعتمد الرحلات المتاحة على التدفق المُهيَّأ لتكاملك. راجع [المنتجات](/products) للاطلاع على التعيين الكامل للمنتج ← التدفق ← القدرة.
:::

## آلية العمل

يقوم SDK بما يلي:

1. يقرأ إعداد التدفق المُقدَّم أثناء التهيئة.
2. يُنسِّق تسلسل عمليات الالتقاط المطلوبة للتدفق (صورة شخصية، مستند، توقيع).
3. يُرجع `processId` عبر `onSuccess` عند اكتمال الرحلة. بالنسبة لخطوة السيلفي، تُرجع بيانات الصورة (`base64` / `encrypted`) أيضاً عبر `onSuccessSelfie`. تتم معالجة التقاط المستندات والتوقيع داخلياً بواسطة الـ SDK — لا يتم كشف أي مصنوع لكل خطوة للعميل.

يتم التنسيق بالكامل من قِبَل SDK — لا تحتاج إلى تنفيذ تسلسل الخطوات في تطبيقك.

## بدء رحلة مستخدم

****الخطوة 2** — تطبيق `AcessoBioSelfieDelegate`**

تجاوز الدوال للتعامل مع callbacks نتيجة التقاط الرحلة:

  | الدالة | الوصف |
  |---|---|
  | `onSuccessSelfie(result)` | تم التقاط الصورة بنجاح — يُعيد `SelfieResult` لاستدعاءات REST API اللاحقة |
  | `onSuccess(result)` | اكتملت الرحلة بنجاح — يُعيد `processId` يُستخدم للاستعلام عن نتائج التحقق |
  | `onErrorSelfie(errorBio)` | فشل الالتقاط — يُعيد `ErrorBio` يحتوي على تفاصيل الخطأ |

  ### Swift

    ```swift
    class ViewController: UIViewController, AcessoBioManagerDelegate,
      SelfieCameraDelegate, AcessoBioSelfieDelegate {

      func onSuccessSelfie(_ result: SelfieResult!) { }
      func onSuccess(_ result: SuccessResult!) { }
      func onErrorSelfie(_ errorBio: ErrorBio!) { }
    }
    ```

### Objective-C

    ```objectivec
    @interface ViewController: UIViewController <AcessoBioManagerDelegate,
      SelfieCameraDelegate, AcessoBioSelfieDelegate>
    @end

    @implementation ViewController
    - (void)onSuccessSelfie:(SelfieResult *)result { }
    - (void)onSuccess:(SuccessResult *)result { }
    - (void)onErrorSelfie:(ErrorBio *)errorBio { }
    @end
    ```

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

استدعِ `prepareSelfieCamera` مع تمرير إعداد SDK. عندما تكون الكاميرا جاهزة، يتم تشغيل حدث `onCameraReady` — افتح الكاميرا من خلال دالة `open()`، مع تمرير `webAppToken`:

  :::info[webAppToken]
  الـ `webAppToken` هو الحقل `process.webAppToken` الذي يُعيده `POST /client/v1/process` عند إنشاء العملية في الخادم الخلفي. راجع [إنشاء عملية](/dual-api/developers/api-reference/web-sdk/post-process).
  :::

  - `onCameraReady(cameraOpener)` — الكاميرا جاهزة؛ استدعِ `open(self, webAppToken:)`.
  - `onCameraFailed(message)` — فشل تحضير الكاميرا (`ErrorPrepare` هو امتداد لـ `ErrorBio`).

  ### Swift

    ```swift
    @IBAction func openCamera(_ sender: Any) {
      unicoCheck.build().prepareSelfieCamera(self, config: YourUnicoConfigClass())
    }

    func onCameraReady(_ cameraOpener: AcessoBioCameraOpenerDelegate!) {
      cameraOpener.open(self, webAppToken: "your_web_app_token")
    }

    func onCameraFailed(_ message: ErrorPrepare!) { }
    ```

### Objective-C

    ```objectivec
    - (IBAction)openCamera:(UIButton *)sender {
        [[unicoCheck build] prepareSelfieCamera:self config:[YourUnicoConfigClass new]];
    }

    - (void)onCameraReady:(id)cameraOpener {
        [cameraOpener open:self webAppToken:@"your_web_app_token"];
    }

    - (void)onCameraFailed:(ErrorPrepare *)message { }
    ```

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