Press keypad (Legacy) — Aurora Agent Commands

Aurora Agent 장치의 하드 키패드 키를 키 이름으로 지정해 누릅니다. 이전 버전과의 호환을 위해 유지되는 레거시 명령어입니다.

새 스크립트에서는 키패드 키·좌표·대기시간을 함께 나열할 수 있는 Send keys to device 사용을 권장합니다.

매개변수

Argument	Type	Description
Aurora agent alias	선택	키를 보낼 Aurora agent 장치 별칭
Key name to press	문자열	누를 키패드 키 이름 — 여러 키는 `,` 로 구분, 숫자 항목은 대기 시간(ms), 변수 사용 가능
Insert keypad key	—	연결된 Agent의 키패드 키 이름 목록에서 선택해 입력 필드를 채움 (기존 내용을 교체)
Get device screen	—	장치 화면 미리 보기·수동 제어 창 열기
Delay	숫자	명령어 실행 후 대기 시간 (Milliseconds)
Description	텍스트	명령어 설명 (선택)

반환값

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

여러 키를 나열하면 마지막으로 전송한 키의 결과가 반환되며, 알 수 없는 키 이름을 만나면 그 지점에서 중단됩니다.

설명

키 이름은 Agent가 연결 시 알려준 키패드 키 맵(최대 32개)에서 찾아 키 코드로 변환한 뒤, 한 번 눌렀다 떼는(PRESS) 동작으로 전송합니다. 키 이름은 대소문자를 구분합니다.
, 로 구분한 항목 중 숫자만으로 된 항목은 키가 아니라 해당 밀리초만큼 대기합니다. 예: HOME,500,BACK
이 명령어에서는 Insert x,y coordinates 버튼이 비활성화됩니다.
스크립트 목록에는 Press the keypad on the '<alias>'(device). name of key: '<키 이름>' 형식으로 표시됩니다.

디버그 메시지	원인
`expression is empty`	키 이름이 비어 있음
`not exist key code`	키 맵에 없는 키 이름이거나 Agent가 키패드를 지원하지 않음
`timeout`	Agent가 3초 안에 응답하지 않음
`connectivity is not connected`	장치에 접속할 수 없음

Agent가 키패드를 지원하지 않는 장치(예: 일반 PC)에서는 Insert keypad key 버튼이 비활성화되고, 어떤 키 이름을 지정해도 not exist key code 오류가 됩니다. 이 경우 Send keys to device로 키보드 키를 전송하세요.