개발자 문서 / Android SDK
API와 연동 가이드 · 수정 2026-09-22
Android 상태와 오류
공개 상태 필드와 enum 값 전체입니다. 코드는 분기에, 번역된 메시지는 표시에 사용하세요.
| 필드 / API | 형식 / 기본값 | 계약 |
|---|
| deviceId | String · required | 서버 기기 UUID. 표시·로그용 식별자이며 비밀 키가 아닙니다. |
| deviceCode | String · required | 대시보드 연결 코드. 등록 후 제공. 길이로 형식·유효성을 추정하지 마세요. |
| 필드 / API | 형식 / 기본값 | 계약 |
|---|
| phase | SupportPhase · IDLE | 생명주기 단계. 아래 enum 참조. |
| device | DeviceRegistration? · null | 등록 스냅샷. 종료·오류 후에도 남을 수 있으며 온라인 상태가 아닙니다. |
| controlAvailable | Boolean · false | 상태 갱신 시점의 접근성 서비스 사용 가능 여부. |
| stopReason | StopReason? · null | 최근 종료 전환 사유. 해당하지 않으면 null. |
| error | SupportError? · null | 정제된 오류 분류. 해당하지 않으면 null. 원시 HTTP·토큰·SDP 미포함. |
| isActive | Boolean · computed | AWAITING_CONSENT, STARTING, WAITING_FOR_OPERATOR, CONNECTING, CONNECTED, RECONNECTING, STOPPING이면 true. REGISTERING은 false. |
| 필드 / API | 형식 / 기본값 | 계약 |
|---|
| support | SupportState · required | 기본 상태. launcher가 조작 가능 여부를 갱신합니다. |
| message | String · required | en/ko/ja 상태 또는 준비 오류 메시지. 이 문자열로 로직을 분기하지 마세요. |
| isPreparing | Boolean · required | 등록·안내·권한 준비 진행 여부. |
| preparationError | SupportPreparationError? · required | 평상시 null. 설정·동의 UI 실행 실패. 이후 start로 재시도 가능. |
| canStart | Boolean · required | 준비·활성 세션·등록이 없을 때 true. start()는 Activity RESUMED도 추가 확인. |
| canStop | Boolean · required | 준비·등록·활성 지원 단계에서 종료 가능. |
| deviceCode | String? · computed | support.device?.deviceCode. 등록 전 null. |
| controlAvailable | Boolean · computed | support.controlAvailable의 별칭. |
| 필드 / API | 형식 / 기본값 | 계약 |
|---|
| IDLE | enum | 초기화됨, 활성 요청 없음. |
| REGISTERING | enum | 설치 인스턴스 등록·인증 중. |
| READY | enum | 등록 완료, 화면공유 동의 전. |
| AWAITING_CONSENT | enum | Android 캡처 동의 대기. |
| STARTING | enum | 포그라운드 캡처 서비스 시작 중. |
| WAITING_FOR_OPERATOR | enum | 동의된 공유에서 운영자 대기. |
| CONNECTING | enum | 피어 연결 협상 중. |
| CONNECTED | enum | 인증된 피어 연결됨. |
| RECONNECTING | enum | 동의를 유지하며 연결 복구 중. |
| STOPPING | enum | 명시적 종료 진행 중. |
| STOPPED | enum | 공유 종료, stopReason 확인. |
| ERROR | enum | 실패, error와 필요 시 stopReason 확인. |
| 필드 / API | 형식 / 기본값 | 계약 |
|---|
| USER | enum | 호스트·사용자가 지원 종료. |
| OPERATOR | enum | 원격 운영자가 지원 종료. |
| SYSTEM | enum | Android가 캡처 철회 또는 서비스 종료. |
| TIMEOUT | enum | 설정된 세션 시간이 만료됨. |
| PERMISSION_DENIED | enum | 캡처 승인 거부·무효 또는 Activity 사용 불가. |
| ERROR | enum | 오류로 지원·준비 종료. |
| 필드 / API | 형식 / 기본값 | 계약 |
|---|
| REGISTRATION_FAILED | enum | 등록·초기 인증 실패. 설정·통신 확인 후 재시도. |
| AUTHENTICATION_FAILED | enum | 세션·기기 인증 실패. 등록과 계정 권한 확인. |
| NETWORK_UNAVAILABLE | enum | 네트워크 실패 분류. 통신 확인. |
| CAPTURE_FAILED | enum | 화면 캡처 시작·유지 실패. 새 승인 요청. |
| CONNECTION_FAILED | enum | 피어 연결 실패 분류. 시그널링·TURN 확인. |
| SERVICE_START_FAILED | enum | Android가 포그라운드 서비스 시작 거부. 표시된 Activity에서 시작. |
| 필드 / API | 형식 / 기본값 | 계약 |
|---|
| ACCEPTED | enum | 준비 접수, 연결 보장 아님. |
| ALREADY_ACTIVE | enum | 지원이 이미 활성화됨. |
| BUSY | enum | 준비·등록이 이미 진행 중. |
| HOST_NOT_RESUMED | enum | Activity가 RESUMED가 아니거나 종료 중·파괴됨. |
| 필드 / API | 형식 / 기본값 | 계약 |
|---|
| SETTINGS_UNAVAILABLE | enum | 접근성 설정 실행 실패. |
| CAPTURE_CONSENT_UNAVAILABLE | enum | Android 캡처 동의 실행 실패. |