メインコンテンツへスキップ

ユーザージャーニー

Markdown

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

製品

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

仕組み

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

  1. 初期化時に提供されたフロー設定を読み取ります。
  2. フローに必要なキャプチャーのシーケンス(セルフィー、書類、署名)を調整します。
  3. ジャーニーが完了すると、onSuccess を通じて processId が返されます。

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

ユーザージャーニーの開始
ステップ 1 — AcessoBioManagerDelegate を実装する

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

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

上記の 4 つのデリゲートメソッドは、ロジックがなくてもプロジェクトに作成する必要があります。作成しない場合、プロジェクトは正常にコンパイルされません。

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

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

メソッド説明
onSuccessSelfie(result)デリゲートインターフェースに必須。Unico API インテグレーションでは使用されません
onSuccess(result)Unico API インテグレーションでは必須です。ジャーニーが正常に完了しました — バリデーション結果の照会に使用する processId を返す
onErrorSelfie(errorBio)キャプチャー失敗 — エラー詳細を含む ErrorBio を返す
class ViewController: UIViewController, AcessoBioManagerDelegate,
SelfieCameraDelegate, AcessoBioSelfieDelegate {

func onSuccessSelfie(_ result: SelfieResult!) { }
func onSuccess(_ result: SuccessResult!) { }
func onErrorSelfie(_ errorBio: ErrorBio!) { }
}
onSuccess は必須です

カメラは webAppToken を使って開かれるため、SDK は onSuccess を必要とします。これがないと、エラー 74001 で失敗します。AcessoBioSelfieDelegate は onSuccess を optional として宣言しているため、コンパイラはこれをチェックせず、上記の例と一致しないシグネチャもコンパイルが通り、同様に失敗します。シグネチャは上記の通り正確にコピーしてください。

ステップ 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 の拡張です)。
@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!) { }

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