패키지 선언
Dart
초기화
.initialize
OneS1ght API 키로 측위엔진을 초기화합니다.Dart
.requestPermission
측위엔진 사용을 위한 앱 권한을 요청합니다.Dart
.setLanguage
SDK 로그 문구 언어를 설정합니다.ko : 한국어, ja : 일본어, en : 영어, null : 시스템 설정 언어
Dart
.onDebugLog
SDK 로그를 수신합니다.ko : 로그 레벨, message : 로그 메세지
Dart
.reset
로케이터의 세션을 초기화합니다.Dart
상태 조회
.isInitialized
초기화 성공 확인 여부를 반환합니다.Dart
.deviceAvailability
측위 가능 기기를 판별하고 미지원시 사유를 반환합니다.Dart
.googleMapKey
도면을 표시할 Google Maps API 키를 반환합니다.Dart
.sdkVersion
사용중인 네이티브 SDK 버전을 반환합니다.플러그인 버전은
OneS1ght.pluginVersion을 참조해 주세요.
Dart
프로필
.createProfile
새로운 개인화 프로필을 생성합니다. 성공적으로 생성하면 고유 프로필 ID를 반환합니다.Dart
.identify
수집할 측위 데이터를 묶을 프로필을 연결합니다. 연결 해제시null으로 설정하세요.
Dart
.fetchProfile
프로필의 속성을 조회합니다.Dart
.replaceProfile
프로필 속성을 교체하며 이전 데이터는 삭제됩니다.Dart
.deleteProfile
프로필 정보를 영구 삭제합니다.Dart
공간 조회
.buildings
테넌트와 연관된 모든 건물 목록을 조회합니다.Dart
.floors
건물의 층 목록을 조회합니다.Dart
.floor
선택한 층의 상세 정보를 조회합니다.Dart
.zones
선택한 층의 모든 구역을 조회합니다.Dart
.locators
선택한 층의 로케이터 정보를 조회합니다.Dart
층 지정
.setFloorMap
측위를 시작할 층을 지정합니다.Dart
.refreshZones
최신화된 구역 정보를 조회합니다.Dart
측위 세션
.floorSession
선택한 층의 로케이터 세션을 획득합니다.Dart
.begin
사용자 측위를 시작합니다.Dart
.end
사용자 측위를 종료합니다.Dart
.pause · .resume
사용자 측위를 중지, 재개합니다. 종료와 달리 SDK 내 측위 엔진은 종료하지 않습니다.Dart
.isRunning · .isPaused
측위 상태여부와 중지여부를 반환합니다.Dart
세션 이벤트
.onPosition
실시간으로 사용자 좌표 반환 이벤트를 발생합니다. (기본값 1초당 4회)Dart
.onZoneEnter · .onZoneExit
구역 진입, 이탈시 이벤트가 동작합니다.Dart
.onZoneDwell
특정 구역의 체류 시간이 초과할 경우(dwellSeconds 기준) 이벤트가 발생합니다.
Dart
.onTriggers
공간 내 이벤트(또는 시책) 동작시 이벤트가 발생합니다.Dart
.onFloorDetected
로케이터의 BLE 신호를 수신한 경우 이벤트가 발생합니다.Dart
.onStopped
사용자 측위가 중지된 경우 이벤트가 발생합니다.Dart
.onConfigChanged
콘솔 페이지에서 설정이 변경되었을 경우 이벤트가 발생합니다.Dart
데이터 전송
좌표는 300건 또는 60초마다, 그리고 백그라운드 진입과end() 때 자동 전송됩니다.
.uploadPendingPositions
쌓인 좌표 즉시 전송.Dart
.discardPendingPositions
쌓인 좌표 폐기.Dart
오류 처리
실패는 모두OneS1ghtException 을 반환하며, 자세한 내용은 에러 코드를 참고하세요.
Dart
모델
목록은List<T>, 바이트는 Uint8List 입니다.
Coordinates
Building · Floor
Locator · FloorLocators
Zone
Trigger
열거형(
ConfigChange · StopReason · PermissionStatus · DeviceAvailability · LogLevel)은 마이너 버전에서 값이 늘 수 있습니다 — switch 에 default 를 둡니다.
제약
- 모든 호출은
Future, 이벤트는Stream— UI 를 바로 고쳐도 됩니다. - UWB 측위는 포그라운드 전용이며 백그라운드에서 멈추고 돌아오면 다시 시작합니다.
- 좌표 버퍼는 앱상 메모리에 임시 저장되며 강제 종료 시 미전송 좌표는 사라집니다.
- 에뮬레이터에서는 측위할 수 없습니다.