跳至主要內容

! 建立並連接一個硬體滑鼠物件 (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()