Skip to main content

패키지 선언

초기화

.initialize

OneS1ght API 키로 측위엔진을 초기화합니다.

.requestPermission

측위엔진 사용을 위한 앱 권한을 요청합니다.

.setLanguage

SDK 로그 문구 언어를 설정합니다.
ko : 한국어, ja : 일본어, en : 영어, nil : 시스템 설정 언어

.onDebugLog

SDK 로그를 수신합니다.
ko : 로그 레벨, message : 로그 메세지

.reset

로케이터의 세션을 초기화합니다.

상태 조회

.isInitialized

초기화 성공 확인 여부를 반환합니다.

.deviceAvailability

측위 가능 기기를 판별하고 미지원시 사유를 반환합니다.

.googleMapKey

도면을 표시할 Google Maps API 키를 반환합니다.

.sdkVersion

사용중인 SDK 버전을 반환합니다.

프로필

.createProfile

새로운 개인화 프로필을 생성합니다. 성공적으로 생성하면 고유 프로필 ID를 반환합니다.

.identify

수집할 측위 데이터를 묶을 프로필을 연결합니다. 연결 해제시 nil으로 설정하세요.

.fetchProfile

프로필의 속성을 조회합니다.

.replaceProfile

프로필 속성을 교체하며 이전 데이터는 삭제됩니다.

.deleteProfile

프로필 정보를 영구 삭제합니다.

공간 조회

.buildings

테넌트와 연관된 모든 건물 목록을 조회합니다.

.floors

건물의 층 목록을 조회합니다.

.floor

선택한 층의 상세 정보를 조회합니다.

.zones

선택한 층의 모든 구역을 조회합니다.

.locators

선택한 층의 로케이터 정보를 조회합니다.

층 지정

.setFloorMap

측위를 시작할 층을 지정합니다.

.refreshZones

최신화된 구역 정보를 조회합니다.

측위 세션

.floorSession

선택한 층의 로케이터 세션을 획득합니다.

.begin

사용자 측위를 시작합니다.

.end

사용자 측위를 종료합니다.

.pause · .resume

사용자 측위를 중지, 재개합니다. 종료와 달리 SDK 내 측위 엔진은 종료하지 않습니다.

.isRunning · .isPaused

측위 상태여부와 중지여부를 반환합니다.

세션 이벤트

.onPosition

실시간으로 사용자 좌표 반환 이벤트를 발생합니다. (기본값 1초당 4회)

.onZoneEnter · .onZoneExit

구역 진입, 이탈시 이벤트가 동작합니다.

.onZoneDwell

특정 구역의 체류 시간이 초과할 경우(dwellSeconds 기준) 이벤트가 발생합니다.

.onTriggers

공간 내 이벤트(또는 시책) 동작시 이벤트가 발생합니다.

.onFloorDetected

로케이터의 BLE 신호를 수신한 경우 이벤트가 발생합니다.

.onStopped

사용자 측위가 중지된 경우 이벤트가 발생합니다.

.onConfigChanged

콘솔 페이지에서 설정이 변경되었을 경우 이벤트가 발생합니다.

데이터 전송

좌표는 300건 또는 60초마다, 그리고 백그라운드 진입과 end() 때 자동 전송됩니다.

.uploadPendingPositions

쌓인 좌표 즉시 전송.

.discardPendingPositions

쌓인 좌표 폐기.

오류 처리

실패는 SdkError(SDK 상태) 와 ApiError(통신) 로 옵니다. 코드의 뜻은 에러 코드를 참고하세요. Objective-C 는 NSError.userInfo[@"sdkCode"] 에 담깁니다.

모델

목록은 [T], 바이트는 Data 입니다.

Coordinates

Building · Floor

Locator · FloorLocators

Zone

Trigger

Objective-C 브리지

아래 파일을 앱 타깃에 추가하고 한 번 빌드하면 <Product Module Name>-Swift.h 가 생깁니다.
OneS1ghtBridge.swift

제약

  • UWB 측위는 포그라운드 전용 — 백그라운드에서 멈추고 돌아오면 측위동작이 재개됩니다.
  • 좌표 버퍼는 메모리 — 강제 종료 시 미전송 좌표는 사라집니다.
  • 시뮬레이터에서는 측위할 수 없습니다.