Pular para o conteúdo principal

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