--- title: ユーザージャーニー canonical: https://developer.unico.io/ja/developers/sdks-and-tools/android/capture-flow/user-journeys locale: ja generated_by: markdown-export --- - [/ja/](/ja/) - [SDK とツール](/ja/developers/sdks-and-tools/overview) - [Android SDK](/ja/developers/sdks-and-tools/android/requirements) - キャプチャフロー - ユーザージャーニー # ユーザージャーニー ユーザージャーニーは、SDKが設定されたフローと連携して実行するマルチステップのキャプチャーセッションです。たとえば、ライブネス + リスクスコア + Document Capture + Electronic Signature を含むフローは、1つのセッションでセルフィー、書類のキャプチャー、署名を実行します。 製品利用可能なジャーニーは、インテグレーションに設定されたフローによって異なります。製品 → フロー → 機能の完全なマッピングについては、[製品](/ja/products)を参照してください。 仕組み SDKは以下の処理を行います。 1. 初期化時に提供されたフロー設定を読み取ります。 2. フローに必要なキャプチャーのシーケンス（セルフィー、書類、署名）を調整します。 3. ジャーニーが完了すると、`onSuccess` を通じて `processId` が返されます。セルフィーステップでは、`onSuccessSelfie` を通じて画像データ（`base64` / `encrypted`）も返されます。ドキュメントと署名のキャプチャはSDKが内部的に処理します — ステップごとのアーティファクトはクライアントに公開されません。 オーケストレーションはSDKが完全に処理します — アプリ側でステップシーケンスを実装する必要はありません。 ユーザージャーニーの開始 **ステップ 1** — `AcessoBioListener` を実装する`AcessoBioListener` は SDK ライフサイクルコールバックを処理します。4 つの必須メソッドを実装してください: | メソッド | 呼び出されるタイミング | | --- | --- | | `onErrorAcessoBio(errorBio)` | SDK 操作中にエラーが発生した | | `onUserClosedCameraManually()` | ユーザーが手動でカメラを閉じた | | `onSystemClosedCameraTimeoutSession()` | セッションの制限時間に達した — [セッション制限](/ja/developers/sdks-and-tools/android/requirements#session-limits)を参照 | | `onSystemChangedTypeCameraTimeoutFaceInference()` | 顔推論の制限時間に達した — 手動キャプチャに切り替わる — [セッション制限](/ja/developers/sdks-and-tools/android/requirements#session-limits)を参照 | - Kotlin - Java ``` val callback = object : AcessoBioListener {** override fun onErrorAcessoBio(errorBio: ErrorBio?) { } override fun onUserClosedCameraManually() { } override fun onSystemClosedCameraTimeoutSession() { } override fun onSystemChangedTypeCameraTimeoutFaceInference() { }} ``` ``` AcessoBioListener callback = new AcessoBioListener() { @Override public void onErrorAcessoBio(ErrorBio errorBio) { } @Override public void onUserClosedCameraManually() { } @Override public void onSystemClosedCameraTimeoutSession() { } @Override public void onSystemChangedTypeCameraTimeoutFaceInference() { }}; ``` **ステップ2** — `iAcessoBioSelfie` の実装`iAcessoBioSelfie` はジャーニーキャプチャーの結果コールバックを処理します。メソッド説明`onSuccessSelfie(result)`画像のキャプチャーに成功 — 後続のREST API呼び出し用の `ResultCamera` を返す`onSuccess(result)`ジャーニーが正常に完了しました — バリデーション結果の照会に使用する `processId` を含む `SuccessResult` を返す`onErrorSelfie(errorBio)`キャプチャー失敗 — エラー詳細を含む `ErrorBio` を返すKotlinJava``` val cameraListener: iAcessoBioSelfie = object : iAcessoBioSelfie { override fun onSuccessSelfie(result: ResultCamera?) { } override fun onSuccess(result: SuccessResult) { } override fun onErrorSelfie(errorBio: ErrorBio?) { }} ``` ``` 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` を呼び出します。webAppToken`webAppToken` は、バックエンドでプロセスを作成する際に `POST /client/v1/process` から返される `process.webAppToken` フィールドです。プロセスの作成を参照してください。 `onCameraReady` — カメラの準備完了。`cameraListener` と `webAppToken` を渡して `open` を呼び出します。 `onCameraFailed` — カメラの準備に失敗。エラーメッセージを処理します。 KotlinJava``` 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) }}) ``` ``` 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); }}); ``` 完全な結果処理については、[結果の受信](/ja/developers/sdks-and-tools/android/capture-flow/receiving-the-result)を参照してください。最終更新 2026年10月8日**に