주요 에러 코드 - OneS1ght

SDK 에서 오류가 발생하면 일부 기능이 동작하지 않을 수 있지만, 기존 앱은 정상적으로 작동합니다.
SDK 에러를 조치하기 위해 코드를 변경했다면 새 앱 빌드를 게시해야 하며, 게시가 완료되면 앱 사용자에게 업데이트를 유도하세요.

에러 등급

등급	상세 내용
ERROR (오류)	특정 기능이 동작하지 않습니다. 즉시 조치가 필요합니다.
WARN (경고)	기능은 동작하지만 조치가 필요합니다.
INFO (알림)	기능은 정상 동작하며, 동작 상태를 확인할 수 있습니다.

초기화 · 인증

에러 코드	등급	상세 내용
E1001	ERROR	SDK 를 초기화하지 않고 함수를 호출했습니다.
E1002	ERROR	SDK 키를 잘못 입력했거나, 만료 또는 폐기된 키입니다.
E1003	WARN	SDK 키는 유효하지만 이 고객사에서 측위가 꺼져 있습니다. 요금제에 사용자앱 SDK 가 없거나 구독 기간이 아닙니다.
E1004	ERROR	프로필을 연결하지 않은 상태에서 측위를 시작할 수 없습니다.
E1007	ERROR	콘솔에서 측위 키를 받지 못했거나(등록되지 않음·조회 실패), 측위 엔진이 키를 거부했습니다. 이때 `buildings()`·`floors()`·`zones()` 는 빈 목록을 돌려주고, `floor()`·`setFloorMap()`·`locators()` 는 E1001 을 던집니다.

기기 · 권한

에러 코드	등급	상세 내용
E2001	WARN	지원하지 않는 OS 버전입니다.
E2002	WARN	측위 기능을 지원하지 않는 기기입니다.
E2003	WARN	측위 기능 사용 권한이 거부되었습니다. iOS 는 Info.plist 에 `NSLocationWhenInUseUsageDescription` 이 없을 때도 이 코드가 발생합니다.
E2004	WARN	블루투스가 꺼져 있습니다.

공간 설정

에러 코드	등급	상세 내용
E3001	WARN	건물 정보 없이 층을 지정했습니다.
E3002	WARN	이 층에 로케이터가 없습니다.
E3003	WARN	이 층에 측위 세션 정보가 없습니다.
E3004	WARN	이 층에 구역이 없어 이벤트가 발생하지 않습니다.
E3006	ERROR	서버에서 로케이터 정보를 조회할 수 없습니다.
E3007	WARN	BLE 신호를 받지 못해 층을 찾지 못했습니다.
E3008	ERROR	측위 엔진이 찾은 층이 콘솔과 일치하지 않습니다.
E3009	WARN	측위 엔진의 영역이 콘솔과 일치하지 않습니다.

측위

에러 코드	등급	상세 내용
E4001	ERROR	측위 세션이 종료되었거나 찾을 수 없습니다.
E4002	ERROR	사용자의 현재 위치 정보를 얻을 수 없습니다.
E4003	WARN	등록된 로케이터 중 일부가 수신되지 않습니다. 기본 제공 UWB 엔진(iOS·Android)은 로케이터별 수신을 구분하지 않아 이 코드를 내지 않고, 좌표가 나오지 않으면 E4002 로 알립니다.
E4004	WARN	측위 엔진의 구역 판정이 한 회차 실패했습니다. 좌표는 계속 나오고, 그 회차의 판정만 버려집니다.

서버 통신 · 전송

에러 코드	등급	상세 내용
E5001	ERROR	네트워크가 오프라인 상태입니다.
E5002	ERROR	SDK 서버 오류입니다.
E5003	ERROR	요청 형식이 서버와 맞지 않습니다(HTTP 422, 404 포함). 대개 SDK 와 서버 버전이 맞지 않을 때 발생합니다.
E5004	ERROR	접근 권한이 없는 리소스(건물 또는 층)입니다(HTTP 403).
E5005	ERROR	서버 응답을 처리하지 못했습니다.
E5006	WARN	전송하지 못한 좌표가 유실되었습니다.

동작 알림

코드	등급	상세 내용
I1001	INFO	SDK 초기화가 완료되었습니다.
I1002	INFO	프로필을 연결했습니다.
I3001	INFO	층을 지정했습니다.
I3002	INFO	도면이 없는 층입니다. 측위 정보는 정상적으로 전송됩니다.
I4001	INFO	측위를 시작합니다.
I4002	INFO	측위를 종료합니다.
I5001	INFO	새 전송 주기를 적용했습니다. 기본값이면 표시되지 않습니다.

Flutter 플러그인

Flutter 는 위 코드를 OneS1ghtException.code 로 그대로 전달합니다. 아래 두 코드는 Flutter 플러그인에서만 발생합니다.

코드	등급	상세 내용
unsupportedActivity	ERROR	Android 앱의 `MainActivity` 가 `FlutterFragmentActivity` 가 아니어서 권한을 요청할 수 없습니다.
internal	ERROR	플러그인 내부에서 예상하지 못한 오류가 발생했습니다.