Desconectar o teclado de hardware (:disconnect)

Este método está disponível somente a partir da versão 20260805.

Declaração

sucesso, mensagem_de_erro = objeto_teclado:disconnect()

Valores retornados

• sucesso Booleano; retorna true quando a desconexão é bem-sucedida 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 este objeto de teclado de hardware.

• Este método pode ser chamado repetidamente.
• Se o objeto for o teclado de hardware global atual, este método também remove a conexão do teclado global.
• Se o mesmo teclado de hardware estiver executando uma sequência :press ou :send_text, este método retornará false, "hardware keyboard is busy".
• Quando o Lua coletar o objeto de teclado de hardware ou o script for interrompido, o XXTouch também liberará automaticamente todas as teclas e desconectará o objeto.

Exemplo

local keyboard = assert(key.connect_keyboard())

local success, err = keyboard:disconnect()
assert(success, err)