はじめに

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() を 1 回
    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'));
}