Touch (Legacy) — Aurora Agent Commands

Aurora Agent 장치의 화면 좌표를 한 번 터치합니다. 이전 버전과의 호환을 위해 유지되는 레거시 명령어입니다.

새 스크립트에서는 (x,y) 항목으로 좌표 클릭·터치를 보낼 수 있는 Send keys to device 사용을 권장합니다.

매개변수

Argument	Type	Description
Aurora agent alias	선택	터치를 보낼 Aurora agent 장치 별칭
Coordinate (x,y)	문자열	터치 좌표 표시 필드 — `Insert x,y coordinates` 버튼으로 채움 (비어 있으면 실행 불가)
Insert x,y coordinates	—	장치 화면을 받아 클릭한 위치를 터치 좌표로 지정 (기존 내용을 교체)
Get device screen	—	장치 화면 미리 보기·수동 제어 창 열기
Delay	숫자	명령어 실행 후 대기 시간 (Milliseconds)
Description	텍스트	명령어 설명 (선택)

성공 시 1, 실패 시 0, 오류 시 음수 코드가 mReturnValue에 저장됩니다.

터치는 짧게 누르고 떼는 TOUCH 동작 한 번으로 전송됩니다.
실제로 전송되는 좌표는 Insert x,y coordinates 버튼으로 장치 화면에서 클릭해 저장한 위치입니다. Coordinate (x,y) 필드의 텍스트는 표시·확인용이며, 이 필드에 좌표를 직접 타이핑하거나 변수로 바꿔도 전송 좌표에는 반영되지 않습니다. 좌표를 바꾸려면 버튼으로 다시 선택하세요.
좌표를 선택하지 않은 상태에서 필드에 텍스트만 있으면 (0,0) 이 전송됩니다.
이 명령어에서는 Insert keypad key 버튼이 비활성화됩니다.
스크립트 목록에는 Touch the '<alias>'(device). coordinate: '<좌표>' 형식으로 표시됩니다.

디버그 메시지	원인
`expression is empty`	`Coordinate (x,y)` 필드가 비어 있음
`timeout`	Agent가 3초 안에 응답하지 않음
`connectivity is not connected`	장치에 접속할 수 없음

좌표 기반 터치는 장치 해상도나 화면 구성이 바뀌면 동작이 깨집니다. 화면 요소를 이미지로 찾아 클릭하려면 Search for image on 에서 Aurora agent 별칭을 선택할 수 있는 Click found image를 사용하세요.