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('ja');