! Crear y conectar un objeto de ratón de hardware (mouse.connect)

Esta función está disponible a partir de las versiones posteriores a 20260805

Declaración

objeto_raton, mensaje_error = mouse.connect([ propiedades ])

Parámetros

• propiedades Tipo tabla, parámetro opcional para establecer las propiedades del ratón de hardware

Valores devueltos

• objeto_raton Objeto de ratón de hardware; se devuelve cuando la creación tiene éxito y nil cuando falla
• mensaje_error Tipo texto; motivo del fallo de creación

Descripción

Cada llamada crea un objeto de ratón independiente; el estado de los botones y el ciclo de vida de la conexión de cada objeto no se afectan entre sí. Un resultado correcto indica que el objeto ya se puede utilizar; que la App de destino responda depende de iOS y de la App. Esta función cede el subproceso de ejecución de Lua actual mientras espera la conexión.

propiedades es opcional. Estas son las propiedades configurables habituales y sus valores predeterminados:

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

También se pueden establecer SerialNumber y LocationID; no se garantiza que las demás propiedades surtan efecto. Transport solo afecta a la forma en que iOS o la App de destino reconoce el ratón. Establecerlo en "BluetoothLowEnergy" no crea una conexión Bluetooth, ni inicia una emisión o un emparejamiento, ni hace que el ratón aparezca en la lista Bluetooth de otros dispositivos. Si falla el envío de cualquier operación del ratón, el objeto suelta automáticamente todos los botones y se desconecta; no reintenta usando entrada táctil.

Ejemplo

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