---
title: ユーザージャーニー
canonical: https://developer.unico.io/ja/dual-api/developers/sdks-and-tools/android/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** — `iAcessoBioSelfie` の実装**

`iAcessoBioSelfie` はジャーニーキャプチャーの結果コールバックを処理します。

  | メソッド | 説明 |
  |---|---|
  | `onSuccessSelfie(result)` | 画像のキャプチャーに成功 — 後続のREST API呼び出し用の `ResultCamera` を返す |
  | `onSuccess(result)` | ジャーニーが正常に完了しました — バリデーション結果の照会に使用する `processId` を含む `SuccessResult` を返す |
  | `onErrorSelfie(errorBio)` | キャプチャー失敗 — エラー詳細を含む `ErrorBio` を返す |

  ### Kotlin

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

### Java

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

      @Override
      public void onSuccess(SuccessResult result) { }

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

****ステップ3** — `prepareCamera` の呼び出し**

`unicoCheckCamera` が初期化され、両方のリスナーが実装されたら、SDKの設定、`CameraListener`、および `webAppToken` を渡して `prepareCamera` を呼び出します。

  :::note[webAppToken]
  `webAppToken` は、バックエンドでプロセスを作成する際に `POST /client/v1/process` から返される `process.webAppToken` フィールドです。[プロセスの作成](/dual-api/developers/api-reference/web-sdk/post-process)を参照してください。
  :::

  - `onCameraReady` — カメラの準備完了。`cameraListener` と `webAppToken` を渡して `open` を呼び出します。
  - `onCameraFailed` — カメラの準備に失敗。エラーメッセージを処理します。

  ### Kotlin

    ```kotlin
    unicoCheckCamera.prepareCamera(unicoConfig, object : CameraListener {
      override fun onCameraReady(cameraOpener: UnicoCheckCameraOpener.Camera?) {
        cameraOpener?.open(cameraListener, "your_web_app_token")
      }

      override fun onCameraFailed(message: String?) {
        Log.e(TAG, message)
      }
    })
    ```

### Java

    ```java
    unicoCheckCamera.prepareCamera(unicoConfig, new CameraListener() {
      @Override
      public void onCameraReady(UnicoCheckCameraOpener.Camera cameraOpener) {
        cameraOpener.open(cameraListener, "your_web_app_token");
      }

      @Override
      public void onCameraFailed(String message) {
        Log.e(TAG, message);
      }
    });
    ```

完全な結果処理については、[結果の受信](/developers/sdks-and-tools/android/capture-flow/receiving-the-result)を参照してください。