Nhấn giữ một phím trên bàn phím phần cứng (:down)

Phương thức này có sẵn trong các phiên bản sau 20260805

Khai báo

success, err = keyboard:down(key)
success, err = keyboard:down(usage_page, usage_id)

Tham số

• key Chuỗi. Sử dụng cùng bảng ánh xạ tên phím như key.press.
• usage_page Số nguyên. Các đối tượng bàn phím phần cứng hiện tại chỉ chấp nhận Trang Sử dụng của Bàn Phím/Phím Bấm 0x07.
• usage_id Số nguyên. Biểu tượng vật lý của phím, không phải mã hóa ký tự.

Giá trị trả về

• success Boolean. Trả về true khi phím được giữ thành công và false khi thất bại.
• err Chuỗi. Thông báo lỗi được trả về khi gửi thất bại.

Mô tả

Nhấn giữ một phím trên bàn phím phần cứng. Gọi phương thức tương ứng :up sau đó để thả nó.

• Nếu cùng một bàn phím đang chạy một chuỗi :press hoặc :send_text, phương thức này sẽ trả về false, "hardware keyboard is busy".
• Có thể giữ tối đa sáu phím thường cùng lúc; các phím bổ trợ không được tính vào giới hạn này.
• Khi thất bại, phương thức sẽ trả về false và một thông báo lỗi. Nó không được thử lại thông qua một phương thức đầu vào khác.

Ví dụ

local keyboard = assert(key.connect_keyboard())

assert(keyboard:press(0x07, 4))       -- Bàn phím A
assert(keyboard:down(0x07, 0xE1))    -- Phím Shift trái
assert(keyboard:up(0x07, 0xE1))

assert(keyboard:disconnect())