Chuyển tới nội dung chính

! Kết nối bàn phím phần cứng toàn cục (key.connect_global_keyboard)

Hàm này có sẵn trong các phiên bản sau 20260805

Khai báo​

keyboard, err = key.connect_global_keyboard([properties])

Tham số​

  • properties Bảng. Tùy chọn. Sử dụng cùng các thuộc tính mặc định và ràng buộc như key.connect_keyboard.

Giá trị trả về​

  • keyboard Đối tượng bàn phím phần cứng. Trả về nil nếu kết nối thất bại.
  • err Chuỗi. Thông báo lỗi được trả về khi kết nối thất bại.

Trong trường hợp thất bại, hai giá trị trả về là nil, error.

Mô tả​

Tạo và kết nối bàn phím phần cứng toàn cục. Trong khi chờ kết nối, 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 hàm trả về.

  • Sau khi kết nối, các đầu vào từ bàn phím và bàn phím số từ key.press, key.down, key.up, key.send_text, và key(...):press/down/up sử dụng đối tượng này
  • Các phím media và phím do nhà cung cấp định nghĩa giữ hành vi trước đó
  • Khi không có bàn phím phần cứng toàn cục nào được kết nối, các API hiện có hoạt động như trước.
  • Một lần gọi key.down vẫn được kết hợp với key.up tương ứng của nó, ngay cả khi kết nối thay đổi giữa các lần gọi, ngăn chặn đầu vào trùng lặp hoặc giải phóng không chính xác
  • Chỉ có một bàn phím phần cứng toàn cục có thể được kết nối cùng một lúc. Gọi hàm này lần nữa trong khi kết nối đang diễn ra hoặc khi đã có bàn phím toàn cục nào đó đã kết nối sẽ trả về thất bại.

Ví dụ​

local keyboard, err = key.connect_global_keyboard({
    Product = "XXTouch Keyboard",
})
assert(keyboard, err)

key.press("A")
key.send_text("Hello")

local current = key.get_global_keyboard()
assert(current == keyboard)

assert(key.disconnect_global_keyboard())