Um toque por coordenada fixa pressupõe que o alvo voltará ao mesmo ponto. Um botão dentro de uma lista variável, um card posicionado depois de um conteúdo dinâmico ou um ícone que se move quando surge um aviso pode quebrar essa premissa mesmo que o alvo continue com a mesma aparência.
O EmuloAgent oferece a ação Clique na imagem para esse cenário. Você captura o alvo visual, define onde a macro deve procurá-lo e deixa a ação tocar na posição encontrada no quadro atual do emulador. É possível clicar em um resultado ou em todas as ocorrências e escolher clique simples, duplo, longo ou repetido.
Use automação apenas onde o aplicativo, jogo ou serviço permitir. Encontrar um alvo por imagem torna o posicionamento mais adaptável; isso não altera regras de terceiros.
Escolha Clique na imagem quando o alvo se move
Use a ação Toque quando o ponto em si for estável e significativo. Use Clique na imagem quando a aparência do alvo for estável, mas a posição puder mudar.
Alguns exemplos:
- um botão que desce quando aparece um conteúdo opcional;
- o mesmo ícone repetido em uma grade ou lista fixa;
- um controle que pode ocupar posições diferentes entre execuções;
- um alvo visual sem texto confiável;
- um botão cuja posição atual importa mais do que as coordenadas salvas.
Essa ação é diferente de uma condição por imagem. A condição responde se a referência está presente e decide se uma ação associada pode executar. Clique na imagem procura a referência e toca na posição encontrada. Quando outra ação precisa depender da presença da imagem, use uma condição por imagem.
Prepare uma referência visual limpa
Antes de abrir o construtor, conecte o perfil de emulador correto e deixe a tela em um estado representativo. Mantenha o perfil na resolução em que a macro será executada.
Escolha um alvo com detalhes suficientes para diferenciá-lo dos controles vizinhos. Um ícone ou botão compacto costuma funcionar melhor do que uma linha inteira com texto, contador, horário ou animação. Evite capturar sombras e áreas de fundo que mudam enquanto o alvo permanece igual.
Se o alvo for animado, pare em um quadro repetível ou selecione uma parte estável. A macro compara a referência salva com a tela atual; uma imagem dominada por pixels variáveis é mais difícil de reconhecer de forma consistente.
Como adicionar a ação Clique na imagem
Abra a automação e siga estas etapas:
- Selecione Adicionar Ação.
- Na seção Gesto, escolha Clique na imagem.
- Desenhe um retângulo justo ao redor do alvo na captura do emulador.
- Ajuste a Precisão para rejeitar elementos parecidos sem descartar diferenças normais de renderização.
- Confirme a imagem de referência.
- Revise o novo card da ação e salve a macro.
A ação começa com uma região de detecção ao redor do alvo capturado. Durante a execução, o EmuloAgent procura a referência nessa área e toca no centro de um resultado em vez de repetir as coordenadas originais da captura.
Faça primeiro um teste curto com o alvo na posição capturada. Depois, reproduza a mudança de layout esperada e confirme que a ação acompanha o alvo dentro da região de detecção.
Separe a imagem de referência da região de detecção
Os dois retângulos resolvem problemas diferentes:
- a imagem de referência descreve o que o EmuloAgent deve encontrar;
- a região de detecção limita onde ele pode procurar.
Abra o menu da ação e use Editar imagem para aparar a referência salva ou Editar Região de Detecção para mudar a área de busca. Também é possível selecionar uma nova imagem quando a aparência do alvo realmente mudar.
Mantenha a área de busca grande o bastante para incluir todas as posições válidas, mas não maior do que isso. Uma região restrita ao painel relevante evita cópias do mesmo ícone em outros lugares e reduz a parte da tela que precisa ser comparada. Procurar na tela toda só faz sentido quando o alvo pode aparecer em qualquer lugar e não existe um elemento semelhante fora do contexto.
Para aprofundar recorte e precisão, consulte o guia sobre como ajustar a detecção por imagem, cor e texto.
Escolha um resultado ou todos de forma consciente
Em Editar Ação, defina o que deve acontecer quando a referência aparece mais de uma vez:
- Clicar apenas no primeiro usa um único resultado com a melhor correspondência;
- Clicar em todos (um por um) encontra todos os resultados acima da precisão e toca neles em sequência.
O modo com todos os resultados usa as ocorrências encontradas na mesma iteração da macro. Ele funciona melhor quando o layout permanece no lugar durante os cliques, como numa grade fixa de caixas de seleção idênticas. Evite esse modo quando cada clique reordena, remove ou desloca imediatamente os demais alvos. Nesse caso, clique em um resultado, aguarde o novo estado da tela e deixe uma iteração posterior procurar novamente.
Não confunda essa escolha com a condição Contador de imagens. O contador compara uma quantidade e condiciona outra ação; o modo com todos os resultados executa um clique em cada ocorrência encontrada.
Configure o estilo e o tempo do clique
A mesma janela Editar Ação oferece quatro estilos:
- Simples envia um toque para cada resultado selecionado;
- Duplo envia dois toques;
- Longo mantém o toque pela duração configurada;
- Repetido distribui uma quantidade de toques dentro de uma janela de tempo.
Também há atrasos antes e depois da ação. Use um atraso anterior quando a interface precisar de um pequeno tempo para estabilizar antes da busca. Use um atraso posterior quando a tela precisar reagir antes de o fluxo continuar.
Lembre que o estilo vale para cada resultado no modo de clicar em todos. Se três alvos forem encontrados com o estilo Duplo, a ação enviará dois toques para cada um. Comece com Simples, valide a escolha dos alvos e só então aplique uma interação mais forte quando a interface exigir.
Exemplo prático: selecione itens iguais numa grade fixa
Imagine uma tela de teste com várias caixas desmarcadas e idênticas em uma grade. A quantidade muda, mas a grade não se reorganiza quando uma caixa é selecionada. A macro deve selecionar todas as caixas visíveis antes de continuar.
Configure a ação assim:
- capture apenas o ícone de uma caixa desmarcada, sem o texto vizinho;
- amplie a região de detecção para cobrir somente a grade;
- mantenha o estilo de clique em Simples;
- escolha Clicar em todos (um por um);
- adicione um atraso posterior suficiente para renderizar o estado final;
- salve e teste com uma, várias e nenhuma caixa desmarcada visível.
Quando nenhum resultado é encontrado, o clique por imagem não é concluído com sucesso. Desenhe o fluxo ao redor desse estado em vez de presumir que o alvo sempre aparecerá. Uma condição separada pode, por exemplo, liberar a etapa seguinte somente depois que o estado marcado ou uma mensagem de conclusão surgir.
Corrija cliques ausentes ou no alvo errado
Se a ação não encontrar o alvo, revise uma variável por vez:
- confirme se o alvo inteiro está dentro da região de detecção;
- recapture uma referência estável, sem texto variável ou animação;
- reduza a precisão gradualmente se diferenças normais forem rejeitadas;
- mantenha a mesma resolução de emulador usada na captura;
- confira se um aviso ou janela não cobre parte do alvo.
Se a ação clicar no elemento errado:
- apare fundos genéricos da referência;
- aumente a precisão aos poucos;
- limite a região de detecção ao painel correto;
- troque o modo de todos os resultados por um resultado;
- adicione uma condição que identifique o estado de tela pretendido.
Quando mais de um sinal for necessário para confirmar o contexto, use grupos de condições E e OU na ação. Isso protege o clique por imagem contra outra tela que reutiliza o mesmo ícone.
Teste a ação antes de ampliar a execução
Use uma sequência curta de validação:
- teste a posição capturada;
- teste cada posição válida dentro da região de detecção;
- coloque um ícone parecido fora da região e confirme que ele é ignorado;
- teste um e vários resultados quando os dois cenários puderem ocorrer;
- confirme que a próxima etapa aguarda uma mudança observável na tela;
- salve, reabra e rode a macro em um perfil antes de usar mais perfis.
O checklist de estabilização de macros cobre estado inicial, esperas, parada e resolução para a próxima etapa.
Faça o clique acompanhar o alvo visual
Clique na imagem substitui uma suposição de posição por um alvo observável. Capture uma referência estável, limite a região de busca, escolha um ou todos os resultados conforme o comportamento da tela e teste tanto a seleção quanto a transição depois do clique. Assim, a macro pode agir onde o elemento está agora, não apenas onde ele foi gravado.
Baixe o EmuloAgent na Microsoft Store e crie macros guiadas por imagem para emuladores Android.