Desconectar o teclado de hardware global (key.disconnect_global_keyboard)

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

Declaração

sucesso, mensagem_de_erro = key.disconnect_global_keyboard()

Valores retornados

• sucesso Booleano; retorna true quando a desconexão é bem-sucedida ou não há teclado de hardware global, e false quando falha.
• mensagem_de_erro Texto; retorna a mensagem de erro quando a desconexão falha.

Descrição

Libera todas as teclas e desconecta o teclado de hardware global atual. Depois da desconexão, as interfaces de teclas existentes retomam o comportamento anterior à conexão.

• Esta função pode ser chamada repetidamente; também retorna sucesso quando não há teclado de hardware global.
• Se o teclado de hardware global estiver executando uma sequência :press ou :send_text, a desconexão retornará false, "hardware keyboard is busy".
• As teclas pressionadas por key.down serão liberadas durante a desconexão; o key.up correspondente não enviará outra entrada depois disso.

Exemplo

local success, err = key.disconnect_global_keyboard()
assert(success, err)