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

- [/ja/](/ja/)
- [SDK とツール](/ja/developers/sdks-and-tools/overview)
- [iOS SDK](/ja/developers/sdks-and-tools/ios/requirements)
- キャプチャフロー
- ユーザージャーニー

# ユーザージャーニー

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

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

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

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

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

ユーザージャーニーの開始
**ステップ 1** — `AcessoBioManagerDelegate` を実装する`AcessoBioManagerDelegate` は SDK のライフサイクルコールバックを処理します。4 つの必須メソッドを実装してください：

| メソッド | 呼び出しタイミング |
| --- | --- |
| `onErrorAcessoBioManager(error)` | SDK 操作中にエラーが発生した場合 |
| `onUserClosedCameraManually()` | ユーザーが手動でカメラを閉じた場合 |
| `onSystemClosedCameraTimeoutSession()` | 40 秒のセッション制限に達した場合 |
| `onSystemChangedTypeCameraTimeoutFaceInference()` | 13 秒間顔が検出されなかった場合 — 手動キャプチャに切り替わります |

- Swift
- Objective-C

```
class ViewController: UIViewController, AcessoBioManagerDelegate {**  var unicoCheck: AcessoBioManager!  override func viewDidLoad() {    super.viewDidLoad()    unicoCheck = AcessoBioManager(viewController: self)  }  func onErrorAcessoBioManager(_ error: ErrorBio!) { }  func onUserClosedCameraManually() { }  func onSystemClosedCameraTimeoutSession() { }  func onSystemChangedTypeCameraTimeoutFaceInference() { }}
```

```
@implementation ViewController: UIViewController- (void)viewDidLoad {    [super viewDidLoad];    unicoCheck = [[AcessoBioManager alloc]initWithViewController:self];}- (void)onErrorAcessoBioManager:(ErrorBio *)error { }- (void)onSystemChangedTypeCameraTimeoutFaceInference { }- (void)onSystemClosedCameraTimeoutSession { }- (void)onUserClosedCameraManually { }@end
```

必須デリゲートメソッド上記の 4 つのデリゲートメソッドは、ロジックがなくてもプロジェクトに作成する必要があります。作成しない場合、プロジェクトは正常にコンパイルされません。
**ステップ 2** — `AcessoBioSelfieDelegate` を実装するジャーニーのキャプチャー結果コールバックを処理するためにメソッドをオーバーライドします:メソッド説明`onSuccessSelfie(result)`画像のキャプチャーに成功 — 後続のREST API呼び出し用の `SelfieResult` を返す`onSuccess(result)`ジャーニーが正常に完了しました — バリデーション結果の照会に使用する `processId` を返す`onErrorSelfie(errorBio)`キャプチャー失敗 — エラー詳細を含む `ErrorBio` を返すSwiftObjective-C```
class ViewController: UIViewController, AcessoBioManagerDelegate,  SelfieCameraDelegate, AcessoBioSelfieDelegate {  func onSuccessSelfie(_ result: SelfieResult!) { }  func onSuccess(_ result: SuccessResult!) { }  func onErrorSelfie(_ errorBio: ErrorBio!) { }}
```

```
@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` を渡してカメラを開きます:webAppToken`webAppToken` は、バックエンドでプロセスを作成する際に `POST /client/v1/process` から返される `process.webAppToken` フィールドです。プロセスの作成を参照してく ださい。
`onCameraReady(cameraOpener)` — カメラの準備完了。`open(self, webAppToken:)` を呼び出します。
`onCameraFailed(message)` — カメラの準備に失敗（`ErrorPrepare` は `ErrorBio` の拡張です）。
SwiftObjective-C```
@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!) { }
```

```
- (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 { }
```

完全な結果処理については、[結果の受信](/ja/developers/sdks-and-tools/ios/capture-flow/receiving-the-result)を参照してください。最終更新 2026年10月8日**に