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

# モバイルSDK概要

> OneS1ght SDKは、UWB屋内測位による来店・動線データとゾーン（Zone）イベントをアプリに提供する屋内位置インテリジェンスSDKです。

## OneS1ght SDKとは？

**OneS1ght SDK**は屋内位置インテリジェンスSDKです。お客様のアプリに追加すると、**UWB（DL-TDoA）屋内測位**で来店・動線データを収集し、**ゾーン（Zone）入場・退場・滞在イベント**をアプリに提供します。

<Note>
  UWB測位は、iPhoneに内蔵されたUWBチップと店舗に設置したアンカー（anchor）間の距離測定（DL-TDoA）で屋内位置を計算します。測位エンジンはSDKパッケージに内蔵されており、別途の設定は不要です。
</Note>

## データフロー

<Steps>
  <Step title="アプリ · SDK">
    アプリに追加したOneS1ght SDKが、端末上でUWB測位を実行しゾーンを判定します。
  </Step>

  <Step title="測位">
    測位結果（来店・動線座標、ゾーン入場/退場/滞在）がOneS1ghtへ収集されます。
  </Step>

  <Step title="コンソール · インサイト · エージェント">
    収集したデータはコンソールの分析・インサイトやエージェントで活用されます。
  </Step>
</Steps>

## プラットフォーム対応

| プラットフォーム | 状態        |
| -------- | --------- |
| iOS      | 提供中（v0.1） |
| Android  | 準備中       |

<Info>
  プラットフォーム別の詳細ガイドは、SDKリポジトリのドキュメント（`ios/README.md`、`android/README.md`）でも確認できます。リポジトリ: [`github.com/onecheck-inc/onesight-sdk`](https://github.com/onecheck-inc/onesight-sdk)
</Info>

## iOS要件

| 項目       | 要件                    |
| -------- | --------------------- |
| iOSバージョン | iOS 27.0以上            |
| デバイス     | iPhone 12以上（UWBチップ搭載） |
| 開発環境     | Xcode 27以上            |

<Note>
  UWB非対応の端末でも、アプリは**正常に動作**し、SDKの機能のみが無効になります。
</Note>

## 次のステップ

<CardGroup cols={2}>
  <Card title="インストール" icon="download" href="/ja/sdk/installation">
    Swift Package ManagerでSDKを追加し、初期化します。
  </Card>

  <Card title="使い方" icon="code" href="/ja/sdk/usage">
    クイックスタート、主要API、ゾーンイベントの受信方法を案内します。
  </Card>
</CardGroup>

<Card title="モバイルSDKキー管理" icon="key" href="/ja/locator/sdk-keys">
  SDKの初期化に使う`ock_sdk_...`キーをコンソールで発行・管理します。
</Card>

## お問い合わせ

SDKに関するお問い合わせは[onesight-support@onecheck.co.kr](mailto:onesight-support@onecheck.co.kr)までご連絡ください。