! Conectar um teclado de hardware global (key.connect_global_keyboard)

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

Declaração

objeto_teclado, mensagem_de_erro = key.connect_global_keyboard([atributos_de_configuracao])

Parâmetros

• atributos_de_configuracao
  Tabela opcional; usa os mesmos atributos padrão e restrições de key.connect_keyboard.

Valores retornados

• objeto_teclado
  Objeto de teclado de hardware; retornado quando a conexão é bem-sucedida, e nil quando falha.
• mensagem_de_erro
  Texto; retorna a mensagem de erro quando a conexão falha.

Quando a conexão falha, os dois valores retornados são nil, error.

Descrição

Cria e conecta um teclado de hardware global. Durante a espera pela conexão, a execução é cedida implicitamente e outras threads podem ter a oportunidade de executar antes do retorno da função.

• Depois da conexão, as teclas comuns e do teclado numérico das interfaces existentes key.press, key.down, key.up, key.send_text e key(...):press/down/up serão inseridas por este objeto.
• As teclas de mídia e as teclas personalizadas do fabricante mantêm o comportamento original.
• Sem um teclado de hardware global, o comportamento das interfaces existentes não muda.
• key.down e o key.up correspondente permanecem pareados; mesmo que o estado da conexão mude entre as chamadas, não haverá entrada duplicada nem liberação incorreta.
• Somente um teclado de hardware global pode ser conectado por vez. Uma nova chamada durante uma conexão incompleta ou quando já houver um teclado global retornará falha.

Exemplo

local keyboard, err = key.connect_global_keyboard({
    Product = "XXTouch Keyboard",
})
assert(keyboard, err)

key.press("A")
key.send_text("Hello")

local current = key.get_global_keyboard()
assert(current == keyboard)

assert(key.disconnect_global_keyboard())