용어집
Droidline 문서 전반에 쓰이는 용어를 짧게 설명합니다. 접근성 서비스와 선택자부터 릴레이, 경로, 토큰까지 다룹니다.
번역된 페이지입니다. 영어 문서와 내용이 다르면 영어 문서가 기준입니다. English
| 용어 | 뜻 |
|---|---|
| 접근성 서비스 (Accessibility service) | 화면에 있는 내용을 앱이 읽고 조작할 수 있게 하는 안드로이드 기능입니다. 스크린 리더나 스위치를 쓰는 사람을 위해 만들어졌습니다. Droidline 앱은 이 기능으로 요소를 보고, 탭하고, 스와이프하고, 입력합니다. |
| 액티비티 (Activity) | 안드로이드 앱의 화면 하나입니다. 예: .LoginActivity. current()는 앞에 있는 패키지와 액티비티를 돌려줍니다. |
| 에이전트 (Agent) | 폰에 설치된 Droidline 앱입니다. 서버에 접속해 명령을 수행합니다. |
| 배치 (Batch) | 폰이 혼자 한 번에 실행하는 명령 목록입니다. 비행기 모드를 껐다 켜는 것처럼 중간에 폰이 오프라인이 될 때 씁니다. 개념을 보세요. |
| 영역 (Bounds) | 요소가 화면의 어디에 있는지를 픽셀 단위 [left, top, right, bottom]으로 나타낸 값입니다. |
| 클라이언트 (Client) | 사용자 쪽입니다. 서버에 명령을 보내는 스크립트, CLI, HTTP 요청, AI 에이전트를 말합니다. |
| 조건 확인 (Condition) | 질문을 하고 실패 없이 바로 답하는 명령입니다. 예: exists, checked, get_text. |
| 콘텐츠 설명 (Desc) | 요소의 content description으로, 스크린 리더를 위해 작성된 설명입니다. 아이콘 버튼에는 이것만 있는 경우가 많습니다. |
| 기기 ID (Device ID) | 폰이 페어링할 때 서버가 부여하는 무작위 식별자입니다. 예: k7d2q9xa. 폰에는 사용자가 정하는 이름도 있습니다. |
| 화면 덤프 (Dump) | dump()가 돌려주는, 요소 트리 형태의 화면입니다. 선택자를 고를 때 출발점이 됩니다. |
| 요소 (Element) | dump에 나오는 화면 속 항목 하나입니다. 버튼, 텍스트, 입력란, 목록의 행 등입니다. |
| 에러 코드 (Error code) | NOT_FOUND처럼 실패를 나타내는 짧은 이름이며, 모든 인터페이스에서 같습니다. 에러 코드를 보세요. |
| 입력기 (IME) | Input method editor의 약자로, 안드로이드에서 키보드 앱을 부르는 이름입니다. Droidline은 자체 입력기인 Droidline 키보드를 함께 제공합니다. |
| MCP | Model Context Protocol의 약자로, AI 어시스턴트가 도구를 쓰는 표준 방식입니다. droidline mcp는 Droidline을 그런 도구 중 하나로 만듭니다. AI 에이전트를 보세요. |
| nth | 여러 요소가 일치할 때 어느 요소를 쓸지 정하는 값으로, 0부터 셉니다. |
| 패키지명 (Package name) | 안드로이드 앱의 고유한 이름입니다. 예: com.android.chrome. droidline apps로 목록을 볼 수 있습니다. |
| 페어링 (Pairing) | QR 코드나 6자리 코드로 폰과 PC를 한 번 서로 소개하는 일입니다. 둘은 키를 교환하고, 그 뒤로는 서로를 알아봅니다. |
| 릴레이 (Relay) | 인터넷에 직접 띄워 두는 작은 서버로, PC와 모바일 데이터를 쓰는 폰 사이에서 암호화된 줄을 전달합니다. 원격 연결을 보세요. |
| 리소스 ID (Resource ID) | id 속성입니다. 앱 개발자가 요소에 붙인 이름으로, 예를 들면 com.example:id/login입니다. 언어가 바뀌어도 그대로입니다. |
| 경로 (Route) | 폰이 PC에 닿는 방법입니다. lan(같은 Wi-Fi), direct(포트포워딩한 포트), tunnel, relay가 있습니다. |
| SDK | 프로그래밍 언어용 라이브러리입니다. Python은 PyPI의 droidline, Node.js는 npm의 droidline입니다. |
| 선택자 (Selector) | 요소를 고르는 속성과 값의 쌍입니다. 예: ("text", "Log in"), ("id", "email"). |
| 서버 (Server) | droidline serve. 내 코드와 폰을 이어 주는, PC에서 실행되는 프로그램입니다. |
| 타임아웃 (Timeout) | 명령이 실패하기 전에 요소를 기다리는 시간입니다. 바꾸지 않으면 10초입니다. |
| 토큰 (Token) | 다른 컴퓨터의 클라이언트가 서버를 쓸 수 있게 해 주는 비밀 문자열(dlc_...)입니다. droidline token create로 만듭니다. |
| 터널 (Tunnel) | Cloudflare Tunnel이나 ngrok처럼 PC에 공개 주소를 주는 서비스입니다. 그래서 모바일 데이터를 쓰는 폰도 PC에 닿을 수 있습니다. |
| via | 응답에서 탭이나 입력한 텍스트가 어떤 방식으로 전달됐는지 알려 주는 필드입니다. node, parent, gesture, set_text, ime 중 하나입니다. |