---
title: الالتقاط على iOS
description: شغّل التقاط تدفق Journey في تطبيق iOS باستخدام ASWebAuthenticationSession، عبر الرابط الذي يعيده إنشاء Human Plugin.
canonical: https://developer.unico.io/ar/human-plugin/integrations/ios
locale: ar
generated_by: markdown-export
---

# الالتقاط على iOS

افتح الالتقاط في جلسة متصفح النظام وأعد الشخص إلى تطبيقك.

تنشئ الواجهة الخلفية لديك العملية في Human Plugin بتدفق Journey و`callbackUri` يستخدم مخطط URL الخاص بتطبيقك. يفتح التطبيق `link` من الاستجابة في `ASWebAuthenticationSession`. عند انتهاء الالتقاط، تعود الجلسة إلى التطبيق عبر مخططك.

احتفظ بـ `id` الخاص بـ Human Plugin من استجابة الإنشاء. ستقرأ الواجهة الخلفية لديك النتيجة به.

## المتطلبات الأساسية

- iOS 13 أو أحدث
- Xcode 14 أو أحدث
- إطار العمل `AuthenticationServices` (مدمج)
- مخطط URL فريد لتطبيقك، مثل `myapp`

## 1. أنشئ العملية بمخططك

ترسل الواجهة الخلفية لديك المخطط بوصفه `callbackUri`:

```json
{
  "flow": "humantoken",
  "clientId": "client-a",
  "correlationId": "order-1001",
  "credential": { "type": "DUI_TYPE_NG_BVN", "value": "<document number>" },
  "callbackUri": "myapp://callback"
}
```

وتعيد `id` و`link` إلى التطبيق.

## 2. أنشئ مزوّد سياق العرض

```swift
import AuthenticationServices
import UIKit

class CaptureContextProvider: NSObject, ASWebAuthenticationPresentationContextProviding {
    func presentationAnchor(for session: ASWebAuthenticationSession) -> ASPresentationAnchor {
        guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
              let window = windowScene.windows.first else {
            return ASPresentationAnchor()
        }
        return window
    }
}
```

## 3. أنشئ مدير الجلسة

```swift
import AuthenticationServices

class CaptureSessionManager {
    static let shared = CaptureSessionManager()
    private var session: ASWebAuthenticationSession?
    private let contextProvider = CaptureContextProvider()

    /// يستدعي completion بالقيمة true عند انتهاء الالتقاط، وfalse عند إغلاق الشخص له.
    func start(link: URL, completion: @escaping (Bool) -> Void) {
        let newSession = ASWebAuthenticationSession(
            url: link,
            callbackURLScheme: "myapp"
        ) { callbackURL, _ in
            self.session = nil
            completion(callbackURL != nil)
        }
        newSession.presentationContextProvider = contextProvider
        newSession.prefersEphemeralWebBrowserSession = true
        newSession.start()
        session = newSession
    }
}
```

> **معلومة:** يقبل `callbackURLScheme` اسم المخطط فقط (`myapp`)، دون `://`.

## 4. ابدأ الالتقاط

```swift
guard let url = URL(string: link) else { return }

CaptureSessionManager.shared.start(link: url) { ended in
    if ended {
        // انتهى الالتقاط. اطلب من الواجهة الخلفية لديك قراءة النتيجة
        // عبر GET /v1/processes/{id}، باستخدام id الخاص بـ Human Plugin.
    } else {
        // أغلق الشخص الجلسة.
    }
}
```

## الملخص

| الملف | الغرض |
|---|---|
| `CaptureContextProvider.swift` | مزوّد سياق العرض |
| `CaptureSessionManager.swift` | دورة حياة `ASWebAuthenticationSession` |

```mermaid
sequenceDiagram
  participant A as Your app
  participant B as Your back-end
  participant H as Human Plugin
  participant S as Browser session
  A->>B: start the capture
  B->>H: POST /v1/processes (Journey flow, callbackUri myapp://callback)
  H-->>B: 201, id + link
  B-->>A: id + link
  A->>S: open link
  Note over S: capture
  S-->>A: myapp://callback
  A->>B: capture ended (id)
  B->>H: GET /v1/processes/{id}
  H-->>B: 200, final state
```