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

エラーハンドリング

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

Error codes
コード説明
73001コンテキストが無効
73002カメラを開く権限が付与されていない
73003最低APIは21（LOLLIPOP）です
73004実装インターフェースコールバックiAcessoBioSelfieが見つからない
73005実装インターフェースコールバックiAcessoBioDocumentが見つからない
73006エミュレーター上でカメラを開けない
73100インターネットに接続できない
73200JSONファイル名を指定してください
73202JSONファイルを解析できない
73300unico認証オブジェクトを取得できない
73301オブジェクトを解析できない
73302unicoトークンが見つからない
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暗号化キーを構築できない
公式エラーカタログ

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

Handling the callback
@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秒のしきい値を超えた。キャプチャが手動モードに切り替わる。
最終更新 に