メインコンテンツまでスキップ

! ハードウェアマウスオブジェクトを作成して接続する (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" に設定しても、Bluetooth 接続、アドバタイズ、ペアリングは行われず、他のデバイスの Bluetooth リストにもマウスは表示されません。 マウス操作の送信に失敗すると、このオブジェクトはすべてのボタンを自動的に離して切断します。タッチ入力に切り替えて再試行することはありません。

使用例​

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