---
title: ユーザージャーニー
canonical: https://developer.unico.io/ja/dual-api/developers/sdks-and-tools/ios/capture-flow/capture-types/user-journeys
locale: ja
generated_by: markdown-export
---

ユーザージャーニーは、SDKが設定されたフローと連携して実行するマルチステップのキャプチャーセッションです。たとえば、ライブネス + リスクスコア + Document Capture + Electronic Signature を含むフローは、1つのセッションでセルフィー、書類のキャプチャー、署名を実行します。

:::secondary[製品]
利用可能なジャーニーは、インテグレーションに設定されたフローによって異なります。製品 → フロー → 機能の完全なマッピングについては、[製品](/products)を参照してください。
:::

## 仕組み

SDKは以下の処理を行います。

1. 初期化時に提供されたフロー設定を読み取ります。
2. フローに必要なキャプチャーのシーケンス（セルフィー、書類、署名）を調整します。
3. ジャーニーが完了すると、`onSuccess` を通じて `processId` が返されます。セルフィーステップでは、`onSuccessSelfie` を通じて画像データ（`base64` / `encrypted`）も返されます。ドキュメントと署名のキャプチャはSDKが内部的に処理します — ステップごとのアーティファクトはクライアントに公開されません。

オーケストレーションはSDKが完全に処理します — アプリ側でステップシーケンスを実装する必要はありません。

## ユーザージャーニーの開始

****ステップ 2** — `AcessoBioSelfieDelegate` を実装する**

ジャーニーのキャプチャー結果コールバックを処理するためにメソッドをオーバーライドします:

  | メソッド | 説明 |
  |---|---|
  | `onSuccessSelfie(result)` | 画像のキャプチャーに成功 — 後続のREST API呼び出し用の `SelfieResult` を返す |
  | `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` を呼び出す**

SDK設定を渡して `prepareSelfieCamera` を呼び出します。カメラの準備ができると `onCameraReady` イベントが発生します — `open()` メソッドで `webAppToken` を渡してカメラを開きます:

  :::info[webAppToken]
  `webAppToken` は、バックエンドでプロセスを作成する際に `POST /client/v1/process` から返される `process.webAppToken` フィールドです。[プロセスの作成](/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)を参照してください。