> ## 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.

# 主なエラーコード

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

## エラーレベル

| レベル | 詳細 |
| - | - |
| **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 | プラグイン内部で予期しないエラーが発生しました。 |


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