主なエラーコード - OneS1ght

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