ユーザージャーニー

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

製品

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

仕組み

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

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

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

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

ステップ 1 — AcessoBioListener を実装する

AcessoBioListener は SDK ライフサイクルコールバックを処理します。4 つの必須メソッドを実装してください:

メソッド	呼び出されるタイミング
`onErrorAcessoBio(errorBio)`	SDK 操作中にエラーが発生した
`onUserClosedCameraManually()`	ユーザーが手動でカメラを閉じた
`onSystemClosedCameraTimeoutSession()`	セッションの制限時間に達した — セッション制限を参照
`onSystemChangedTypeCameraTimeoutFaceInference()`	顔推論の制限時間に達した — 手動キャプチャに切り替わる — セッション制限を参照

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` を返す

Kotlin
Java

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 — カメラの準備に失敗。エラーメッセージを処理します。

Kotlin
Java

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);
  }
});

完全な結果処理については、結果の受信を参照してください。