Send keys to device — Aurora Agent Commands

Aurora Agent가 실행 중인 장치에 키 입력, 좌표 클릭(터치), 대기 시간을 한 표현식으로 순서대로 전송합니다. 장치가 알려준 지원 기능에 따라 키보드/키패드, 마우스/터치가 자동으로 선택됩니다. 공통 필드와 장치 등록 방법은 Aurora agent 명령어 개요를 참고하세요.

매개변수

Argument	Type	Description
Aurora agent alias	선택	명령을 보낼 Aurora agent 장치 별칭
Expression (Keys)	문자열	전송 순서 표현식 — `키이름,(x,y),대기시간,...` 형식, `,` 구분, 변수 사용 가능
Insert keypad key	—	연결된 Agent의 키패드 키 이름을 표현식 커서 위치에 삽입
Insert x,y coordinates	—	장치 화면을 받아 클릭한 위치를 `(x,y)` 형식으로 삽입
Get device screen	—	장치 화면 미리 보기·수동 제어 창 열기
Delay	숫자	명령어 실행 후 대기 시간 (Milliseconds)
Description	텍스트	명령어 설명 (선택)

반환값

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

여러 항목을 나열한 경우 마지막으로 전송한 항목의 결과가 반환값이 되며, 중간 항목이 실패(0 이하)하면 그 지점에서 중단됩니다.

설명

표현식 형식

표현식은 , 로 구분된 항목을 왼쪽부터 순서대로 처리합니다. 예: pagedown,(10,10),1000,up

항목 형태	동작
`(x,y)`	좌표 클릭 — Agent가 마우스를 지원하면 마우스 왼쪽 클릭, 아니면 터치로 전송
숫자만 (예: `1000`)	해당 밀리초만큼 대기
그 외 문자열 (예: `enter`, `ctrl+c`, `F5`, `HOME`)	Agent가 키보드를 지원하면 키보드 키 입력, 아니면 키패드 키 이름으로 해석하여 전송

키보드 키 문자열은 공백을 제거하고 대소문자를 구분하지 않으며, 다음 조합·키 이름을 인식합니다.

조합 접두어: CTRL+, ALT+, SHIFT+, CTRL+ALT+, CTRL+SHIFT+, SHIFT+ALT+
한 글자 키: A~~Z, 0~~9 등 (한 글자를 그대로 가상 키 코드로 사용)
특수 키: UP, DOWN, LEFT, RIGHT, TAB, ENTER, HOME, END, PAGEUP, PAGEDOWN, INSERT, DELETE, SPACE, F1~F12

표현식에는 문자열 입력 기능이 없습니다. 두 글자 이상이면서 위 목록에 없는 문자열(예: abc)은 키 이름으로 해석되어 no supported VKcode 오류가 됩니다. 문자열을 입력하려면 글자를 , 로 나누어 한 글자씩 나열하세요.

오류 처리

디버그 메시지	원인
`expression is empty`	표현식이 비어 있음
`send expression syntax error`	`(x,y)` 짝이 맞지 않거나 좌표가 숫자가 아님, `(x` 뒤에 `y)` 가 아닌 항목이 옴
`no supported VKcode`	인식할 수 없는 키 이름 (키보드 미지원 장치에서는 키패드 이름 목록에 없는 경우)
`timeout`	Agent가 3초 안에 응답하지 않음
`connectivity is not connected`	장치에 접속할 수 없음

Insert keypad key 버튼은 명령어 창을 열 때 장치에 접속해 키패드 키 이름 목록을 가져옵니다. 버튼이 비활성이라면 장치가 연결되지 않았거나 키패드를 지원하지 않는 Agent입니다. 좌표는 직접 입력하기보다 Insert x,y coordinates 버튼으로 장치 화면에서 클릭해 삽입하는 것이 정확합니다.

표현식에 대기 시간만 있고 전송 항목이 없으면(예: 1000) 실제 전송이 없어 반환값은 0 입니다. 이 명령어는 Aurora agent 장치 전용이며, 로컬 PC 키 입력은 Send keys를 사용하세요.