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

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

## 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` | 暗号化キーを構築できない |

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

## Handling the callback

```dart
@override
void onErrorUnico(UnicoError error) {
  final code = error.getCode();
  final description = error.getDescription();
  // handle error
}
```

## Lifecycle callbacks

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

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