SDK 에러 코드 안내 - OneS1ght

SDK 에러 코드 요약

코드계열	상세
`1xxx`	SDK 초기화 및 인증 관련
`2xxx`	모바일 기기 관련
`3xxx`	공간정보 관련
`4xxx`	측위 관련
`5xxx`	OneS1ght 서버 간 통신 관련
`Ixxxx`	SDK 동작 알림

1000번대 — SDK 초기화 및 인증 관련

코드	뜻
`E1001`	SDK 초기화를 실패하였습니다.
`E1002`	유효하지 않은 SDK API 키입니다.
`E1003`	콘솔에서 측위정보가 설정되지 않았습니다.
`E1004`	모바일 사용자의 프로필이 등록되지 않았습니다.

2000번대 — 모바일 기기 관련

코드	뜻
`E2001`	지원하지 않는 iOS 버전입니다.
`E2002`	Nearby Interaction 을 지원하지 않는 기기입니다.
`E2003`	Nearby Interaction 사용자 권한이 없습니다.

3000번대 — 공간정보 관련

코드	뜻
`E3001`	측위정보를 수집할 층을 선택하지 않았습니다.
`E3002`	선택한 층에 로케이터가 없습니다.
`E3003`	선택한 층에 세션정보를 찾을 수 없습니다.
`E3004`	선택한 층에 구역이 존재하지 않습니다.

4000번대 — 측위 관련

코드	뜻
`E4001`	선택한 층의 세션을 찾을 수 없습니다.
`E4002`	등록된 좌표와 실제 공간 배치가 일치하지 않습니다.
`E4003`	일부 로케이터 신호를 찾을 수 없습니다.

5000번대 — OneS1ght 서버 간 통신 관련

코드	뜻
`E5001`	네트워크에 접속할 수 없습니다.
`E5002`	OneS1ght 측 내부 서버 오류가 발생하였습니다.
`E5003`	SDK 버전을 최신화 해주세요.
`E5004`	API Key 인증을 실패하였습니다.
`E5005`	서버 응답을 받지 못하였습니다.
`E5006`	좌표 정보를 전송하지 못하였습니다.

SDK 동작 알림

동작 알림은 에러가 아닌 SDK 내부 동작 안내 로그입니다.

코드	뜻	예시
`I1001`	초기화 완료	`tenant=…`
`I1002`	프로필 연결	—
`I3001`	층 지정	`building=… floor=… locators=N zones=M`
`I4001`	측위 시작	`visitor=v-20260820-001`
`I4002`	측위 종료	`visitor=… points=N`
`I5001`	전송 주기 적용	`rate=20` (기본값 4와 다를 때만)

UWB 로케이터와의 통신의 디버그는 아래의 항목을 참조해 주세요.
가이드문서 - 로그 사용법