---
title: エラーハンドリング
canonical: https://developer.unico.io/ja/dual-api/developers/sdks-and-tools/ios/error-handling
locale: ja
generated_by: markdown-export
---

iOS SDK のすべてのエラーハンドリングはこのセクションに集約されています。`onErrorAcessoBioManager` コールバックは、`getCode()` と `getDescription()` を公開する `ErrorBio` オブジェクトを受け取ります。

## エラーコード

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

:::secondary[公式エラーカタログ]
上記のコードは iOS SDK カタログを反映しています。クロスプラットフォームの公式エラーコードカタログは [API リファレンス > エラーコード](/dual-api/developers/api-reference/error-codes) で確認できます。
:::

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

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

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

:::info[キャンセルとタイムアウトのコールバックルーティング]
エラー `73704`（ユーザーがキャンセル）と `73710`（セッションタイムアウト）は `onErrorAcessoBioManager` を通じて配信**されません**。対応するライフサイクルコールバックを直接トリガーします：
- `73704` → `onUserClosedCameraManually()`
- `73710` → `onSystemClosedCameraTimeoutSession()`
:::