SDK Quickstart

dependencies: [
    .package(url: "https://github.com/onecheck-inc/OneS1ght-iOS-SDK", from: "0.1.0"),
],
targets: [
    .target(name: "YourApp", dependencies: [
        .product(name: "OneS1ght", package: "OneS1ght-iOS-SDK"),
    ])
]

<key>NSLocationWhenInUseUsageDescription</key>
<string>매장 내 위치 확인을 위해 사용합니다.</string>
<key>NSNearbyInteractionUsageDescription</key>
<string>UWB 정밀 측위를 위해 사용합니다.</string>

import CoreLocation

let locationManager = CLLocationManager()
locationManager.requestWhenInUseAuthorization()

switch await OneS1ght.permissions() {
case .authorized:  break
case .denied:      showSettingsGuide()      // 재요청 불가 — 설정 앱으로 안내
case .unsupported: showUnsupportedNotice()
}

import SwiftUI
import OneS1ght

@main
struct MyApp: App {
    init() {
        Task { @MainActor in
            do {
                try await OneS1ght.initialize(sdkKey: "YOUR_SDK_API_KEY",
                                              geoSdkKey: "YOUR_GEOSPACE_SDK_KEY")
            } catch {
                print("OneS1ght 초기화 실패: \(error)")   // 앱 실행은 막지 않음
            }
        }
    }
    var body: some Scene { WindowGroup { ContentView() } }
}

 let profileId: String

 if let saved = savedProfileId {
     profileId = saved                       // 매 실행 때 마다 저장해 둔 값을 재사용합니다. 
 } else {
     profileId = try await OneS1ght.createProfile([   // 프로필 정보가 없을때 실행합니다. 
         "gender":   "F",
         "ageBand":  "20s",        // 세그먼트 지정하고 싶은 데이터를 자유롭게 지정해주세요.
         "interest": "cosmetics",
     ])
     save(profileId)                         // 프로필 생성시 고유 ID가 발급되며 다음 방문시 필요합니다. 
 }

 OneS1ght.identify(profileId: profileId)    // 발급된 프로필 아이디를 인증합니다. 

 let buildings = try await OneS1ght.buildings()      // 테넌트(조직)의 빌딩을 조회합니다.
 let floors    = try await OneS1ght.floors(buildings[0].id) // 특정 빌딩의 층을 조회합니다. 

 try await OneS1ght.setFloorMap(floors[0], buildingID: buildings[0].id) // 빌딩 ID와 층 ID를 통해 대상의 지도를 수신합니다. 
 
 try await OneS1ght.refreshZones() // 지도 내 구역정보를 새로 갱신합니다. 

   let session = try OneS1ght.floorSession() 

   // 구역 진입·이탈·체류
   session.onZoneEnter = { zone in showCoupon(zone) }   // 특정 구역을 진입했을 때 콜백 이벤트입니다. 
   session.onZoneExit  = { zone in hideCoupon(zone) }   // 특정 구역을 이탈했을 때 콜백 이벤트입니다. 
   session.onZoneDwell = { zone, seconds in print("체류 \(Int(seconds))초 — \(zone.name)") } // 특정 구역을 체류했을 때 콜백 이벤트입니다. 

   // 실시간 좌표 콜백 이벤트입니다. (x,y 좌표는 도면 로컬 미터로 반환합니다. )
   session.onPosition = { coord in
       print("📍 x: \(coord.x), y: \(coord.y)")
   }

   // 특정 구역의 이벤트 트리거입니다. 
   session.onTriggers = { zoneId, triggers in handle(triggers) }

   // SDK 디버그용입니다. (개발용으로 사용되며 Production 환경에서 사용할 수 없습니다.)
   OneS1ght.onDebugLog = { level, line in print("[OneS1ght][\(level)] \(line)") }

try await session.begin() // 측위 시작

  await session.end() // 측위 종료

import SwiftUI
import CoreLocation
import OneS1ght

@main
struct MyApp: App {
    var body: some Scene {
        WindowGroup { StoreView() }
    }
}

struct StoreView: View {
    @State private var status = "대기"
    private let locationManager = CLLocationManager()

    var body: some View {
        Text(status)
            .task {
                do {
                    // ① 초기화 (앱 시작 시 1회)
                    try await OneS1ght.initialize(sdkKey: "YOUR_SDK_API_KEY",
                                                  geoSdkKey: "YOUR_GEOSPACE_SDK_KEY")

                    // ② 권한 — 실제 앱에서는 delegate 로 '허용' 응답을 확인한 뒤
                    //    측위를 시작하세요 (첫 실행 시 팝업 응답 전 시작은 실패합니다)
                    locationManager.requestWhenInUseAuthorization()
                    guard await OneS1ght.permissions() == .authorized else {
                        status = "측위 권한이 필요합니다"
                        return
                    }

                    // ③ 프로필 연결 (발급받은 값을 앱이 보관해 재사용)
                    let profileId = try await OneS1ght.createProfile(["ageBand": "20s"])
                    OneS1ght.identify(profileId: profileId)

                    // ④ 측위 공간 설정 — 이걸 안 하면 좌표가 나오지 않습니다
                    let buildings = try await OneS1ght.buildings()
                    let floors = try await OneS1ght.floors(buildings[0].id)
                    try await OneS1ght.setFloorMap(floors[0], buildingID: buildings[0].id)

                    // ⑤ 진입 콜백 등록
                    let session = try OneS1ght.floorSession()
                    session.onPosition = { coord in
                        status = String(format: "x %.2f · y %.2f", coord.x, coord.y)
                    }
                    session.onZoneEnter = { zone in print("진입: \(zone.name)") }
                    session.onZoneExit  = { zone in print("이탈: \(zone.name)") }

                    // ⑥ 측위 시작
                    try await session.begin()
                } catch {
                    status = "실패: \(error)"
                }
            }
            .onDisappear {
                // ⑦ 측위 종료
                Task { @MainActor in
                    if let session = try? OneS1ght.floorSession() { await session.end() }
                }
            }
    }
}