跳到主要内容

! 创建并连接一个硬件鼠标对象 (mouse.connect)

该函数在 20260805 以后版本方可使用

声明​

鼠标对象, 错误信息 = mouse.connect([ 属性 ])

参数​

  • 属性 表型，可选参数，用于设置硬件鼠标属性

返回值​

  • 鼠标对象 硬件鼠标对象，创建成功时返回；创建失败时返回 nil
  • 错误信息 文本型，创建失败的原因

说明​

每次调用都会创建独立的鼠标对象，各对象的按键状态和连接生命周期互不影响。返回成功表示该对象已经可以调用；目标 App 是否响应仍取决于 iOS 和 App。 该函数会在等待连接时让出当前 Lua 执行线程。

属性 可省略，以下是常用可配置属性及其默认值：

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

还可以设置 SerialNumber 和 LocationID；其它属性不保证生效。 Transport 只影响 iOS 或目标 App 识别鼠标的方式。设为 "BluetoothLowEnergy" 不会建立蓝牙连接、广播或配对，也不会让鼠标出现在其它设备的蓝牙列表中。 任意鼠标操作发送失败时，该对象会自动释放全部按键并断开，不会改用触摸输入重试。

示例​

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()