시작하기

dependencies:
  ones1ght_sdk:
    git:
      url: https://github.com/onecheck-inc/OneS1ght-Flutter-SDK
      ref: v0.0.1

import 'package:ones1ght_sdk/ones1ght.dart';

flutter config --enable-swift-package-manager

<key>NSLocationWhenInUseUsageDescription</key>
<string>매장 내 위치를 파악하는 데 사용합니다.</string>
<key>NSNearbyInteractionUsageDescription</key>
<string>UWB 정밀 측위에 사용합니다.</string>
<key>NSBluetoothAlwaysUsageDescription</key>
<string>주변 측위 장비를 찾는 데 사용합니다.</string>
<key>NSLocationTemporaryUsageDescriptionDictionary</key>
<dict>
    <key>Positioning</key>
    <string>정확한 실내 위치를 계산하는 데 사용합니다.</string>
</dict>

// android/app/src/main/kotlin/.../MainActivity.kt
import io.flutter.embedding.android.FlutterFragmentActivity

class MainActivity : FlutterFragmentActivity()

android {
    compileSdk = 37
    defaultConfig {
        minSdk = 26
    }
}

await OneS1ght.initialize(sdkKey: 'YOUR_API_KEY');

const sdkKey = String.fromEnvironment('ONES1GHT_SDK_KEY');
await OneS1ght.initialize(sdkKey: sdkKey);

flutter run --dart-define=ONES1GHT_SDK_KEY=ock_sdk_…

switch (await OneS1ght.deviceAvailability()) {
  case DeviceAvailability.available:
    break;
  case DeviceAvailability.osVersionTooLow:
    // "OS 업데이트 후 사용할 수 있습니다"
    break;
  case DeviceAvailability.deviceNotSupported:
    // "이 기기는 실내 측위를 지원하지 않습니다"
    break;
}

final status = await OneS1ght.requestPermission();   // 시스템 권한 창이 뜹니다

final profileId = await OneS1ght.createProfile({'gender': 'F', 'ageGroup': '20s'});
// profileId 는 앱이 보관해 두고 다음 실행에도 씁니다.

await OneS1ght.identify(profileId: profileId);   // 측위 시작 전에 꼭 호출

final buildings = await OneS1ght.buildings();
final floors = await OneS1ght.floors(buildingId: buildings.first.id);
await OneS1ght.setFloorMap(floors.first, buildingId: buildings.first.id);

final session = await OneS1ght.floorSession();
session.onFloorDetected.listen((floorId) async {
  if (floorId == null) return;   // 층을 잃음
  final floor = await OneS1ght.floor(buildingId: buildingId, floorId: floorId);
  await OneS1ght.setFloorMap(floor, buildingId: buildingId);
});

final floor = await OneS1ght.floor(buildingId: buildingId, floorId: floorId);
if (floor.image != null) Image.memory(floor.image!);

final session = await OneS1ght.floorSession();   // 항상 같은 인스턴스
await session.begin();   // 매장 진입 시
// ...
await session.end();     // 종료 + 남은 좌표 전송. 초기화·층 설정은 유지

await session.pause();    // 좌표 표시·수집·판정만 멈춤, 엔진은 층을 계속 잡고 있음
await session.resume();   // 바로 이어짐

session.onStopped.listen((reason) {
  if (reason == StopReason.engineFailed) {
    // 권한·Bluetooth 등 원인을 풀고 begin() 으로 다시 엽니다
  }
});

session.onZoneEnter.listen((zone) => debugPrint('IN  ${zone.name}'));
session.onZoneExit.listen((zone) => debugPrint('OUT ${zone.name}'));
session.onZoneDwell.listen((d) => debugPrint('DWELL ${d.zone.name} ${d.seconds}s'));
session.onPosition.listen((c) => debugPrint('${c.x}, ${c.y}'));   // 도면 로컬 미터
session.onTriggers.listen((t) {
  for (final trigger in t.triggers) {
    // trigger.type: signage · coupon · tracking · merch · generic (새 값이 늘 수 있습니다)
  }
});

final zones = await OneS1ght.refreshZones();   // 현재 층의 구역만 다시 받음(도면 재다운로드 없음)

session.onConfigChanged.listen((change) {
  switch (change) {
    case ZonesChanged() || ResyncNeeded():
      scheduleZoneRefresh();      // 1초 정도 모았다가 OneS1ght.refreshZones() 한 번
    case PlanChanged(:final floorId):
      redrawFloor(floorId);       // floor() 로 다시 받아 지도를 다시 그림
    case RulesChanged(:final zoneId):
      recheckZoneEvents(zoneId);  // 지금 들어가 있는 구역이면 그 구역의 이벤트를 한 번 다시 조회
    default:
      break;
  }
});

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

await OneS1ght.reset();   // 세션을 버림 — 다른 키로 initialize 할 수 있음

try {
  await session.begin();
} on OneS1ghtException catch (e) {
  switch (e.code) {
    case 'E1004':
      await OneS1ght.identify(profileId: savedProfileId);   // 프로필 연결 후 다시 시작
    case 'E2001' || 'E2002':
      showUnsupportedNotice();                              // 측위 불가 기기 안내
    default:
      debugPrint('${e.code} ${e.message}');
  }
}

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

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