! Gõ văn bản bằng bàn phím phần cứng (:send_text)

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

Khai báo

thành công hay không, thông báo lỗi = đối tượng bàn phím phần cứng:send_text(văn bản[, độ trễ mỗi phím, độ trễ phím Shift])

Tham số

• văn bản
  Chuỗi. Văn bản để gõ. Chỉ hỗ trợ các ký tự tiếng Anh, chữ số, khoảng trống, ký tự nửa chiều rộng, và các chuỗi escape "\b", "\r", và "\t".
• độ trễ mỗi phím
  Số. Tùy chọn. Thời gian trễ giữa các thao tác phím, tính bằng mili giây. Mặc định: 0.
• độ trễ phím Shift
  Số. Tùy chọn. Thời gian trễ khi nhấn hoặc thả Shift, tính bằng mili giây. Mặc định: 0.

Giá trị trả về

• thành công hay không
  Boolean. Trả về true sau khi tất cả văn bản đã được gửi thành công và false trong trường hợp thất bại.
• thông báo lỗi
  Chuỗi. Thông báo lỗi được trả về khi gửi thất bại.

Mô tả

Sử dụng bản đồ phím US của Lua hiện tại để tạo các tổ hợp phím và Shift. Trong thời gian chờ khi nhập, luồng hiện tại sẽ ngầm nhường quyền thực thi; các luồng khác có thể chạy trước khi phương thức trả về.

• Các ký tự kết quả vẫn bị ảnh hưởng bởi bố cục phím của hệ thống mục tiêu.
• Phương thức này giữ nguyên các phím thường và các phím bổ trợ đã được giữ trước khi gọi.
• Nếu bàn phím phần cứng đã đang chạy một chuỗi :press hoặc :send_text, thao tác mới sẽ trả về false, "hardware keyboard is busy".
• Các lần nhập thất bại sẽ không được thử lại thông qua phương thức nhập khác.

Ví dụ

local keyboard = assert(key.connect_keyboard())

assert(keyboard:send_text("Hello"))
assert(keyboard:send_text("Hello", 30, 10))

assert(keyboard:disconnect())