> ## 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="/sdk/installation">
    Swift Package Manager로 SDK를 추가하고 초기화합니다.
  </Card>

  <Card title="사용법" icon="code" href="/sdk/usage">
    빠른 시작, 주요 API, 구역 이벤트 수신 방법을 안내합니다.
  </Card>
</CardGroup>

<Card title="모바일 SDK 키 관리" icon="key" href="/locator/sdk-keys">
  SDK 초기화에 사용할 `ock_sdk_...` 키를 콘솔에서 발급·관리합니다.
</Card>

## 문의

SDK 관련 문의는 [onesight-support@onecheck.co.kr](mailto:onesight-support@onecheck.co.kr)로 연락해 주세요.