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()                             // 続けて届いたら最後の 1 回だけ
        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 秒まとめて 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 はこのダイアログをアプリごとに 1 回しか表示しません
    }
}

- (void)locationManagerDidChangeAuthorization:(CLLocationManager *)manager {
    if (manager.authorizationStatus == kCLAuthorizationStatusAuthorizedWhenInUse) {
        [manager requestAlwaysAuthorization];   // iOS はこのダイアログをアプリごとに 1 回しか表示しません
    }
}

#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