SDK クイックスタート

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)    // 発行されたプロフィール ID で認証します。

 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() }
                }
            }
    }
}