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

Tạo và kết nối đối tượng chuột phần cứng (mouse.connect)

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

Khai báo​

mouse_obj, error_message = mouse.connect([ properties ])

Tham số​

  • properties Bảng, tùy chọn. Thiết lập thuộc tính chuột phần cứng.

Giá trị trả về​

  • mouse_obj Đối tượng chuột phần cứng thành công; nil nếu tạo thất bại.
  • error_message Chuỗi. Lý do tạo thất bại.

Mô tả​

Mỗi lần gọi tạo một đối tượng chuột độc lập với trạng thái nút và chu kỳ kết nối riêng. Trả về thành công có nghĩa đối tượng sẵn sàng sử dụng; liệu ứng dụng mục tiêu có phản hồi vẫn phụ thuộc vào iOS và ứng dụng. Hàm này sẽ nhường quyền thực thi của luồng Lua hiện tại trong khi chờ kết nối.

properties có thể bỏ qua. Dưới đây là các thuộc tính cấu hình thường dùng và giá trị mặc định:

{
    VendorID = 0x5858,
    ProductID = 0x0006,
    VersionNumber = 1,
    Product = "XXTouch Mouse",
    Manufacturer = "XXTouch",
    Transport = "USB",
}

Bạn cũng có thể thiết lập SerialNumber và LocationID. Các thuộc tính khác không được đảm bảo có hiệu lực. Transport chỉ ảnh hưởng đến cách iOS hoặc ứng dụng mục tiêu nhận diện chuột. Thiết lập "BluetoothLowEnergy" không tạo kết nối Bluetooth, quảng bá hoặc ghép nối thiết bị, cũng không làm nó xuất hiện trong danh sách Bluetooth của thiết bị khác. Nếu bất kỳ thao tác chuột nào thất bại trong việc gửi đầu vào, đối tượng sẽ tự động giải phóng tất cả các nút và ngắt kết nối. Thao tác không được thử lại như đầu vào chạm.

Ví dụ​

local m, err = mouse.connect({
    Product = "XXTouch Mouse",
})
assert(m, err)

assert(m:move(100, 0))
assert(m:down("left"))
assert(m:move(100, 50))
assert(m:up("left"))
assert(m:click("right", 60))
assert(m:click(13))
assert(m:scroll(0, 10))

m:disconnect()