Um toque consegue selecionar um botão, mas não rola uma lista, arrasta um item, move um controle deslizante ou revela o conteúdo que ficou fora da tela. Essas interações precisam de um gesto com início e destino claros. Para repeti-lo com consistência, também não basta adivinhar duas coordenadas.
O EmuloAgent oferece a ação Deslizar (x, y) para macros em emuladores Android no Windows. Você desenha o gesto sobre uma captura atual do emulador e configura trajetória, velocidade, repetições e pausa entre elas. Este guia mostra como montar a ação e testá-la sem transformar uma rolagem simples em uma etapa frágil.
Automatize apenas onde o aplicativo, jogo ou serviço permitir. A ação de deslizar reproduz um gesto de interface, mas não altera regras de terceiros nem controles de acesso.
Use Deslizar quando o movimento fizer parte da interação
Escolha Deslizar (x, y) quando a interface precisar receber um arrasto de um ponto a outro. Alguns casos comuns são:
- rolar uma lista para cima ou para baixo;
- mudar de página em um carrossel horizontal;
- arrastar um item até uma área de destino;
- mover um controle deslizante até uma posição aproximada;
- repetir o mesmo gesto direcional algumas vezes.
Não use um deslize apenas para alcançar um botão que já está visível. A ação de clique é mais simples para um ponto fixo, enquanto Clique na imagem é mais adequada quando o alvo pode mudar de posição e tem uma referência visual estável. A ação deve representar a interação que a tela Android realmente espera.
Prepare a tela do emulador antes de capturar o gesto
Abra o perfil do emulador exatamente na tela em que o arrasto acontecerá. Confira se o conteúdo visível, a orientação e a resolução correspondem ao estado esperado durante a execução.
O deslize guarda origem e destino em coordenadas da tela do emulador. Se a macro for capturada em uma resolução e executada em outra, os mesmos pontos podem atingir áreas diferentes da interface. Mantenha a resolução do perfil estável e siga o checklist de estabilização em um perfil antes de ampliar a execução.
Se o EmuloAgent não conseguir capturar ou controlar o emulador, confirme primeiro a conexão ADB. O guia de preparação de emuladores cobre MuMu Player, BlueStacks, LDPlayer e Nox.
Como adicionar a ação Deslizar no EmuloAgent
1. Comece uma nova ação
Abra a macro no construtor, selecione Adicionar Ação e escolha Nova Ação. Na seção Gesto, selecione Deslizar (x, y).
O EmuloAgent abre o seletor do gesto sobre uma captura do perfil de emulador escolhido. A linha mostrada nessa imagem representa o movimento que a macro enviará ao Android.
2. Posicione a origem e o destino
Mova a primeira alça para o ponto onde o gesto deve começar e a segunda para o ponto onde ele deve terminar.
A direção importa:
- para mover o conteúdo visível e revelar itens abaixo, o movimento semelhante ao dedo normalmente começa embaixo e segue para cima;
- para voltar ao conteúdo anterior, ele costuma começar em cima e seguir para baixo;
- em um carrossel horizontal, mantenha os dois pontos em altura parecida e mova para a esquerda ou para a direita.
Deixe as pontas afastadas das barras de navegação, das bordas estreitas da tela e de controles sem relação com a rolagem. Em uma lista longa, prefira uma área central livre, e não um botão que possa reagir ao toque inicial.
3. Escolha trajetória reta ou curva
O campo Trajetória oferece Reta e Curva.
Use Reta para rolagem de listas, mudança horizontal de página e a maioria dos arrastos diretos. Essa é a opção padrão e envia um gesto nativo do Android em cada repetição.
Use Curva apenas quando o caminho precisar evitar uma área da interface ou aproximar um arrasto não linear. O seletor mostra pontos de controle para modelar a curva. Internamente, o EmuloAgent aproxima esse trajeto com pequenos deslizes consecutivos; portanto, o resultado não é idêntico a manter um único dedo pressionado durante todo o caminho. Teste na interação real antes de depender desse modo.
Ajuste a velocidade para o comportamento da tela
A ação oferece os modos Lenta, Média e Rápida. Comece por Média.
Use Lenta quando a interface interpretar um movimento rápido como impulso, quando o item precisar permanecer pressionado durante o arrasto ou quando o destino exigir mais controle. Use Rápida quando o aplicativo aceitar claramente um movimento curto e a próxima etapa não depender de uma parada precisa.
A velocidade pode mudar o resultado mesmo com as mesmas coordenadas. Um deslize rápido para cima pode avançar muito mais em uma lista do que um arrasto lento. Trate a velocidade como parte do comportamento da ação, não como ajuste visual.
Repita o gesto sem perder o estado da tela
O EmuloAgent permite repetir o mesmo deslize de 1 a 20 vezes e inserir uma pausa de 0 a 1.000 ms entre as repetições. Esse recurso é útil quando uma tela conhecida sempre exige alguns movimentos do mesmo tamanho.
Evite definir uma quantidade alta apenas para garantir que a macro chegue ao fim. A lista pode ser menor em outra conta, o conteúdo pode carregar entre os gestos ou um botão pode parar sob a área do deslize. Use a menor quantidade previsível.
Quando o destino depender do conteúdo exibido, separe o movimento em passos controlados:
- execute um deslize;
- aguarde a tela estabilizar;
- confira um sinal de imagem, cor ou texto;
- deslize novamente apenas se o estado desejado ainda estiver ausente.
O guia sobre como combinar condições E e OU mostra como proteger uma ação com verificações do estado da tela.
Exemplo prático: revele uma opção em uma lista de configurações
Imagine que uma tela de configurações sempre abra no topo e a opção necessária apareça depois de duas rolagens controladas.
Configure a ação assim:
- origem: um ponto livre na parte central inferior da lista;
- destino: um ponto na parte central superior;
- trajetória: Reta;
- velocidade: Média;
- repetições: 2;
- pausa: tempo suficiente para a interface concluir o primeiro movimento antes de iniciar o segundo.
Depois do deslize, adicione à próxima ação uma condição que confirme se a opção realmente está visível. Não presuma que dois gestos sempre terminarão nos mesmos pixels quando a lista tiver conteúdo dinâmico.
Em um carrossel, use um deslize horizontal e confirme a próxima página por um título ou imagem estável. Em um arrastar e soltar, comece dentro do objeto, termine dentro do destino e teste a velocidade Lenta antes de acelerar.
Teste o gesto isolado e dentro da macro
Use este checklist antes de considerar o fluxo pronto:
- execute a ação de deslizar na tela inicial esperada;
- confirme a direção e a área de parada;
- teste todas as repetições, não apenas a primeira;
- confira se a pausa permite que a interface estabilize;
- teste a ação a partir de uma posição de conteúdo um pouco diferente;
- rode a próxima ação e confirme se ela encontra o resultado esperado;
- salve, feche, reabra e execute a macro completa em um perfil.
Se o gesto começar certo, mas a macro se desviar depois, reduza as repetições e adicione uma verificação visual entre os movimentos. Se ele começar no ponto errado, revise a resolução capturada e as coordenadas. Se o trajeto curvo falhar enquanto o reto funcionar, o alvo pode exigir um contato contínuo que a aproximação em curva não fornece.
Relacione cada deslize a um resultado observável
Uma macro de deslizar confiável não apenas move de A até B. Ela começa em uma tela conhecida, usa direção e velocidade deliberadas e confirma o que o movimento revelou. Capture as pontas na tela real do emulador, comece com um gesto reto em velocidade média e só adicione repetições depois que uma passagem funcionar de forma consistente.