> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ones1ght.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 主なエラーコード

<Info>
  SDK でエラーが発生すると一部の機能が動作しないことがありますが、既存のアプリは正常に動作します。<br />
  SDK エラーの対処のためにコードを変更した場合は新しいアプリビルドを公開する必要があり、公開が完了したらアプリユーザーにアップデートを促してください。
</Info>

<div className="os-equal-tables">
  ## エラーレベル

  | レベル | 詳細 |
  | - | - |
  | **ERROR（エラー）** | 特定の機能が動作しません。即時の対処が必要です。 |
  | **WARN（警告）** | 機能は動作しますが、対処が必要です。 |
  | **INFO（通知）** | 機能は正常に動作しており、動作状態を確認できます。 |

  ## 初期化・認証

  | エラーコード | レベル | 詳細 |
  | - | - | - |
  | **E1001** | ERROR | SDK を初期化せずに関数を呼び出しました。 |
  | **E1002** | ERROR | SDK キーが誤っているか、期限切れまたは廃止されたキーです。 |
  | **E1003** | WARN | SDK キーは有効ですが、この顧客企業では測位がオフになっています。料金プランにユーザーアプリ SDK が含まれていないか、契約期間外です。 |
  | **E1004** | ERROR | プロフィールを紐付けていない状態では測位を開始できません。 |
  | **E1007** | ERROR | コンソールから測位キーを取得できなかった（未登録・取得失敗）か、測位エンジンがキーを拒否しました。このとき `buildings()`・`floors()`・`zones()` は空のリストを返し、`floor()`・`setFloorMap()`・`locators()` は E1001 をスローします。 |

  ## 端末・権限

  | エラーコード | レベル | 詳細 |
  | - | - | - |
  | **E2001** | WARN | サポートされていない OS バージョンです。 |
  | **E2002** | WARN | 測位機能に対応していない端末です。 |
  | **E2003** | WARN | 測位機能の利用権限が拒否されました。iOS では Info.plist に `NSLocationWhenInUseUsageDescription` がない場合にもこのコードが発生します。 |
  | **E2004** | WARN | Bluetooth がオフになっています。 |

  ## 空間設定

  | エラーコード | レベル | 詳細 |
  | - | - | - |
  | **E3001** | WARN | 建物情報なしでフロアを指定しました。 |
  | **E3002** | WARN | このフロアにロケーターがありません。 |
  | **E3003** | WARN | このフロアに測位セッション情報がありません。 |
  | **E3004** | WARN | このフロアにゾーンがないため、イベントが発生しません。 |
  | **E3006** | ERROR | サーバーからロケーター情報を取得できません。 |
  | **E3007** | WARN | BLE 信号を受信できず、フロアを特定できませんでした。 |
  | **E3008** | ERROR | 測位エンジンが検出したフロアがコンソールと一致しません。 |
  | **E3009** | WARN | 測位エンジンの領域がコンソールと一致しません。 |

  ## 測位

  | エラーコード | レベル | 詳細 |
  | - | - | - |
  | **E4001** | ERROR | 測位セッションが終了したか、見つかりません。 |
  | **E4002** | ERROR | ユーザーの現在位置情報を取得できません。 |
  | **E4003** | WARN | 登録されたロケーターの一部を受信できません。標準の UWB エンジン（iOS・Android）はロケーターごとの受信を区別しないためこのコードを出さず、座標が出ない場合は E4002 で通知します。 |
  | **E4004** | WARN | 測位エンジンのゾーン判定が 1 回失敗しました。座標は引き続き出力され、その回の判定のみ破棄されます。 |

  ## サーバー通信・送信

  | エラーコード | レベル | 詳細 |
  | - | - | - |
  | **E5001** | ERROR | ネットワークがオフラインです。 |
  | **E5002** | ERROR | SDK サーバーエラーです。 |
  | **E5003** | ERROR | リクエストの形式がサーバーと一致しません（HTTP 422、404 を含む）。多くの場合、SDK とサーバーのバージョンが合っていません。 |
  | **E5004** | ERROR | アクセス権限のないリソース（建物またはフロア）です（HTTP 403）。 |
  | **E5005** | ERROR | サーバーの応答を処理できませんでした。 |
  | **E5006** | WARN | 送信できなかった座標が失われました。 |

  ## 動作通知

  | コード | レベル | 詳細 |
  | - | - | - |
  | **I1001** | INFO | SDK の初期化が完了しました。 |
  | **I1002** | INFO | プロフィールを紐付けました。 |
  | **I3001** | INFO | フロアを指定しました。 |
  | **I3002** | INFO | 図面のないフロアです。測位情報は正常に送信されます。 |
  | **I4001** | INFO | 測位を開始します。 |
  | **I4002** | INFO | 測位を終了します。 |
  | **I5001** | INFO | 新しい送信周期を適用しました。デフォルト値の場合は表示されません。 |

  ## Flutter プラグイン

  Flutter は上記のコードを `OneS1ghtException.code` としてそのまま渡します。以下の 2 つのコードは Flutter プラグインでのみ発生します。

  | コード | レベル | 詳細 |
  | - | - | - |
  | **unsupportedActivity** | ERROR | Android アプリの `MainActivity` が `FlutterFragmentActivity` ではないため、権限をリクエストできません。 |
  | **internal** | ERROR | プラグイン内部で予期しないエラーが発生しました。 |
</div>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.