--- title: エラーハンドリング canonical: https://developer.unico.io/ja/developers/sdks-and-tools/android/error-handling locale: ja generated_by: markdown-export --- - [/ja/](/ja/) - [SDK とツール](/ja/developers/sdks-and-tools/overview) - [Android SDK](/ja/developers/sdks-and-tools/android/requirements) - エラーハンドリング # エラーハンドリング Android SDK のすべてのエラーハンドリングはこのセクションに集約されています。`onErrorAcessoBio` コールバックは `code` (Int) と `description` (String) を持つ `ErrorBio` オブジェクトを受け取ります。 コールバックの処理 - Kotlin - Java ``` 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 */ } }} ``` ``` @Overridepublic void onErrorAcessoBio(ErrorBio error) { switch (error.getCode()) { case 73002: /* camera permission denied — redirect to app settings */ break; case 73006: /* running on emulator — physical device required */ break; case 73100: /* no internet connection */ break; default: /* generic error handling */ }} ``` ライフサイクルコールバック `onErrorAcessoBio` に加えて、SDK は以下もトリガーします： `onUserClosedCameraManually()` — ユーザーが手動でカメラを閉じた。 `onSystemClosedCameraTimeoutSession()` — タイムアウトによりセッションが終了した。 `onSystemChangedTypeCameraTimeoutFaceInference()` — 13 秒間顔が検出されなかった場合、SDK が手動キャプチャーに切り替わります。 エラーコード すべてのエラーコードは `UnicoException` enum から発生し、`ErrorBio(code, message)` を通じて渡されます。`message` フィールドには SDK の正確な文字列が含まれます — 変更したりローカライズしたりしないでください。 コードメッセージ説明`73001``Context invalid`SDK に渡された Android コンテキストが無効`73002``Did not grant permission to open camera`ユーザーがカメラの権限を拒否した`73003``The lest API is 21(LOLLIPOP`デバイスの API レベルが最小要件 (API 21) 未満`73004``Could not find implementation interface callback iAcessoBioSelfie``iAcessoBioSelfie` インターフェースが実装されていない`73005``Could not find implementation interface callback iAcessoBioDocument``iAcessoBioDocument` インターフェースが実装されていない`73006``Unable to open camera on emulators`SDK はエミュレーターで動作しません — 実機を使用してください`73007``Unknown and unexpected error in WebApp…`WebApp の一般的なエラー（カメラ、ストレージ、セキュリティ、ネットワーク）`73100``Unable to connect to internet.`インターネット接続がありません`73200``Please inform the config object or json file name`設定オブジェクトまたは JSON ファイルが指定されていない`73202``Unable to parse json file`JSON 設定ファイルが破損しています`73204``Unable to initialize the SDK, please configure the environment on setEnviroment method of build`初期化前に `setEnvironment()` が呼び出されていない`73300``Unable to get unico authentication object`認証オブジェクトの取得に失敗`73301``Unable to parse object`認証レスポンスの解析に失敗`73302``Could not find the unico token`Unico 認証トークンが見つからない`73303``Current host is not registered`バンドル識別子が SDK Key に登録されていない`73400``Could not initialize camera`カメラの初期化に失敗`73701``Could not find active liveness import`アクティブライブネスモジュールが見つからない`73703``Unable to get active liveness session`ライブネスセッションの取得に失敗`73718``The Session was cancelled because of an unknown and unexpected error…`不明な内部セッションエラー`73721``The Session can't be performed: attempts limit exceeded.`セッションがキャンセルされた — キャプチャ試行回数の上限を超えました`73722``The Session can't be performed: face alignment timeout.`セッションがキャンセルされた — 顔の位置合わせがタイムアウトしました`73726``An error happened during video recording`ライブネス中の動画録画エラー`73727``No actions found in a video`動画でライブネスアクションが検出されなかった`73740``The user pressed the do not consent button and did not complete the Session.`ユーザーが同意を拒否した`73800``Could not build encrypted key.`暗号化 JWT の構築に失敗`73801``The Session of SDK was cancelled because of an unknown and unexpected error.`不明な内部 SDK セッションエラー`73802``The Session was cancelled because of an unknown and unexpected error…`セッションがキャンセルされた — 必須 JWT フィールドが欠如`73900``Erro ao analisar imagem`キャプチャ画像の解析中にエラーが発生した`73901``É necessário implementar a interface AcessoBioListener``AcessoBioListener` インターフェースが実装されていない`73902``É necessário insirir um valor maior que 40 segundos no método: setTimeoutSession.``setTimeoutSession` の値は 40 秒より大きくなければならない`73903``Arquivo de configuração corrompido. Verifique o arquivo json e tente novamente.`設定ファイルが破損しています — 確認して再試行してください`73904``Erro ao finalizar processo`キャプチャプロセスの完了中にエラーが発生した`73905``Unable to open document camera`ドキュメントカメラを開けなかった`73906``Document type uninformed`ドキュメントタイプが指定されていない`74001``onSuccess: not implemented when using open:webAppToken:`ユーザージャーニー用の `onSuccess` コールバックが実装されていない`74100``Could not prepare SDK-S`SDK コンポーネントの準備に失敗`74101``No URL token was provided.`ジャーニー用の URL トークンが指定されていない`74102``Environment type was not specified.`Environment (`PROD`/`UAT`) が設定されていない`737120``Unable to initialize liveness`ライブネスアクティビティを初期化できなかった`737220``Capture could not start`キャプチャプロセスを開始できなかった`737320``Transaction could not start`トランザクションを開始できなかった`737321``The 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 リファレンス > エラーコード](/ja/developers/start/error-codes) に別途記載されています。最終更新 2026年10月8日**に