! Создание и подключение объекта аппаратной мыши (mouse.connect)

Эта функция доступна только в версиях после 20260805.

Объявление

объект_мыши, сообщение_об_ошибке = mouse.connect([ свойства ])

Параметры

• свойства Таблица, необязательный параметр для настройки свойств аппаратной мыши.

Возвращаемые значения

• объект мыши Объект аппаратной мыши, возвращаемый при успешном создании; при ошибке создания возвращается nil.
• сообщение об ошибке Текст с причиной ошибки создания.

Описание

Каждый вызов создаёт независимый объект мыши; состояния кнопок и жизненные циклы подключений разных объектов не зависят друг от друга. Успешный возврат означает, что объект готов к использованию; реакция целевого приложения по-прежнему зависит от iOS и самого приложения. Во время ожидания подключения эта функция уступает управление текущему потоку выполнения Lua.

Параметр свойства можно не указывать. Ниже приведены часто используемые настраиваемые свойства и их значения по умолчанию:

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

Также можно задать SerialNumber и LocationID; для остальных свойств действие не гарантируется. Transport влияет только на способ распознавания мыши iOS или целевым приложением. Значение "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()