EmuloMobile

Como automatizar teclado numérico embaralhado no Android

Configure o EmuloMobile para digitar uma senha de 4 a 10 dígitos em teclado Android embaralhado, capturando cada número e mantendo a senha no aparelho.

Por Sertta 8 min de leitura
automação de teclado embaralhado macro para teclado virtual Android automação de senha numérica tutorial EmuloMobile EmuloMobile

Uma macro baseada em coordenadas fixas não consegue digitar uma senha com segurança quando as teclas numéricas mudam de lugar. O primeiro dígito pode estar na posição esperada, enquanto a próxima renderização coloca o mesmo número em outro ponto. Repetir uma sequência salva de toques pode inserir o valor errado e enviá-lo antes que o erro fique evidente.

O EmuloMobile tem uma ação Teclado Virtual específica para esse cenário. Em vez de guardar uma coordenada para cada dígito da senha, você captura uma referência visual para cada glifo de 0 a 9. Durante a execução, a ação procura o número necessário em uma imagem nova da tela antes de cada toque, digita a senha guardada localmente e toca no ponto de confirmação configurado.

Use esse recurso somente em contas e serviços que permitam automação. Ele opera um teclado que você está autorizado a usar; não contorna autenticação, controle de acesso nem regras do serviço.

Quando usar a ação Teclado Virtual

Essa ação é adequada quando todas estas condições são verdadeiras:

  • a tela pede uma senha ou subsenha numérica com 4 a 10 dígitos;
  • as teclas são desenhadas na tela e podem mudar de posição;
  • os glifos de 0 a 9 mantêm um estilo visual reconhecível;
  • existe um botão Confirmar em um ponto previsível da tela;
  • a macro consegue identificar quando aquele teclado está realmente aberto.

Para um botão com rótulo que muda de posição, a ação Tocar no texto com OCR no aparelho costuma ser mais simples. Para um teclado estático, uma sequência de toques protegida por condição pode bastar. Teclado Virtual resolve especificamente o caso em que o fluxo precisa localizar os dígitos novamente conforme o layout muda.

Prepare a tela antes de editar a macro

Abra o app de destino e navegue até o teclado. Deixe os dez dígitos e o botão Confirmar visíveis. Crie e execute a macro na mesma resolução e orientação: o EmuloMobile associa a macro às dimensões e ao modo da tela, portanto uma alteração exige voltar a uma exibição compatível antes de editar ou rodar o fluxo.

Escolha referências visuais limpas. Uma boa captura contém o glifo e uma parte suficiente do fundo da tecla para diferenciá-la, sem incluir teclas vizinhas, animações, saldos, nomes de usuário ou outro conteúdo variável. Se a tecla tem um estado pressionado, capture a aparência normal, em repouso.

Se o serviço alterar tema, fonte, escala ou cor do teclado, planeje recapturar as referências afetadas. Um template representa a aparência atual da tecla; ele não descreve semanticamente todos os designs possíveis.

Como configurar um teclado embaralhado no EmuloMobile

Comece com a macro aberta no construtor e o teclado de destino visível por trás dele.

1. Adicione a ação Teclado Virtual

Adicione uma nova ação, abra a seção Senha e escolha Teclado Virtual. O editor mantém um conjunto separado de imagens dos dígitos para esse teclado. Assim, outro passo Teclado Virtual pode usar um design diferente sem compartilhar as referências.

Não vincule a ação a um estado genérico da tela. Adicione uma condição específica do pedido de senha, como um título estável, o painel do teclado ou um rótulo próximo. A condição é avaliada antes da ação. Um gatilho preciso reduz a chance de o passo rodar em outra tela numérica.

Se você ainda está montando o primeiro fluxo visual, consulte antes o guia de automação Android diretamente no aparelho.

2. Capture os dígitos de 0 a 9

O editor mostra Dígitos do teclado (0/10) e um controle de captura para cada número. Selecione 0, posicione a região ao vivo sobre a tecla zero e confirme. Repita o processo para 1 até 9, até o contador chegar a 10/10.

Capture uma tecla por vez. Mantenha o recorte justo e consistente entre as dez referências. Se a verificação de OCR avisar que um dígito capturado parece outro valor, revise o recorte e faça uma nova captura em vez de ignorar uma divergência clara.

A configuração não fica completa apenas com os números que aparecem na senha atual. As dez referências são obrigatórias. Esse catálogo completo permite trocar a senha depois sem reconstruir a parte visual da ação.

3. Defina o ponto do botão Confirmar

Escolha Definir botão Confirmar, mova a mira ao vivo para o centro do controle final e aceite o ponto. Os dígitos são localizados visualmente durante a execução, mas Confirmar usa uma coordenada configurada. Posicione-a longe das bordas e confira se banners ou o teclado do sistema não deslocam o botão.

Essa diferença orienta a manutenção: se o layout dos números mudou, recapture os dígitos; se o botão Confirmar mudou, defina o ponto novamente.

4. Cadastre a senha numérica

Informe uma senha com 4 a 10 dígitos. O editor não aceita letras nem valores fora desse intervalo. O campo fica mascarado e pode ser revelado enquanto você confere o conteúdo.

A senha não é gravada no arquivo da macro. O EmuloMobile a cifra com uma chave do Android Keystore e a mantém para esse teclado neste aparelho. Ela não entra no pacote da macro, na sincronização em nuvem nem no compartilhamento. A Sertta não consegue ler nem recuperar esse valor.

Esse limite tem uma consequência prática: depois de mover ou baixar a macro em outro aparelho, abra o passo Teclado Virtual nele e cadastre a senha novamente. A macro pode levar as referências dos dígitos e o ponto Confirmar, mas não esse segredo local.

Ao editar uma ação já configurada, deixe o campo da senha vazio para manter o valor armazenado no aparelho. Informar outro número substitui o anterior quando você confirma o editor.

5. Salve o passo e a macro

A ação só pode ser adicionada quando os dez dígitos, o ponto Confirmar e uma senha local válida estiverem presentes. Confirme a ação e depois use o controle explícito Salvar do construtor. Sair com alterações não salvas não incorpora a nova configuração à macro armazenada.

O que acontece durante a execução

Quando as condições da ação são atendidas, o EmuloMobile carrega as dez referências e a senha guardada no aparelho. Para cada caractere da senha, ele:

  1. captura uma imagem nova da tela atual;
  2. procura a referência visual do dígito necessário;
  3. confere o glifo candidato com OCR quando consegue chegar a uma decisão clara;
  4. toca no centro da tecla aceita;
  5. espera brevemente antes de localizar o próximo dígito.

Usar uma nova imagem para cada número é importante em teclados que se reorganizam ou animam depois do toque. Ao terminar, a ação toca no ponto Confirmar e aguarda o fechamento do painel.

O limiar inicial de correspondência dos números é 82% no modelo da ação. Trate a recaptura de uma referência fraca como primeira correção. Reduzir indiscriminadamente a exigência de reconhecimento tornaria teclas visualmente parecidas mais difíceis de distinguir com segurança.

Entenda as salvaguardas de parada

A digitação de senha deve parar quando a tela não pode ser interpretada de forma confiável. Por isso, a ação Teclado Virtual tem duas interrupções relevantes.

Se uma tecla necessária não for identificada com segurança, a ação não toca em Confirmar e a macro para nessa primeira falha de detecção. Abra o app, leia o aviso e recapture as referências antes de tentar novamente.

A ação também acompanha os envios concluídos de cada teclado configurado. Se duas confirmações ocorreram em até 30 segundos e o mesmo teclado aciona a ação novamente dentro dessa janela, o EmuloMobile para antes de digitar pela terceira vez. O aviso orienta revisar três causas prováveis:

  • a senha cadastrada está incorreta;
  • o ponto Confirmar está incorreto;
  • a condição de gatilho está permitindo um ciclo indesejado.

Isso não prova que o serviço remoto rejeitou a senha; o app não deduz o estado da conta. É uma proteção local contra reenvios rápidos quando o teclado continua voltando.

Teste com um checklist controlado

Rode a macro enquanto você consegue observar o teclado e interrompê-la imediatamente. Confira:

  1. a ação fica parada até o pedido de senha aparecer;
  2. todos os números necessários recebem toque, inclusive dígitos repetidos;
  3. uma mudança de posição após um toque não leva o toque seguinte à coordenada antiga;
  4. Confirmar recebe um único toque no centro;
  5. o painel fecha e o fluxo segue para a tela esperada;
  6. parar e iniciar a macro não pede novo cadastro no mesmo aparelho;
  7. uma referência propositalmente desatualizada faz a ação parar, sem enviar uma sequência incerta.

Não teste vários envios errados em uma conta real. Sempre que possível, valide as capturas e o gatilho em uma tela ou conta de teste e respeite qualquer política de bloqueio definida pelo serviço.

Em fluxos maiores, você pode usar variáveis e ações condicionais para registrar o que deve acontecer depois do teclado. Mantenha esse estado separado da senha: variáveis pertencem à lógica da macro durante a execução, enquanto o segredo numérico permanece no cofre do aparelho.

Faça manutenção quando a tela mudar

Reabra o passo depois de qualquer mudança na interface de destino. Recapture um número se o glifo ou o fundo da tecla foi alterado. Redefina Confirmar se o botão mudou de lugar. Revise a condição de gatilho se o mesmo painel numérico puder aparecer em mais de um contexto.

Cadastre a senha novamente ao trocar de aparelho, restaurar um ambiente que não tenha mais acesso à chave do Android Keystore ou substituir o segredo de propósito. A resposta correta para uma senha local ausente é digitá-la outra vez, não colocá-la em nota, variável, nome de arquivo ou macro compartilhada.

Transforme o teclado móvel em um passo explícito

Um teclado embaralhado só é imprevisível quando a macro o trata como uma grade fixa. Capturar cada dígito, proteger o gatilho e manter a senha fora do arquivo transforma esse layout variável em um passo que pode ser inspecionado e mantido.

Conheça o EmuloMobile e crie automações visuais Android diretamente no aparelho.