ones1ght library

0.0.1 까지의 import 경로 — package:ones1ght_sdk/ones1ght_sdk.dart 와 같다.

pub.dev 는 대표 라이브러리 이름이 패키지 이름과 같기를 바라서 0.0.2 에서 ones1ght_sdk.dart 로 옮겼다. 이 파일은 옛 경로로 붙인 앱이 깨지지 않게 남겨 둔다.

Classes

Building
ConfigChange: 콘솔에서 무언가 바뀌었다. SDK 는 이 신호로 아무것도 하지 않는다 — 무엇을 다시 받을지는 앱이 정한다.
Coordinates: 실시간 좌표(도면 로컬 미터).
DebugLog: SDK 디버그 로그 한 줄 — OneS1ght.onDebugLog 로 온다.
Floor: 층. 목록(floors)에서는 image 가 비어 있고, 단건(floor)으로 받으면 채워진다.
FloorLocators: 로케이터 + 세션 ID.
FloorSession
Locator
OneS1ght
PlanChanged: 도면이 바뀌었다 → 층 단건을 다시 받아 지도를 다시 그린다.
Position: 도면 로컬 좌표(미터) 한 점 — 구역 꼭짓점.
ResyncNeeded: 실시간 연결이 끊겼다 다시 붙었다 — 놓친 변경이 있을 수 있다. 구역을 다시 받는다.
RulesChanged: 시책이 바뀌었다 → 지금 들어가 있는 구역이 있으면 그 구역의 이벤트를 한 번 다시 조회한다.
SdkConfigChanged: SDK 설정(수집 Hz·로그 등급)이 바뀌었다.
Trigger: 존 이벤트 서버 응답의 개인화 액션.
Zone: 구역. 판정 파라미터는 콘솔이 정한 값이 그대로 온다(앱이 바꿀 수 없다).
ZoneDwell: onZoneDwell 한 건 — 체류 시간(초)에 도달했다.
ZonesChanged: 구역이 바뀌었다 → OneS1ght.refreshZones(). ⚠️ 연속해서 오면 접어라(권장 1초).
ZoneTriggers: onTriggers 한 건 — (zoneId, triggers).

OneS1ghtException: SDK 오류. code 는 네이티브 SDK 의 오류 코드(E1001 등)이며 iOS·Android 가 같다.