---
id: "sistema.emulador-interacao"
titulo: "Interactuar con el dispositivo emulado"
resumo: "Toque, escriba y haga gestos en el dispositivo emulado desde la pestaña Emulador, la tarjeta del Canvas o la CLI."
idioma: "es"
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/es/sistema/emulador-interacao/"
fonte: "pt-br/sistema/emulador-interacao.md"
caminhoPublico: "docs/publica/es/sistema/emulador-interacao.md"
hashFonte: "sha256:8b650624cacbb2745476f4992e6e9716fa321f47145a0529b23a790671eb4478"
hashDestaPagina: "sha256:b56f874184bb4eb5856a1d3b03e6c1db6cbc05dd2a61076ce4f9cd8c5f25f87b"
traducaoAssistidaPorIA: true
traducaoDesatualizada: false
corpoRetido: false
---
<!-- traducao-assistida-por-ia: idioma=ES fonte=pt-br/sistema/emulador-interacao.md fonteHash=sha256:8b650624cacbb2745476f4992e6e9716fa321f47145a0529b23a790671eb4478 estado=atual -->

Interactuar es enviar un toque, un gesto, un texto, un botón de hardware o un giro al dispositivo
elegido. Los mismos comandos existen en la pantalla de Elyra y en la CLI: la pestaña y la tarjeta del
Canvas envían lo mismo que `tap`, `type` y `gesture` envían por línea de comandos.

## Requisitos

- Un dispositivo emulado **activo** para el workspace. Si ninguno está activo, la acción falla pidiendo
  un objetivo — vea [Emulador móvil](/docs/es/sistema/emulador/) para listar y conectar.
- La pestaña **Emulador** abierta o una tarjeta **Phone** en el Canvas, si va a interactuar por la
  pantalla.

## Pasos

1. **Elija el dispositivo.** En el panel del dispositivo, en la pestaña **Emulador**, elija el
   dispositivo de la lista y conecte; en el Canvas, elija el dispositivo en la lista de la tarjeta
   **Phone**. El dispositivo elegido queda activo para el workspace, y es el que recibe las acciones
   siguientes.
2. **Toque la pantalla.** Haga clic o toque sobre la imagen del dispositivo en la pestaña, o sobre la
   transmisión de la tarjeta del Canvas. El toque va al punto donde usted tocó.
3. **Haga un gesto.** Arrastre sobre la imagen para desplazar o deslizar. En la CLI el mismo efecto es un
   `gesture` con dos o más puntos, o un `tap` para un toque único.
4. **Escriba.** Desde la CLI, use `type` con el texto entre comillas. El texto con espacio **debe** ir
   entre comillas: sin ellas cada palabra se vuelve un argumento suelto y el comando es rechazado.
5. **Use botones y giro.** Desde la CLI, `button` envía un botón de hardware y `rotate` gira la pantalla
   a una de las cuatro orientaciones.
6. **Mire la pantalla después de cada acción.** La respuesta del comando dice que el comando se envió,
   no que el dispositivo reaccionó como usted esperaba.

Equivalente en la CLI, con el dispositivo activo en el 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

- La acción se envía al dispositivo elegido, y la pantalla en la pestaña o en la tarjeta del Canvas
  muestra el efecto.
- El dispositivo sigue activo para el workspace hasta que usted cierre la sesión.

## Límites

- **Las coordenadas de `tap` están normalizadas de 0 a 1**, con origen en la esquina superior izquierda —
  nunca píxeles. Un valor fuera de ese rango es rechazado.
- **`type` acepta solo US ASCII.** El texto acentuado es rechazado; escríbalo por la interfaz de la
  propia app o envíe la forma sin acento.
- **El dispositivo debe estar activo.** Sin un objetivo resuelto, el comando falla con
  `emulator_no_active`.
- **La respuesta del comando no comprueba el efecto visual.** Mire la pantalla después de cada acción
  antes de decidir el paso siguiente.
- **No hay captura de pantalla en esta familia.** En Android, la forma de leer la pantalla de vuelta es
  el árbol de accesibilidad (`elyra emulator ax`); en iOS ese verbo es rechazado.
- **Para un toque único, use `tap`.** Un `gesture` de dos puntos puede volverse un toque largo por la
  latencia del canal de control.
- **En Android el gesto se vuelve un arrastre recto** entre el primer y el último punto: desplaza y
  desliza, pero no dibuja una trayectoria de múltiples toques.

## Recuperación

- **`emulator_no_active`** — ningún dispositivo activo en el workspace. Conecte uno en el panel del
  dispositivo o pase `--device <id>` / `--node "<id o título de la tarjeta>"` en el comando.
- **`emulator_device_not_found`** — el identificador no existe en esta máquina. Liste con
  `elyra emulator devices --json` y use el id que aparezca.
- **El texto fue rechazado** — revise si hay un espacio sin comillas o un carácter fuera de US ASCII.
- **La pantalla no cambió** — vuelva a leer la pantalla (en Android, el árbol de accesibilidad) antes de
  repetir la acción; repetir a ciegas puede aplicar la misma acción dos veces.

## Próximos pasos

- [Comandos del emulador](/docs/es/sistema/emulador-cli/)
- [Instalar, iniciar y leer una app en el Android emulado](/docs/es/sistema/emulador-android/)