에러 코드 | Droidline

Droidline 명령이 돌려줄 수 있는 모든 에러와 HTTP 상태, 재시도할 만한지.

번역된 페이지입니다. 영어 문서와 내용이 다르면 영어 문서가 기준입니다. English

실패한 명령은 ok: false와 함께 error(아래 코드 중 하나), msg(서버 언어로 만든 아래 메시지), retryable, 메시지에 쓰인 필드를 돌려줍니다. SDK는 코드마다 예외 클래스를 하나씩 둡니다.

`NOT_FOUND`

대상이 시간 안에 안 보임. 현재 화면(패키지/액티비티)을 screen에 함께 반환

HTTP: 422
재시도: 예

메시지 {timeout}초 동안 {target} 대상을 찾지 못했습니다. 현재 화면: {screen}

`AMBIGUOUS`

같은 대상 여러 개, strict 모드일 때만. 후보 목록 반환

HTTP: 422
재시도: 아니요

메시지 {target}에 맞는 대상이 {count}개입니다. nth를 주거나 더 좁은 속성을 쓰세요

`NOT_CLICKABLE`

노드·좌표 탭 둘 다 실패

HTTP: 422
재시도: 예

메시지 {target} 대상을 찾았지만 노드 클릭과 좌표 탭이 모두 실패했습니다

`TIMEOUT`

동작 자체가 시간 초과. 재시도 가능

HTTP: 504
재시도: 예

메시지 {cmd} 명령이 {timeout}초 안에 끝나지 않았습니다

`NO_ACCESSIBILITY`

접근성 서비스 꺼짐

HTTP: 409
재시도: 아니요

메시지 Droidline 접근성 서비스가 꺼져 있습니다. 폰에서 설정 > 접근성 > Droidline을 켜세요

`NO_IME`

자체 키보드가 입력기로 선택 안 됨. sendkey 키코드·글자, clipboard 읽기 불가

HTTP: 409
재시도: 아니요

메시지 Droidline 키보드가 현재 입력기가 아닙니다. 키코드·글자 전송이나 클립보드 읽기를 하려면 폰에서 입력기를 바꾸세요

`NO_PERMISSION`

VPN·알림 등 권한 미허용. 필요한 권한 이름 반환

HTTP: 409
재시도: 아니요

메시지 폰에서 {permission} 권한이 허용되지 않았습니다

`APP_NOT_FOUND`

패키지 없음. 비슷한 패키지명 후보

HTTP: 422
재시도: 아니요

메시지 {package} 패키지가 설치되어 있지 않습니다. 비슷한 패키지: {similar}

`ACTIVITY_BLOCKED`

공개되지 않은 액티비티 실행 시도. 패키지 기본 실행으로 대체 제안

HTTP: 422
재시도: 아니요

메시지 {activity} 화면은 공개되지 않아 다른 앱이 열 수 없습니다. 액티비티 없이 launch("{package}") 형태로 쓰세요

`MACRO_FAILED`

설정 매크로가 버튼을 못 찾음(kill, clear_data, data 등). 막힌 단계와 화면 반환

HTTP: 422
재시도: 예

메시지 {cmd} 설정 매크로가 "{step}" 단계에서 멈췄습니다. 화면: {screen}

`PROXY_FAILED`

업스트림 연결·인증 실패. reason은 auth, timeout, refused, protocol 중 하나

HTTP: 502
재시도: 예

메시지 업스트림 프록시 실패: {reason}

`UNKNOWN_CMD`

지원하지 않는 명령. 에이전트 버전 반환

HTTP: 404
재시도: 아니요

메시지 알 수 없는 명령 {cmd}. 에이전트 버전 {agent}

`UNSUPPORTED`

이 안드로이드 버전에서는 ADB·root 없이 할 수 없는 기능

HTTP: 422
재시도: 아니요

메시지 {cmd} 명령은 Android {min_release} 이상이 필요합니다. 이 폰은 Android {release} 버전입니다

`BAD_ARGS`

파라미터 누락 또는 잘못된 값

HTTP: 400
재시도: 아니요

메시지 {cmd} 인자가 잘못되었습니다: {reason}

`DEVICE_NOT_FOUND`

그 ID나 이름으로 등록된 기기가 없음

HTTP: 404
재시도: 아니요

메시지 {device} 이름의 등록된 기기가 없습니다

`DEVICE_OFFLINE`

등록은 됐지만 오프라인. 명령은 재접속을 기다렸다가 실패

HTTP: 503
재시도: 예

메시지 {device} 기기가 {timeout}초 안에 다시 연결되지 않았습니다

`DEVICE_AMBIGUOUS`

device를 주지 않았는데 온라인 기기가 여러 대

HTTP: 400
재시도: 아니요

메시지 온라인 기기가 {count}대입니다. device로 하나를 고르세요: {devices}

`AGENT_RESTARTED`

명령 처리 중 폰 앱이 재시작됨. 두 번 실행을 막기 위해 자동 재시도하지 않음

HTTP: 503
재시도: 예

메시지 {cmd} 실행 중에 {device}의 에이전트가 재시작되었습니다. 실행 여부를 확인할 수 없습니다

`UNAUTHORIZED`

클라이언트 API 토큰이 없거나 틀림

HTTP: 401
재시도: 아니요

메시지 이 연결에는 클라이언트 토큰이 필요합니다

`PAIRING_FAILED`

페어링 코드와 맞는 대기 중인 폰이 없음

HTTP: 422
재시도: 아니요

메시지 {code} 코드로 기다리는 폰이 없습니다

`INTERNAL`

버그. 서버 로그와 함께 제보해 주세요

HTTP: 500
재시도: 아니요

메시지 내부 오류: {reason}