> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ones1ght.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SDK 에러 코드 안내

> OneS1ght SDK의 에러 코드를 안내합니다

## 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와 다를 때만)                |

<Warning>
  UWB 로케이터와의 통신의 디버그는 아래의 항목을 참조해 주세요. <br />
  [가이드문서 - 로그 사용법](/sdk/faq/logging)
</Warning>