하드웨어 키보드 키 누르기 (:down)

이 메서드는 20260805 이후 버전에서만 사용할 수 있습니다

선언

성공 여부, 오류 정보 = 하드웨어 키보드 객체:down(키 코드)
성공 여부, 오류 정보 = 하드웨어 키보드 객체:down(Usage_Page, Usage_ID)

매개변수

• 키 코드 문자열이며 key.press와 동일한 키 이름 매핑을 사용합니다.
• Usage Page 정수이며 현재 하드웨어 키보드 객체는 Keyboard/Keypad Usage Page 0x07만 허용합니다.
• Usage ID 정수로 된 물리 키 번호이며 문자 인코딩이 아닙니다.

반환값

• 성공 여부 불리언입니다. 전송에 성공하면 true, 실패하면 false를 반환합니다.
• 오류 정보 문자열이며 전송에 실패하면 오류 정보를 반환합니다.

설명

하드웨어 키보드 키 하나를 누릅니다. 누른 후에는 이에 대응하는 :up을 호출하여 키를 놓아야 합니다.

• 같은 키보드에서 :press 또는 :send_text 시퀀스를 실행 중이면 이 메서드는 false, "hardware keyboard is busy"를 반환합니다.
• 동시에 최대 6개의 일반 키를 누른 상태로 유지할 수 있으며 보조 키(modifier)는 이 수에 포함되지 않습니다. 제한을 넘으면 대상 시스템에서 어떤 키인지 식별할 수 없습니다.
• 전송에 실패하면 false와 오류 정보를 반환하며 다른 입력 방식으로 자동 재시도하지 않습니다.

예제

local keyboard = assert(key.connect_keyboard())

assert(keyboard:press(0x07, 4))       -- 키보드 A
assert(keyboard:down(0x07, 0xE1))    -- 왼쪽 Shift
assert(keyboard:up(0x07, 0xE1))

assert(keyboard:disconnect())