! Simular a digitação de texto (key.send_text)

As funções de teclado de hardware descritas nesta página estão disponíveis somente a partir da versão 20260805.

Declaração

key.send_text(texto [, atraso_por_tecla, atraso_da_tecla_Shift])

Parâmetros

• texto Texto a inserir; pode conter somente letras inglesas, números, espaços, caracteres de meia largura e "\b", "\r", "\t".
• atraso_por_tecla Inteiro; atraso entre cada tecla, em milissegundos. Por padrão não há atraso e a entrada é feita no limite de desempenho do dispositivo.
• atraso_da_tecla_Shift Inteiro em milissegundos; letras maiúsculas ou alguns símbolos especiais exigem que Shift seja mantido pressionado, por exemplo, @ é Shift + 2.

Descrição

Use esta função para simular forçadamente a digitação pelo teclado quando sys.input_text não funcionar.

• Depois de conectar um teclado de hardware global, o texto será inserido por esse objeto; sem um teclado de hardware global, o comportamento original permanece.
• O teclado de hardware gera teclas e combinações com Shift usando o mapeamento de teclado americano do Lua atual; os caracteres finais ainda dependem do layout de teclado do sistema de destino.
• Ao inserir pelo teclado de hardware, as teclas que já estavam pressionadas antes da chamada são preservadas; quando o envio falha, não tenta automaticamente o método de entrada original.

Exemplo

key.send_text("AbC12#") -- digita o texto o mais rápido possível
--
key.send_text("AbC12#", 300) -- aguarda 0,3 segundo entre cada tecla