> ## 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.

# 주요 에러 코드

> [!NOTE]
>
> 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 | 플러그인 내부에서 예상하지 못한 오류가 발생했습니다. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.