Emulador Android en la nube: crear, ver y ejecutar macros

Un dispositivo en la nube es un emulador Android en la nube que Macro Automation Studio (MAS) ejecuta por ti en sus propios servidores con GPU. Este emulador Android en la nube aparece junto a tus emuladores locales en la app, transmite su pantalla por WebRTC y ejecuta las macros en el servidor, así que tu ordenador puede estar apagado. Esta página cubre cómo crear uno, sus estados, las apps, las ejecuciones y los límites.

Antes de empezar

• MAS está instalado y has iniciado sesión. Consulta Instalar MAS.
• Tu plan incluye al menos un dispositivo en la nube. Los dispositivos en la nube son un complemento de un plan de pago; consulta Facturación.
• Para las ejecuciones: una macro de Python en tu biblioteca. El diálogo de ejecución solo lista macros de Python.

Qué es un emulador Android en la nube

Cada dispositivo en la nube es un dispositivo Android completo en un centro de datos de MAS, renderizado en una GPU de servidor. Iniciar y detener lleva tiempo real: unos 48 segundos para un arranque desde cero, 17 para reanudar y 9 para detener. La pantalla te llega como una transmisión WebRTC que lleva el vídeo y tus toques, y solo un visor la sostiene a la vez; la tarjeta muestra un icono de ojo, Visualizándose en directo, cuando está abierta en otro sitio. Las macros se ejecutan en los servidores de MAS junto al dispositivo, así que cerrar la app no termina una ejecución. Las apps instaladas y las cuentas con sesión iniciada sobreviven a una detención; solo Eliminar las borra.

Crear un dispositivo en la nube

1. Abre Dispositivos en la nube en la barra lateral.
2. Escribe un Nombre del dispositivo.
3. Elige la versión de Android. La lista viene del servidor; Android 15 es la predeterminada.
4. Elige una Resolución: Ligera (540 por 960), Estándar (720 por 1280) o Nítida (1080 por 1920). Nítida transmite el doble de píxeles y necesita más ancho de banda.
5. Elige un DPI, o deja Predeterminado, la densidad propia del preajuste. Los valores permitidos son 160, 240, 320 y 480.
6. Opcionalmente marca Incluir Google Play Store (ver abajo).
7. Haz clic en Crear.

El dispositivo aparece como Detenido; crearlo no lo inicia. La versión, la resolución y el DPI quedan fijos una vez creado, así que un perfil distinto significa un dispositivo nuevo. La cabecera de la página cuenta los dispositivos En ejecución y Asignados frente a tu plan, y una cuenta puede tener hasta 20 dispositivos en la nube por cuenta.

Google Play en un teléfono Android en la nube

Las apps de Google se activan por dispositivo. Marca Incluir Google Play Store al crear un dispositivo, o haz clic en Añadir Google Play en uno existente: el dispositivo se reinicia una vez, en unos 15 segundos, y conserva sus datos. Añadir Google Play a todos cubre todos los dispositivos que no lo tengan.

La primera vez, MAS muestra el aviso Instalar apps de Google, que aceptas una vez por cuenta. En resumen: el dispositivo instala MindTheGapps, un paquete independiente de código abierto mantenido por desarrolladores de LineageOS que contiene Google Play Store, los servicios de Google Play y Google Services Framework. MAS no está afiliado a Google, ni respaldado ni licenciado por Google; ni MAS ni el proyecto MindTheGapps te conceden licencia alguna sobre las aplicaciones de Google, y tu uso de las apps de Google y de cualquier cuenta de Google se rige por las condiciones de servicio de Google. El dispositivo virtual no está certificado por Play Protect, así que las apps que verifican la integridad del dispositivo no funcionarán: apps bancarias y de pago, Google Wallet, streaming en HD o con DRM, y algunos juegos. Instalas y usas las apps de Google bajo tu propia responsabilidad.

Un dispositivo con Google Play muestra una insignia Play. Si la instalación falla, la tarjeta ofrece Reintentar.

Estados del dispositivo

Cada transición es asíncrona; la tarjeta muestra el tiempo transcurrido mientras un dispositivo cambia de estado.

Iniciar, detener y eliminar

• Iniciar arranca el dispositivo. Cuando todas las plazas de ejecución de tu plan están en uso, falla con un mensaje como “2 of 2 running, stop one to start another”.
• Detener libera la plaza de ejecución y la GPU y la RAM del anfitrión, y conserva el disco. Iniciar lo reanuda.
• Eliminar destruye el dispositivo y todo lo que contiene: apps instaladas, cuentas con sesión iniciada, progreso de juegos. El diálogo lo avisa antes.

Un dispositivo en ejecución sin ninguna ejecución activa se detiene automáticamente a los 60 minutos. Sus datos se conservan; Iniciar lo reanuda en segundos. Una macro en marcha mantiene el dispositivo encendido.

Ver la pantalla en directo

Haz clic en Ver en un dispositivo listo. Negociando la transmisión significa que la conexión WebRTC se está estableciendo; una vez en directo, tus clics, arrastres y teclas van directos al dispositivo, y la cabecera ofrece Pantalla completa, Atrás, Inicio y Cerrar. Cerrar el visor libera la transmisión para otra ventana. En Grupos de dispositivos, la tarjeta de un dispositivo en la nube tiene Ver en directo, que acopla el mismo visor junto a la tarjeta.

Instalar apps

Haz clic en Instalar APK en un dispositivo listo. El selector ofrece tres caminos:

• Subir un archivo (.apk / .xapk): un archivo .apk, .xapk, .apkm o .apks de hasta 1 GiB. MAS lo comprueba, lo sube al anfitrión del dispositivo y lo instala allí. Los formatos contenedores se desempaquetan, se descartan las divisiones de 32 bits y x86, se colocan los archivos de expansión y el resto se instala como un solo paquete. Un paquete sin compilación arm64 se rechaza antes de subirlo; los dispositivos en la nube son solo ARM de 64 bits.
• Buscar apps para descargar: escribe el nombre de una app, o pega un enlace o un id de paquete, y haz clic en Instalar. MAS descarga la app en este ordenador y la instala de la misma manera.
• Gestionar apps instaladas: mira qué hay en el dispositivo, Actualiza una app cuando el catálogo tiene una compilación más nueva, o desinstala una con el botón de papelera (haz clic dos veces para confirmar). La cabecera muestra las plazas de apps usadas frente al límite del dispositivo.

El progreso se muestra en la tarjeta: Comprobando la app, Subiendo la app, Instalando la app. Los fallos muestran el motivo literal, incluidos los códigos INSTALL_FAILED de adb.

Ejecutar macros 24/7 en un dispositivo en la nube

1. Inicia el dispositivo y espera a Listo.
2. Haz clic en Ejecutar en la tarjeta y elige una macro de Python.
3. Sigue la línea de ejecución: lanzando, en ejecución con el tiempo transcurrido, terminada o fallida. Detener ejecución termina la ejecución y deja el dispositivo encendido.

Antes de empezar la ejecución, MAS sincroniza tu código: calcula el hash de la carpeta del proyecto de la macro y sube una instantánea solo cuando el árbol ha cambiado. Una instantánea contiene como máximo 500 archivos y 10 MiB comprimidos; se omiten las carpetas con punto como .git y .venv, además de __pycache__, node_modules, venv y los archivos .pyc. Un proyecto que supera un límite falla antes de la ejecución con el motivo, por ejemplo “project has more than 500 files”. La instantánea es lo que ejecuta la nube, así que el árbol de trabajo del Code Editor se ejecuta sin commit ni push. Consulta Proyectos git y sincronización de código.

Las ejecuciones lanzadas desde un grupo de dispositivos en la nube usan la macro del dispositivo y sus argumentos o su perfil de ajustes, y muestran la salida del script en la tarjeta. Cada ejecución queda en Ejecuciones con su estado.

Grupos de dispositivos en la nube y proxies

Un grupo de dispositivos contiene un solo tipo de dispositivo. Crea un grupo con el Tipo en Nube, haz clic en Añadir dispositivo en la nube y elige un dispositivo asignado; un dispositivo en la nube solo puede unirse a un grupo en la nube. Cada dispositivo del grupo tiene su propia macro, argumentos o perfil de ajustes, proxy y webhooks, e Iniciar todos lanza una ejecución en el servidor por dispositivo, uno tras otro. Consulta Grupos de dispositivos.

Un proxy asignado a un dispositivo en la nube se aplica dentro de la red del dispositivo la próxima vez que arranca, así que todo su tráfico sale por el proxy y la tarjeta muestra la IP de salida. Consulta Proxies.

API REST y MCP

Con una clave de API puedes iniciar y seguir ejecuciones en el servidor: POST /api/hosted/devices/{id}/run con macro_id y args opcional, POST /api/hosted/runs/{id}/stop, GET /api/hosted/runs/{id}, y GET /api/macros/{id}/code-state más POST /api/macros/{id}/code-snapshot para sincronizar el código. El ciclo de vida del dispositivo, la transmisión y las instalaciones de apps necesitan el inicio de sesión de la propia app. Consulta la API REST. El servidor MCP de MAS expone los dispositivos en la nube a los clientes MCP.

Cuánto cuesta

Los dispositivos en la nube son un complemento de cualquier plan de pago, con precio por dispositivo y mes, e incluyen una asignación mensual de créditos de IA para MAS Agent. Añade o quita dispositivos a mitad de ciclo; el cambio se prorratea y la fecha de renovación se mantiene. Consulta la página de precios y Facturación.

Solución de problemas

El dispositivo se queda en ubicando o iniciando

Ubicando significa que todavía ningún anfitrión tiene espacio. MAS aprovisiona un anfitrión nuevo, lo que tarda unos 15 minutos, y el dispositivo avanza solo. Si nada se libera en 45 minutos, el dispositivo pasa a Error con “no capacity became available”, e Iniciar lo reintenta. Un primer arranque suele terminar en menos de 1:30 y una reanudación en menos de 0:20; si el tiempo transcurrido supera eso con creces, haz clic en Detener, espera a Detenido y luego en Iniciar otra vez. Eso también mueve el dispositivo a un anfitrión actual, lo que arregla “this device’s host does not support APK installs yet”.

La transmisión no conecta

• El dispositivo debe estar en Listo. Un dispositivo detenido responde “The device must be running before you can view it”.
• Atascado en Negociando la transmisión: el ticket de la transmisión dura poco, así que cierra el visor y haz clic en Ver otra vez, o haz clic en Reconectar cuando se ofrezca.
• Abierto en otro sitio: solo un visor sostiene la transmisión. Ciérralo en la otra ventana o instancia de MAS.
• Una red que bloquea WebRTC nunca pinta el vídeo. Prueba otra red y luego pregunta en Discord.

La instalación de la app falla

• “this package has no arm64-v8a build”: la app solo incluye código de 32 bits o x86. Consigue una versión arm64.
• “not a valid APK”: el archivo no es un paquete Android o está corrupto.
• “the limit is 1024MB”: el paquete supera 1 GiB.
• “INSTALL_FAILED_MISSING_SPLIT”: el paquete está incompleto. Descarga el XAPK completo e instala ese.
• “install timed out”: el anfitrión está bajo carga. Reintenta en unos minutos.