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

エラーハンドリング

Markdown

iOS SDK のすべてのエラーハンドリングはこのセクションに集約されています。エラーは code（Int）と desc（String）プロパティを公開する ErrorBio オブジェクトとして渡されます。キャプチャーおよびジャーニーのエラー（74001 を含む）は onErrorSelfie に、設定および初期化のエラーは onErrorAcessoBioManager に届きます。

エラーコード
コード説明
73000未知の予期しないエラーによりセッションがキャンセルされました。Unico Check SDK はカメラ、ストレージ、セキュリティ、ネットワークなど様々な iOS API を利用しており、これはすべてをキャッチするエラーです。
73001コンテキストが無効です
73003API バージョンは 13 以上である必要があります
73006エミュレーター上でのカメラ起動はできません
73100インターネットに接続できません
73200unico_sdk JSON ファイルが見つかりません
73202unico_sdk JSON ファイルを読み込めません
73203AcessoBioConfigDataSource を読み込めません
73204SDK を初期化できません — ビルド時に setEnvironment で環境を設定してください
73300unico 認証オブジェクトを取得できません
73301unico 認証オブジェクトを解析できません
73302unico トークンが見つかりません
73701アクティブ liveness のインポートが見つかりません
73702本番環境でアクティブ liveness を初期化できません
73703アクティブ liveness セッションを取得できません
73704ユーザーがキャンセルボタンを押し、セッションを完了しませんでした
73705セッションが正常に完了せず、FaceScan が生成されませんでした
73706カメラアクセスが拒否されました — ユーザーが明示的に許可を拒否したか、デバイスポリシーによってブロックされています
73707アプリの終了、スリープ、OS 通知、またはバックグラウンドへの移行によりセッションがキャンセルされました
73708デバイスが横向き（ランドスケープ）モードのためセッションがキャンセルされました
73709デバイスが逆向き縦向き（リバースポートレート）モードのためセッションがキャンセルされました
73710制限時間内にセッションを完了できなかったためキャンセルされました
73711メモリ不足によりセッションがキャンセルされました
73712アプリが本番環境でなく、ネットワーク接続が必要なためセッションがキャンセルされました
73713キーの再検証が必要なためセッションがキャンセルされました
73714開発者が設定した暗号化キーが無効なためセッションがキャンセルされました
73715すべてのガイダンス画像が設定されていないためセッションがキャンセルされました
73716このデバイスで SDK がカメラを起動できなかったためセッションがキャンセルされました
73717ユーザーがロックアウト状態にあるためセッションがキャンセルされました
73718iOS API の通常使用中に未知の予期しないエラーが発生しました
73719ユーザーが準備画面のサブテキストメッセージを押したためセッションがキャンセルされました
73720セッションが処理されませんでした
73721セッションを実行できません: 試行回数の上限を超えました
73722セッションを実行できません: 顔の位置合わせがタイムアウトしました
73730アクティブ liveness セッションを初期化できません — ライセンスエラー（不明）
73731アクティブ liveness セッションを初期化できません — ライセンスの有効期限が切れています
73800暗号化キーを構築できません
74001webAppToken でカメラを開く際に onSuccess コールバックが実装されていません
公式エラーカタログ

上記のコードは iOS SDK カタログを反映しています。クロスプラットフォームの公式エラーコードカタログは API リファレンス > エラーコード で確認できます。

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

onErrorAcessoBioManager に加え、SDK は以下もトリガーします:

  • onUserClosedCameraManually() — ユーザーが手動でカメラを閉じました。
  • onSystemClosedCameraTimeoutSession() — タイムアウトによりセッションが終了しました（デフォルト 40 秒、最小 40 秒）。
  • onSystemChangedTypeCameraTimeoutFaceInference() — 顔の検出が 13 秒の閾値を超えました。キャプチャーが手動モードに切り替わります。
キャンセルとタイムアウトのコールバックルーティング

エラー 73704（ユーザーがキャンセル）と 73710（セッションタイムアウト）は onErrorAcessoBioManager を通じて配信されません。対応するライフサイクルコールバックを直接トリガーします：

  • 73704 → onUserClosedCameraManually()
  • 73710 → onSystemClosedCameraTimeoutSession()
最終更新 に