---
id: "sistema.emulador-interacao"
titulo: "Interagir com o aparelho emulado"
resumo: "Toque, digite e faça gestos no aparelho emulado pela aba Emulador, pelo cartão do Canvas ou pela CLI."
idioma: "pt-br"
tipo: "tutorial"
categoria: "ambientes"
aplicavelDesde: "0.0.16"
capabilities: ["devices.emulator.interact"]
estadoEditorial: "aprovado"
nivelEvidencia: "artefato-distribuido"
refFonte: "27574c339b58316408f6be2d62169d59041d07bf"
revisaoFonte: "2026-09-24"
revisor: "mantenedor (v1, 2026-10-03)"
rota: "/docs/pt-br/sistema/emulador-interacao/"
fonte: "pt-br/sistema/emulador-interacao.md"
caminhoPublico: "docs/publica/pt-br/sistema/emulador-interacao.md"
hashFonte: "sha256:8b650624cacbb2745476f4992e6e9716fa321f47145a0529b23a790671eb4478"
hashDestaPagina: "sha256:8b650624cacbb2745476f4992e6e9716fa321f47145a0529b23a790671eb4478"
traducaoAssistidaPorIA: false
traducaoDesatualizada: false
corpoRetido: false
---
Interagir é enviar um toque, um gesto, um texto, um botão de hardware ou uma rotação para o aparelho
escolhido. Os mesmos comandos existem na tela do Elyra e na CLI: a aba e o cartão do Canvas mandam o
mesmo que `tap`, `type` e `gesture` mandam por linha de comando.

## Pré-requisitos

- Um aparelho emulado **ativo** para o workspace. Se nenhum estiver ativo, a ação falha pedindo um
  alvo — veja [Emulador de celular](/docs/pt-br/sistema/emulador/) para listar e conectar.
- A aba **Emulador** aberta ou um cartão **Celular** no Canvas, se você for interagir pela tela.

## Passos

1. **Escolha o aparelho.** No painel do aparelho, na aba **Emulador**, escolha o dispositivo na lista
   e conecte; no Canvas, escolha o dispositivo na lista do cartão **Celular**. O aparelho escolhido
   fica ativo para o workspace, e é ele que recebe as ações seguintes.
2. **Toque na tela.** Clique ou toque sobre a imagem do aparelho na aba, ou sobre a transmissão do
   cartão do Canvas. O toque vai para o ponto em que você tocou.
3. **Faça um gesto.** Arraste sobre a imagem para rolar ou deslizar. Na CLI o mesmo efeito é um
   `gesture` com dois ou mais pontos, ou um `tap` para um toque único.
4. **Digite.** Pela CLI, use `type` com o texto entre aspas. Texto com espaço **precisa** estar entre
   aspas: sem elas cada palavra vira um argumento solto e o comando é recusado.
5. **Use botões e rotação.** Pela CLI, `button` manda um botão de hardware e `rotate` gira a tela
   para uma das quatro orientações.
6. **Olhe a tela depois de cada ação.** A resposta do comando diz que o comando foi enviado, não que o
   aparelho reagiu da forma esperada.

Equivalente na CLI, com o aparelho ativo no workspace:

```bash
elyra emulator tap 0.5 0.85 --json
elyra emulator type "user@example.com" --json
elyra emulator gesture '[{"type":"begin","x":0.5,"y":0.8},{"type":"end","x":0.5,"y":0.2}]' --json
elyra emulator button back --json
elyra emulator rotate landscape_left --json
```

## Resultado

- A ação é enviada ao aparelho escolhido, e a tela na aba ou no cartão do Canvas mostra o efeito.
- O aparelho continua ativo para o workspace até você encerrar a sessão.

## Limites

- **As coordenadas do `tap` são normalizadas de 0 a 1**, com origem no canto superior esquerdo —
  nunca pixels. Um valor fora dessa faixa é recusado.
- **`type` aceita apenas US ASCII.** Texto acentuado é recusado; digite pela interface do próprio app
  ou envie a forma sem acento.
- **O aparelho precisa estar ativo.** Sem alvo resolvido, o comando falha com `emulator_no_active`.
- **A resposta do comando não comprova o efeito visual.** Olhe a tela depois de cada ação antes de
  decidir o próximo passo.
- **Não existe captura de tela nesta família.** No Android, a forma de ler a tela de volta é a árvore
  de acessibilidade (`elyra emulator ax`); no iOS esse verbo é recusado.
- **Para um toque único, use `tap`.** Um `gesture` de dois pontos pode virar um toque longo por causa
  da latência do canal de controle.
- **No Android o gesto vira um arrasto reto** entre o primeiro e o último ponto: ele rola e desliza,
  mas não desenha um caminho de múltiplos toques.

## Recuperação

- **`emulator_no_active`** — nenhum aparelho ativo no workspace. Conecte um no painel do aparelho ou
  passe `--device <id>` / `--node "<id ou título do cartão>"` no comando.
- **`emulator_device_not_found`** — o identificador não existe nesta máquina. Liste com
  `elyra emulator devices --json` e use o id que aparecer.
- **O texto foi recusado** — confira se há espaço sem aspas ou caractere fora de US ASCII.
- **A tela não mudou** — releia a tela (no Android, a árvore de acessibilidade) antes de repetir a
  ação; repetir às cegas pode aplicar a mesma ação duas vezes.

## Próximos passos

- [Comandos do emulador](/docs/pt-br/sistema/emulador-cli/)
- [Instalar, iniciar e ler um app no Android emulado](/docs/pt-br/sistema/emulador-android/)