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

エラーハンドリング

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

コールバックの処理
override fun onErrorAcessoBio(error: ErrorBio) {
  when (error.code) {
    73002 -> { /* camera permission denied — redirect to app settings */ }
    73006 -> { /* running on emulator — physical device required */ }
    73100 -> { /* no internet connection */ }
    else -> { /* generic error handling */ }
  }
}
ライフサイクルコールバック

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

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

すべてのエラーコードは UnicoException enum から発生し、ErrorBio(code, message) を通じて渡されます。message フィールドには SDK の正確な文字列が含まれます — 変更したりローカライズしたりしないでください。

コードメッセージ説明
73001Context invalidSDK に渡された Android コンテキストが無効
73002Did not grant permission to open cameraユーザーがカメラの権限を拒否した
73003The lest API is 21(LOLLIPOPデバイスの API レベルが最小要件 (API 21) 未満
73004Could not find implementation interface callback iAcessoBioSelfieiAcessoBioSelfie インターフェースが実装されていない
73005Could not find implementation interface callback iAcessoBioDocumentiAcessoBioDocument インターフェースが実装されていない
73006Unable to open camera on emulatorsSDK はエミュレーターで動作しません — 実機を使用してください
73007Unknown and unexpected error in WebApp…WebApp の一般的なエラー（カメラ、ストレージ、セキュリティ、ネットワーク）
73100Unable to connect to internet.インターネット接続がありません
73200Please inform the config object or json file name設定オブジェクトまたは JSON ファイルが指定されていない
73202Unable to parse json fileJSON 設定ファイルが破損しています
73204Unable to initialize the SDK, please configure the environment on setEnviroment method of build初期化前に setEnvironment() が呼び出されていない
73300Unable to get unico authentication object認証オブジェクトの取得に失敗
73301Unable to parse object認証レスポンスの解析に失敗
73302Could not find the unico tokenUnico 認証トークンが見つからない
73303Current host is not registeredバンドル識別子が SDK Key に登録されていない
73400Could not initialize cameraカメラの初期化に失敗
73701Could not find active liveness importアクティブライブネスモジュールが見つからない
73703Unable to get active liveness sessionライブネスセッションの取得に失敗
73718The Session was cancelled because of an unknown and unexpected error…不明な内部セッションエラー
73721The Session can't be performed: attempts limit exceeded.セッションがキャンセルされた — キャプチャ試行回数の上限を超えました
73722The Session can't be performed: face alignment timeout.セッションがキャンセルされた — 顔の位置合わせがタイムアウトしました
73726An error happened during video recordingライブネス中の動画録画エラー
73727No actions found in a video動画でライブネスアクションが検出されなかった
73740The user pressed the do not consent button and did not complete the Session.ユーザーが同意を拒否した
73800Could not build encrypted key.暗号化 JWT の構築に失敗
73801The Session of SDK was cancelled because of an unknown and unexpected error.不明な内部 SDK セッションエラー
73802The Session was cancelled because of an unknown and unexpected error…セッションがキャンセルされた — 必須 JWT フィールドが欠如
73900Erro ao analisar imagemキャプチャ画像の解析中にエラーが発生した
73901É necessário implementar a interface AcessoBioListenerAcessoBioListener インターフェースが実装されていない
73902É necessário insirir um valor maior que 40 segundos no método: setTimeoutSession.setTimeoutSession の値は 40 秒より大きくなければならない
73903Arquivo de configuração corrompido. Verifique o arquivo json e tente novamente.設定ファイルが破損しています — 確認して再試行してください
73904Erro ao finalizar processoキャプチャプロセスの完了中にエラーが発生した
73905Unable to open document cameraドキュメントカメラを開けなかった
73906Document type uninformedドキュメントタイプが指定されていない
74001onSuccess: not implemented when using open:webAppToken:ユーザージャーニー用の onSuccess コールバックが実装されていない
74100Could not prepare SDK-SSDK コンポーネントの準備に失敗
74101No URL token was provided.ジャーニー用の URL トークンが指定されていない
74102Environment type was not specified.Environment (PROD/UAT) が設定されていない
737120Unable to initialize livenessライブネスアクティビティを初期化できなかった
737220Capture could not startキャプチャプロセスを開始できなかった
737320Transaction could not startトランザクションを開始できなかった
737321The Session was cancelled because of an unknown and unexpected error. This return value is a catch-all for errors experienced during normal usage of these APIs. Try again.セッションプロバイダーの一般的なエラー — 再試行してください
REST API エラーコード

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

最終更新 に