Pular para o conteúdo principal

! Criar e conectar um objeto de mouse de hardware (mouse.connect)

Esta função está disponível somente a partir da versão 20260805.

Declaração​

objeto_do_mouse, mensagem_de_erro = mouse.connect([ propriedades ])

Parâmetro​

  • propriedades Tabela, opcional: define as propriedades do mouse de hardware

Valores de retorno​

  • objeto do mouse Objeto de mouse de hardware, retornado quando a criação é bem-sucedida; em caso de falha, retorna nil
  • mensagem de erro Texto: motivo da falha de criação

Descrição​

Cada chamada cria um objeto de mouse independente; os estados dos botões e o ciclo de vida da conexão de cada objeto não se afetam. Um retorno bem-sucedido indica que o objeto pode ser usado; a resposta do app de destino ainda depende do iOS e do app. Esta função cede a thread de execução Lua atual enquanto aguarda a conexão.

propriedades pode ser omitido; estas são propriedades configuráveis comuns e seus valores padrão:

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

Também é possível definir SerialNumber e LocationID; não há garantia de que outras propriedades terão efeito. Transport afeta somente a forma como o iOS ou o app de destino identifica o mouse. Defini-lo como "BluetoothLowEnergy" não estabelece conexão, transmissão ou pareamento Bluetooth, nem faz o mouse aparecer na lista Bluetooth de outros dispositivos. Quando o envio de qualquer operação do mouse falha, o objeto libera automaticamente todos os botões e desconecta, sem tentar novamente usando entrada por toque.

Exemplo​

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