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

# iOS SDK

## 0.2.6

* バックグラウンドから戻った後にフロアが見つからない問題（`E3007`）を修正 — 測位エンジン起動時にフロアビーコンを最大10秒直接スキャン

## 0.2.5

* 測位の再開(resume)時、エンジンが座標を出していない場合（セッションエラー、または5秒以上座標なし）はエンジンを再起動

## 0.2.4

* 測位エンジンはアプリが画面に表示されている間のみ動作するよう変更 — バックグラウンドで `begin()` を呼ぶと、画面に表示された時点でエンジンを開始
* バックグラウンド移行・アプリ終了時にエンジンを停止し、残ったフロア検出用ビーコン領域を削除
* バックグラウンドで起動後にアプリを開くとすぐ `E3007` で終わる問題を修正
* リアルタイム接続の再接続後、フロアプランのあるフロアでゾーンが地図から消える問題を修正

## 0.2.3

* SDK のコード・動作の変更なし（ドキュメント・コードスニペットのみ変更）
* MCP のコードスニペットに iOS 27.2 以上の「常に」位置情報権限を反映
* MCP のコードスニペットのインストールバージョンを `from: "0.2.2"` に変更

## 0.2.2

* フロアを複数のロケーターで判定するよう改善（新しいフロアへの切り替えは 3 台以上）
* 最初のフロアは 1 秒観測してから確定するよう変更
* UWB セッションが切れた場合、エンジンが自ら再度開くよう改善
* 設定ガイドに[位置情報の常時許可](/ja/developers/sdk/integration/ios#位置情報の常時許可)の節を追加（iOS 27.2 以上で必須）

## 0.2.1

* `SdkError.floorNotSet` を追加 — 網羅的な `switch` にはケースの追加が必要
* 建物なしで `setFloorMap(floor)` を呼ぶと `floorNotSet`（`E3001`）が発生
* 測位キーの問題を `E1002` ではなく `E1007` で報告するよう変更
* Bluetooth 非対応端末を `E2003` ではなく `E2002` で報告するよう変更
* バックグラウンド移行時にゾーン退出（EXIT）を送信し、`onZoneExit` を呼ぶよう変更
* バックグラウンド復帰後に同じゾーンの進入が 2 回送られる問題を修正
* ゾーン変更によるエンジン再起動時に進入が重複送信される問題を修正

## 0.2.0

* 内部型（`ApiClient`・`Req…`・`Res…`・`SdkDefaults` など）を非公開化
* `MockPositioningProvider` を削除 — `PositioningProvider` を直接採用
* `permissions()` → `requestPermission()`（システムダイアログを表示）
* `putProfile(_:_:)` → `replaceProfile(_:attributes:)`（省略した属性は削除）
* `getProfile(_:)` → `fetchProfile(_:)`
* `floor(_:_:)` → `floor(buildingId:floorId:)`
* `send()` → `uploadPendingPositions()`、`empty()` → `discardPendingPositions()`
* 全一覧は[CHANGELOG 0.2.0](https://github.com/onecheck-inc/OneS1ght-iOS-SDK/blob/main/CHANGELOG.md#020--2026-10-02)（韓国語）を参照（旧名は警告のみ）
* `FloorSession.onFloorDetected`・`onStopped`・`StopReason` を追加
* エンジンが停止すると 3・10・30 秒後に再試行し、失敗時はセッションを終了（`.engineFailed`）
* 一時停止がバックグラウンドを経ても維持されるよう変更
* `onDebugLog` のコード行のレベルを細分化し、1 行に統合
* `E3001`（フロア未指定）をコンソールに送らないよう変更
* 座標送信中に `empty()` を呼ぶとアプリが落ちる問題を修正
* `begin(provider:)` でゾーンコールバック・一時停止が無視される問題を修正
* オフライン時に座標・ログの送信が暴走する問題を修正
* `initialize` の前に `identify` すると `begin()` が `E1004` で失敗する問題を修正
* `baseURL` が建物・フロア・ゾーンの取得に適用されない問題を修正

## 0.1.24

* Bluetooth をオフにしたまま開始すると測位が戻らない問題を修正
* `E2004`（Bluetooth オフ）を追加 — 従来は `E2003` で報告

## 0.1.23

* `end()` 直後の `begin()` が黙って無視される問題を修正
* すでに測位中のため弾かれた `begin()` に警告ログを追加

## 0.1.22

* `pause()` 中にもゾーン進入・退出の通知が出る問題を修正
* エンジン停止中に開始するとセッションが再び切れる問題を修正

## 0.1.21

* 実行中にコンソールで新たに描いたゾーンが判定されない問題を修正
* ゾーン変更時のエンジン再起動で約 1.5 秒座標が途切れる

## 0.1.20

* `FloorSession.pause()`・`resume()`・`isPaused` を追加

## 0.1.19

* `E2001`・`E2002` など動作を継続する状態のログレベルを WARN に変更
* `E3001` の文言を修正（フロアなしでの開始は正常な経路）

## 0.1.18

* `initialize` の `geoSdkKey` 引数を削除
* `geoPartnerKey`・`geoBaseUrl` アクセサを削除
* 測位キーはコンソールからのみ取得 — ない場合は `E1007`
* `E1005`・`E1006` は発生しなくなった

## 0.1.17

* 最小 iOS 15 → 18、Xcode 27（iOS 27 SDK）が必要
* 測位は iOS 27 以上でのみ動作 — それ未満は `osVersionTooLow`
* `Info.plist` に `NSBluetoothAlwaysUsageDescription` の追加が必要
* `NSLocationTemporaryUsageDescriptionDictionary`（キー `Positioning`）の追加が必要
* アプリがフロアを指定しなくてもエンジンがフロアを検出するよう変更
* 測位キー・地図キーをコンソールから取得するよう変更
* SDK が位置情報権限を直接リクエストするよう変更
* `E1007`・`E3007`・`E3008`・`E3009`・`E4004` などの新コードを追加
* ゾーン判定をエンジンが担当し、コンソールのゾーン判定値（`inDist` など）は使用しなくなった

## 0.1.16

* ロケーターの取得に失敗しても図面・ゾーンは表示されるよう改善
* `E3006 locatorsFetchFailed` を追加

## 0.1.15

* `E3005 planMissing` を `I3002 planMissing`（INFO）に変更

## 0.1.14

* 図面のないフロアでも測位をサポート
* `Locator.isPlaced` を追加
* 図面がない場合 `Floor` のサイズ・原点は 0 — `hasPlan` の確認が必要

## 0.1.13

* `0.1.12` タグのデバッグログ例がコンパイルできない問題を修正

## 0.1.12

* `onDebugLog`・`onLog` クロージャの引数を `{ level, line in }` に変更
* `LogLevel` を追加（`Comparable`）

## 0.1.11

* ゾーンをすべて削除しても判定が続く問題を修正
* `setLanguage(_:)` を追加

## 0.1.10

* 測位が中断して戻った後に再開されない問題を修正

## 0.1.9

* `initialize` が端末非対応で失敗しなくなった — `begin()` で判定
* リアルタイム変更イベントが届かない問題を修正
* フロア一覧の取得時に図面全体を受信していた問題を修正

## 0.1.8

* 測位開始前にもリアルタイム変更の受信（`onConfigChanged`）を接続

## 0.1.7

* フロア ID が数値で届くとフロア一覧が空になる問題を修正

## 0.1.6

* 連携例がコンパイルできない問題を修正（コード変更なし）

## 0.1.5

* リポジトリの URL を `onecheck-inc/OneS1ght-iOS-SDK` に変更
* `package:` 識別子も `OneS1ght-iOS-SDK` への変更が必要

## 0.1.4

* 0.1.4 以下の初期リリース — 内容は [CHANGELOG](https://github.com/onecheck-inc/OneS1ght-iOS-SDK/blob/main/CHANGELOG.md) を参照
* `0.1.3` 以下は本番サーバーで初期化に失敗 — `0.1.12` 以上を使用


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