ライブネス（生体認証セルフィー）

ライブネス検証が組み込まれた生体認証セルフィーキャプチャ。SDK は SmartFrames を通じて生体認証上有効なフレームが取得されるまでユーザーをガイドし、画像を Base64 + JWT として返します。

機能

このキャプチャタイプは Liveness 機能を使用します。Liveness の動作に関する概念的な概要については、Liveness 機能のページを参照してください。

動作の仕組み

SDK はキャプチャセッション全体を管理します:

1. SmartFrame オーバーレイ付きでカメラを開きます。
2. ユーザーがフレーム内に顔を配置するようにガイドします。
3. ライブネスを検証します — ユーザーが実際に存在する場合にのみセッションが完了します。
4. base64 と encrypted（JWT）を含む ResultCamera オブジェクトを返します。

ライブネスキャプチャの開始

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

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

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

Kotlin

val callback = object : AcessoBioListener {
  override fun onErrorAcessoBio(errorBio: ErrorBio?) { }
  override fun onUserClosedCameraManually() { }
  override fun onSystemClosedCameraTimeoutSession() { }
  override fun onSystemChangedTypeCameraTimeoutFaceInference() { }
}

Java

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)	キャプチャ成功 — base64（プレビュー）と encrypted（API 用 JWT）を含む ResultCamera を返します
onErrorSelfie(errorBio)	キャプチャ失敗 — コードと説明を含む ErrorBio を返します

トークンの有効期限

encrypted を生成してから API に送信するまでの間隔は 10 分 を超えてはなりません。

Kotlin

val selfieListener = object : iAcessoBioSelfie {
  override fun onSuccessSelfie(result: ResultCamera?) { }
  override fun onErrorSelfie(errorBio: ErrorBio?) { }
}

Java

iAcessoBioSelfie selfieListener = new iAcessoBioSelfie() {
  @Override
  public void onSuccessSelfie(ResultCamera result) { }

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

ステップ 3 — prepareCamera を呼び出す

unicoCheckCamera を初期化し、両方のリスナーを実装した後、SDK 設定と SelfieCameraListener を渡して prepareCamera を呼び出します:

• onCameraReady — カメラの準備完了。ステップ 2 の selfieListener を渡して open を呼び出します。
• onCameraFailed — カメラの準備に失敗。エラーメッセージを処理してください。

Kotlin

unicoCheckCamera
  .prepareCamera(UnicoConfig(), object : SelfieCameraListener {
    override fun onCameraReady(cameraOpener: UnicoCheckCameraOpener.Selfie?) {
      cameraOpener?.open(selfieListener)
    }
    override fun onCameraFailed(message: String?) { }
  })

Java

unicoCheckCamera
  .prepareCamera(new UnicoConfig(), new SelfieCameraListener() {
    @Override
    public void onCameraReady(UnicoCheckCameraOpener.Selfie cameraOpener) {
      cameraOpener.open(selfieListener);
    }

    @Override
    public void onCameraFailed(String message) { }
  });

結果の完全な処理方法については、結果の受け取りを参照してください。