エラーハンドリング

Android SDKのすべてのエラーハンドリングはこのセクションに集約されています。onErrorAcessoBio コールバックは code と description を持つ ErrorBio オブジェクトを受け取ります。

エラーコード

コード	カテゴリ	デフォルトメッセージ	発生タイミング	推奨される対応
AUTH_FAILED	認証	SDK authentication failed	無効または期限切れのSDKキー	Onboardingチームで資格情報を確認する
CAMERA_PERMISSION_DENIED	権限	Camera permission denied	ユーザーがカメラ権限を拒否した	ユーザーをアプリ設定へ誘導する
LIVENESS_FAILED	キャプチャー	Liveness check failed	画像が生体検知バリデーションを通過しなかった	再キャプチャーを要求する
NETWORK_ERROR	ネットワーク	Network error during capture	接続が不十分	再接続を要求する
SDK_NOT_INITIALIZED	ライフサイクル	SDK not initialized	初期化前にキャプチャーが呼び出された	Application/onCreateで初期化が呼ばれていることを確認する

SDKエラーコード

上記のコードは主要なSDKコールバックエラーを網羅しています。REST APIエラーコード（HTTPステータスファミリー）はAPIリファレンス > エラーコードに別途記載されています。

コールバックの処理

Kotlin

override fun onErrorAcessoBio(error: ErrorBio) {
  when (error.code) {
    "AUTH_FAILED" -> { /* handle authentication failure */ }
    "CAMERA_PERMISSION_DENIED" -> { /* redirect to app settings */ }
    "LIVENESS_FAILED" -> { /* prompt the user to try again */ }
    else -> { /* generic error handling */ }
  }
}

Java

@Override
public void onErrorAcessoBio(ErrorBio error) {
  switch (error.getCode()) {
    case "AUTH_FAILED": /* handle authentication failure */ break;
    case "CAMERA_PERMISSION_DENIED": /* redirect to app settings */ break;
    case "LIVENESS_FAILED": /* prompt the user to try again */ break;
    default: /* generic error handling */
  }
}

ライフサイクルコールバック

onErrorAcessoBio に加えて、SDKは以下もトリガーします。

• onUserClosedCameraManually() — ユーザーが手動でカメラを閉じた。
• onSystemClosedCameraTimeoutSession() — タイムアウトによりセッションが終了した。
• onSystemChangedTypeCameraTimeoutFaceInference() — 13秒間顔が検出されなかった場合、SDKが手動キャプチャーに切り替わります。