Flutter 설정 가이드

const sdkKey = String.fromEnvironment('ONES1GHT_SDK_KEY');   // flutter run --dart-define=ONES1GHT_SDK_KEY=…
await OneS1ght.initialize(sdkKey: sdkKey);

final profileId = await OneS1ght.createProfile({'gender': 'F', 'ageBand': '20s'});   // 새 프로필 생성 → 프로필 ID 반환
save(profileId);                                                                    // 앱 또는 고객사 서버에 보관

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

final attributes = await OneS1ght.fetchProfile(profileId);   // {gender: F, ageBand: 20s}

await OneS1ght.replaceProfile(profileId, attributes: {'gender': 'F', 'ageBand': '30s'});   // 속성 전체 교체

await OneS1ght.deleteProfile(profileId);

final session = await OneS1ght.floorSession();                                   // 측위 세션 획득
session.onFloorDetected.listen((floorId) async {                                  // 엔진이 층을 찾으면 층 ID 전달
  if (floorId == null) return;
  final floor = await OneS1ght.floor(buildingId: buildingId, floorId: floorId);   // 층 정보 조회
  await OneS1ght.setFloorMap(floor, buildingId: buildingId);                      // 층 지정
});

final buildings = await OneS1ght.buildings();                               // 콘솔에 등록된 건물 목록
final floors    = await OneS1ght.floors(buildingId: buildings.first.id);    // 건물에 속한 층 목록

await OneS1ght.setFloorMap(floors.first, buildingId: buildings.first.id);   // 층 지정
await OneS1ght.setFloorMap(null);                                           // 층 지정 해제

final session = await OneS1ght.floorSession();
session.onPosition.listen((coord) => updateMyLocationMarker(coord.x, coord.y));   // coord.z: 높이

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

session.onZoneEnter.listen((zone) => showBanner('진입: ${zone.name}'));
session.onZoneExit.listen((zone) => hideBanner());
session.onZoneDwell.listen((d) => showBanner('체류: ${d.zone.name} — ${d.seconds.toInt()}초'));
session.onTriggers.listen((t) => t.triggers.forEach(handle));   // type: signage · coupon · tracking · merch · generic

session.onConfigChanged.listen((change) {
  switch (change) {
    case ZonesChanged() || ResyncNeeded():
      OneS1ght.refreshZones();
    case PlanChanged():
      reloadFloorPlan();   // 도면이 바뀜
    default:
      break;
  }
});

final floor = await OneS1ght.floor(buildingId: buildingId, floorId: floorId);
if (floor.image != null) planWidget = Image.memory(floor.image!);
setBounds(floor.minX, floor.minY, floor.maxX, floor.maxY);

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

await OneS1ght.reset();

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

switch (await OneS1ght.deviceAvailability()) {
  case DeviceAvailability.available:
    break;
  case DeviceAvailability.osVersionTooLow:
    showNotice('OS 업데이트 후 사용할 수 있습니다');
  case DeviceAvailability.deviceNotSupported:
    hidePositioningFeatures();   // UWB 미지원 기기
}

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

import 'package:flutter/foundation.dart';   // kDebugMode · debugPrint

if (kDebugMode) {
  OneS1ght.onDebugLog.listen((log) => debugPrint('[OneS1ght] ${log.level} ${log.message}'));
}

await OneS1ght.setLanguage('ko');