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

- [/ja/](/ja/)
- [SDK とツール](/ja/developers/sdks-and-tools/overview)
- [Flutter SDK](/ja/developers/sdks-and-tools/flutter/requirements)
- エラーハンドリング

# エラーハンドリング

Flutter SDKのすべてのエラーハンドリングはこのセクションに集約されています。`onErrorUnico`、`onErrorSelfie`、`onErrorDocument`コールバックは`code`（`int`）、`description`（`String`）、`info`（`String?`）フィールドを持つ`UnicoError`オブジェクトを受け取ります。`info`にはiOSで失敗したフローのステップが含まれ、Androidでは常に`null`です。

Error codes
| コード | 説明 |
| --- | --- |
| `73001` | コンテキストが無効 |
| `73002` | カメラを開く権限が付与されていない |
| `73003` | 最低APIレベルは21（LOLLIPOP）です |
| `73004` | 実装インターフェースコールバック`iAcessoBioSelfie`が見つからない |
| `73005` | 実装インターフェースコールバック`iAcessoBioDocument`が見つからない |
| `73006` | エミュレーター上でカメラを開けない |
| `73100` | インターネットに接続できない |
| `73200` | JSONファイル名を指定してください |
| `73202` | JSONファイルを解析できない |
| `73300` | unico認証オブジェクトを取得できない |
| `73301` | オブジェクトを解析できない |
| `73302` | unicoトークンが見つからない |
| `73303` | 現在のホストが登録されていない |
| `73400` | カメラを初期化できない |
| `73500` | セッショントークンを取得できない — サービス応答エラー |
| `73501` | オブジェクトを解析できない |
| `73502` | セッショントークンを取得できない |
| `73701` | アクティブライブネスのインポートが見つからない |
| `73702` | 本番環境でアクティブライブネスを初期化できない |
| `73703` | アクティブライブネスセッションを取得できない |
| `73704` | ユーザーがキャンセルボタンを押してセッションを完了しなかった |
| `73705` | セッションが正常に実行されず、FaceScanが生成されなかった |
| `73706` | カメラアクセスが拒否された — ユーザーが明示的に権限を拒否したか、デバイスポリシーがブロックしている |
| `73707` | アプリが終了、スリープ、OSの通知、またはバックグラウンド遷移によりセッションがキャンセルされた |
| `73708` | デバイスが横向きモードのためセッションがキャンセルされた |
| `73709` | デバイスが逆縦向きモードのためセッションがキャンセルされた |
| `73710` | 割り当てられたタイムアウト内にユーザーがセッションを完了できなかったためキャンセルされた |
| `73712` | メモリ不足またはアプリが本番環境外でネットワークが必要なためセッションがキャンセルされた |
| `73713` | キーを再検証する必要があるためセッションがキャンセルされた |
| `73714` | 開発者が設定した暗号化キーが無効なためセッションがキャンセルされた |
| `73715` | すべてのガイダンス画像が設定されていないためセッションがキャンセルされた |
| `73716` | このデバイスでSDKがカメラを起動できなかったためセッションがキャンセルされた |
| `73717` | ユーザーがロックアウト状態にあるためセッションがキャンセルされた |
| `73718` | ネイティブAPIの通常使用中に未知の予期しないエラー |
| `73719` | ユーザーが準備完了画面のサブテキストメッセージを押したためセッションがキャンセルされた |
| `73800` | 暗号化キーを構築できない |
| `74001` | `webAppToken` でカメラを開く際に `onSuccess` コールバックが実装されていない |

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

Handling the callback
```
@override**void onErrorUnico(UnicoError error) {  final code = error.code;  final description = error.description;  // handle error}
```

Lifecycle callbacks
`onErrorUnico`に加えて、SDKは以下もトリガーします：

`onUserClosedCameraManually()` — ユーザーが手動でカメラを閉じた。
`onSystemClosedCameraTimeoutSession()` — タイムアウトによりセッションが期限切れになった（デフォルト45秒、最小40秒）。
`onSystemChangedTypeCameraTimeoutFaceInference()` — 顔検出が13秒のしきい値を超えた。キャプチャが  手動モードに切り替わる。
最終更新 2026年10月22日**に