iOS 설정 가이드

import OneS1ght

#if DEBUG
let sdkKey = "YOUR_DEVELOPMENT_API_KEY" // 개발(테스트) 모드에서 사용 시
#else
let sdkKey = "YOUR_PRODUCTION_API_KEY"  // 운영 모드에서 사용 시
#endif
try await OneS1ght.initialize(sdkKey: sdkKey)

#import "MyApp-Swift.h"   // MyApp 자리에 Product Module Name. 브리지 파일을 추가하고 1회 빌드하면 생깁니다.

#ifdef DEBUG
NSString *sdkKey = @"YOUR_DEVELOPMENT_API_KEY"; // 개발(테스트) 모드에서 사용 시
#else
NSString *sdkKey = @"YOUR_PRODUCTION_API_KEY";  // 운영 모드에서 사용 시
#endif
[OneS1ghtBridge initializeWithSdkKey:sdkKey completion:^(NSError *error) {
    if (error) { return; }   // 실패 처리
}];

let profileId = try await OneS1ght.createProfile(["gender": "F", "ageBand": "20s"])   // 새 프로필 생성 → 프로필 ID 반환
save(profileId)                                                                     // 앱 또는 고객사 서버에 보관

OneS1ght.identify(profileId: savedProfileId)   // 매 실행, 측위 전에 연결. 로그아웃 시 nil

[OneS1ghtBridge createProfile:@{ @"gender": @"F", @"ageBand": @"20s" }                 // 새 프로필 생성 → 프로필 ID 반환
                    completion:^(NSString *profileId, NSError *error) {
    if (!error) { [self save:profileId]; }                                          // 앱 또는 고객사 서버에 보관
}];

[OneS1ghtBridge identifyWithProfileId:savedProfileId];   // 매 실행, 측위 전에 연결. 로그아웃 시 nil

let attributes = try await OneS1ght.fetchProfile(profileId)   // ["gender": "F", "ageBand": "20s"]

[OneS1ghtBridge fetchProfile:profileId completion:^(NSDictionary *attributes, NSError *error) {
    if (error) { return; }   // 없는 ID
}];

try await OneS1ght.replaceProfile(profileId, attributes: ["gender": "F", "ageBand": "30s"])   // 속성 전체 교체

[OneS1ghtBridge replaceProfile:profileId attributes:@{ @"gender": @"F", @"ageBand": @"30s" }   // 속성 전체 교체
                    completion:^(NSError *error) { }];

try await OneS1ght.deleteProfile(profileId)

[OneS1ghtBridge deleteProfile:profileId completion:^(NSError *error) { }];

let session = try OneS1ght.floorSession()   // 측위 세션 획득
session.onFloorDetected = { floorId in      // 엔진이 층을 찾으면 층 ID 전달
    guard let floorId else { return }
    Task {
        let floor = try await OneS1ght.floor(buildingId: buildingId, floorId: floorId)   // 층 정보 조회
        try await OneS1ght.setFloorMap(floor, buildingId: buildingId)                   // 층 지정
    }
}

[OneS1ghtBridge onFloorDetected:^(NSString *floorId) {   // 엔진이 층을 찾으면 층 ID 전달
    if (!floorId) { return; }
    [OneS1ghtBridge setFloorMapWithBuildingId:buildingId floorId:floorId completion:^(NSError *error) { }];   // 층 지정
}];

let buildings = try await OneS1ght.buildings()                            // 콘솔에 등록된 건물 목록
let floors    = try await OneS1ght.floors(buildingId: buildings[0].id)   // 건물에 속한 층 목록

try await OneS1ght.setFloorMap(floors[0], buildingId: buildings[0].id)   // 층 지정
try await OneS1ght.setFloorMap(nil)                                      // 층 지정 해제

[OneS1ghtBridge buildings:^(NSArray<NSDictionary *> *buildings, NSError *error) {                 // 콘솔에 등록된 건물 목록
    NSString *buildingId = buildings.firstObject[@"id"];
    [OneS1ghtBridge floorsWithBuildingId:buildingId completion:^(NSArray<NSDictionary *> *floors, NSError *error) {   // 층 목록
        [OneS1ghtBridge setFloorMapWithBuildingId:buildingId floorId:floors.firstObject[@"id"]
                                       completion:^(NSError *error) { }];   // 층 지정
    }];
}];
[OneS1ghtBridge setFloorMapWithBuildingId:nil floorId:nil completion:^(NSError *error) { }];   // 층 지정 해제

let session = try OneS1ght.floorSession()
session.onPosition = { coord in updateMyLocationMarker(x: coord.x, y: coord.y) }   // coord.z: 높이

try await session.begin()   // 측위 시작
await session.end()         // 측위 종료 + 남은 좌표 전송

[OneS1ghtBridge onPosition:^(double x, double y, double z) { [self updateMyLocationMarkerX:x y:y]; }];

[OneS1ghtBridge beginWithCompletion:^(NSError *error) { }];   // 측위 시작
[OneS1ghtBridge endWithCompletion:^{ }];                       // 측위 종료 + 남은 좌표 전송

session.onZoneEnter = { zone in showBanner("진입: \(zone.name)") }
session.onZoneExit  = { zone in hideBanner() }
session.onZoneDwell = { zone, seconds in showBanner("체류: \(zone.name) — \(Int(seconds))초") }
session.onTriggers  = { zoneId, triggers in triggers.forEach(handle) }   // type: signage · coupon · tracking · merch · generic

[OneS1ghtBridge onZoneEnter:^(NSDictionary *zone) { [self showBanner:zone[@"name"]]; }];
[OneS1ghtBridge onZoneExit:^(NSDictionary *zone)  { [self hideBanner]; }];
[OneS1ghtBridge onZoneDwell:^(NSDictionary *zone, double seconds) { [self showDwell:zone[@"name"] seconds:seconds]; }];
[OneS1ghtBridge onTriggers:^(NSString *zoneId, NSArray<NSDictionary *> *triggers) {
    for (NSDictionary *trigger in triggers) { [self handle:trigger]; }   // triggerId · type · payload
}];

var refreshTask: Task<Void, Never>?
session.onConfigChanged = { change in
    switch change {
    case .zonesChanged, .resyncNeeded:
        refreshTask?.cancel()                             // 연달아 오면 마지막 것만
        refreshTask = Task {
            try? await Task.sleep(for: .seconds(1))
            guard !Task.isCancelled else { return }
            _ = await OneS1ght.refreshZones()
        }
    case .planChanged:                 reloadFloorPlan()   // 도면이 바뀜
    default:                           break
    }
}

[OneS1ghtBridge onConfigChanged:^(NSString *kind, NSString *targetId) {
    if ([kind isEqualToString:@"zonesChanged"] || [kind isEqualToString:@"resyncNeeded"]) {
        [NSObject cancelPreviousPerformRequestsWithTarget:self selector:@selector(reloadZones) object:nil];
        [self performSelector:@selector(reloadZones) withObject:nil afterDelay:1.0];   // 1초 모아 한 번만 — reloadZones 에서 refreshZones: 호출
    } else if ([kind isEqualToString:@"planChanged"]) {
        [self reloadFloorPlan];   // 도면이 바뀜
    }
}];

let floor = try await OneS1ght.floor(buildingId: buildingId, floorId: floorId)
planView.image = floor.image.flatMap(UIImage.init(data:))
setBounds(minX: floor.minX, minY: floor.minY, maxX: floor.maxX, maxY: floor.maxY)

[OneS1ghtBridge floorWithBuildingId:buildingId floorId:floorId completion:^(NSDictionary *floor, NSError *error) {
    self.planView.image = floor[@"image"] ? [UIImage imageWithData:floor[@"image"]] : nil;
    // 범위: originX · originY · widthM · heightM (미터)
}];

await OneS1ght.uploadPendingPositions()   // 쌓인 좌표를 지금 전송
OneS1ght.discardPendingPositions()        // 보내지 않고 버림

[OneS1ghtBridge uploadPendingPositions:^{ }];   // 쌓인 좌표를 지금 전송
[OneS1ghtBridge discardPendingPositions];       // 보내지 않고 버림

await OneS1ght.reset()

[OneS1ghtBridge reset:^{ }];

session.onStopped = { reason in
    if case .engineFailed = reason { showRetrySearch() }   // 원인을 풀고 begin() 다시
}

[OneS1ghtBridge onStopped:^(NSString *reason) {
    if ([reason isEqualToString:@"engineFailed"]) { [self showRetrySearch]; }   // 원인을 풀고 begin 다시
}];

switch OneS1ght.deviceAvailability {
case .available:          break
case .osVersionTooLow:    showNotice("iOS 27 이상이 필요합니다")
case .deviceNotSupported: hidePositioningFeatures()     // UWB 미지원 기기
@unknown default:         break
}

NSString *availability = OneS1ghtBridge.deviceAvailability;   // @"available" · @"osVersionTooLow" · @"deviceNotSupported"
if (![availability isEqualToString:@"available"]) {
    [self hidePositioningFeatures];
}

switch await OneS1ght.requestPermission() {
case .authorized:  break
case .denied:      showSettingsGuide()        // 앱에서 재요청 불가 — 설정 앱으로
case .unsupported: showUnsupportedNotice()    // 측위 미지원 기기
@unknown default:  break
}

[OneS1ghtBridge requestPermission:^(NSString *status) {
    if ([status isEqualToString:@"denied"])      { [self showSettingsGuide]; }       // 앱에서 재요청 불가 — 설정 앱으로
    if ([status isEqualToString:@"unsupported"]) { [self showUnsupportedNotice]; }   // 측위 미지원 기기
}];

func locationManagerDidChangeAuthorization(_ manager: CLLocationManager) {
    if manager.authorizationStatus == .authorizedWhenInUse {
        manager.requestAlwaysAuthorization()   // iOS 는 이 창을 앱마다 한 번만 띄웁니다
    }
}

- (void)locationManagerDidChangeAuthorization:(CLLocationManager *)manager {
    if (manager.authorizationStatus == kCLAuthorizationStatusAuthorizedWhenInUse) {
        [manager requestAlwaysAuthorization];   // iOS 는 이 창을 앱마다 한 번만 띄웁니다
    }
}

#if DEBUG
OneS1ght.onDebugLog = { level, line in print("[OneS1ght][\(level)] \(line)") }
#endif

#ifdef DEBUG
[OneS1ghtBridge onDebugLog:^(NSString *level, NSString *line) { NSLog(@"[OneS1ght][%@] %@", level, line); }];
#endif