Controles extendidos, configuración y ayuda

Usa los controles extendidos en Android Emulator para enviar datos, cambiar las propiedades del dispositivo, controlar apps y más. Para abrir la ventana Extended controls, haz clic en More Ícono de controles extendidos del emulador en el panel del emulador. Ten en cuenta que algunas de estas opciones de control extendido solo están disponibles cuando ejecutas el emulador en una ventana separada fuera de Android Studio.

Puedes usar combinaciones de teclas para realizar muchas de estas tareas. Si quieres ver una lista completa de las combinaciones de teclas en el emulador, presiona F1 (Cmd+/ en macOS) para abrir el panel Help.

Tabla 1: Detalle de los controles extendidos

Función Descripción
Ubicación

El emulador te permite simular la información de "Mi ubicación", es decir, dónde se encuentra el dispositivo emulado. Por ejemplo, si haces clic en Mi ubicación Ícono de Mi ubicación en Google Maps y, luego, envías una ubicación, esta se mostrará en el mapa.

Los controles para la información de ubicación del dispositivo se organizan en dos pestañas: Single points y Routes.

Single points

En la pestaña Single points, puedes usar la vista web de Google Maps para buscar lugares de interés, al igual que cuando utilizas Google Maps en un teléfono o en un navegador. Cuando buscas una ubicación en el mapa (o haces clic en ella), puedes seleccionar Save point cerca de la parte inferior del mapa para guardar la ubicación. Todas tus ubicaciones guardadas aparecen en el lado derecho de la ventana Extended controls.

Si deseas establecer la ubicación del emulador en la ubicación que seleccionaste en el mapa, haz clic en el botón Set location que se encuentra cerca de la parte inferior derecha de la ventana Extended controls.

Rutas

Al igual que la pestaña Single points, la pestaña Routes proporciona una vista web de Google Maps que puedes usar para crear una ruta entre dos o más ubicaciones. Para crear y guardar una ruta, sigue estos pasos:

  1. En la vista de mapa, usa el campo de texto para buscar el primer destino de tu ruta.
  2. Selecciona la ubicación en los resultados de la búsqueda.
  3. Selecciona el botón Navigate .
  4. Selecciona el punto de partida de tu ruta en el mapa.
  5. (Opcional) Haz clic en Add destination para agregar más paradas a tu ruta.
  6. Para guardar la ruta, haz clic en Save route en la vista de mapa.
  7. Especifica un nombre para la ruta y haz clic en Save.

Para simular el emulador siguiendo la ruta que guardaste, selecciona la ruta en la lista de Saved routes y haz clic en Play route, cerca de la parte inferior derecha de la ventana Extended controls. Para detener la simulación, haz clic en Stop route.

Si quieres simular de forma continua el emulador siguiendo la ruta especificada, habilita el botón que se encuentra junto a Repeat playback. Para cambiar la velocidad con la que el emulador sigue la ruta especificada, selecciona una opción del menú Playback speed.

Cómo importar datos de GPX y KML

Para usar los datos geográficos a partir de un formato de intercambio de GPS (GPX) o de un archivo de lenguaje de marcación de punto clave (KML), haz lo siguiente:

  1. Haz clic en Load GPX/KML.
  2. En el diálogo de archivos, selecciona un archivo en tu computadora y haz clic en Open.
  3. De manera opcional, puedes seleccionar Speed.
  4. La velocidad predeterminada es el valor Delay (Speed 1X). Puedes duplicar la velocidad (Speed 2X), triplicarla (Speed 3X), etcétera.

  5. Haz clic en Run Ícono Run.
Pantallas

El emulador te permite implementar tu app en varias pantallas, que admiten dimensiones personalizables y pueden ayudarte a probar apps compatibles con multiventana y multipantalla. Mientras se ejecuta un dispositivo virtual, puedes agregar hasta dos pantallas adicionales de la siguiente manera:

  1. Para agregar una pantalla, haz clic en Add secondary display.
  2. En el menú, en Pantallas secundarias, realiza una de las siguientes acciones:
    1. Selecciona una de las relaciones de aspecto predeterminadas.
    2. Selecciona custom y establece la altura (en height), el ancho (en width) y los dpi para tu pantalla personalizada.
  3. (Opcional) Vuelve a hacer clic en Add secondary display para agregar una tercera pantalla.
  4. Haz clic en Apply changes para agregar las pantallas especificadas al dispositivo virtual activo.
Cellular

El emulador te permite simular diferentes condiciones de red. Puedes aproximar la velocidad para diferentes protocolos de red o especificar Full, con la que podrás transferir los datos tan rápido como lo permita la computadora. Especificar un protocolo de red siempre es un proceso más lento que el de la opción Full. Además, puedes especificar el estado de la red de datos y voz; por ejemplo, el roaming. La configuración predeterminada se establece en el AVD.

Selecciona un tipo de red en Network type:

  • GSM: Sistema de telefonía global para comunicaciones móviles
  • HSCSD: Datos de alta velocidad con conmutación de circuitos
  • GPRS: Servicio genérico de radiocomunicaciones por paquetes
  • EDGE: Velocidades de datos mejoradas para la evolución de GSM
  • UMTS: Sistema universal de telecomunicaciones móviles
  • HSPDA: Acceso a paquetes de alta velocidad por enlace descendente
  • LTE: Evolución a largo plazo
  • Full (predeterminada): Usa la red proporcionada por la computadora

Selecciona una intensidad de la señal en Signal strength:

  • Ninguno
  • Deficiente
  • Moderate (predeterminada)
  • Buena
  • Excelente

Selecciona un estado de voz en Voice status, un estado de datos en Data status o ambos:

  • Home (predeterminado)
  • Roaming
  • Búsqueda
  • Denied (solo para llamadas de emergencia)
  • Unregistered (apagado)
Battery

Puedes simular las propiedades de la batería de un dispositivo para ver el rendimiento de la app en diferentes condiciones. Para seleccionar un nivel de carga en Charge level, usa el control deslizante.

Selecciona un valor de conexión del cargador en Charger connection:

  • None
  • AC charger

Selecciona un valor de estado de la batería en Battery health:

  • Good (predeterminado)
  • Falló
  • Dead
  • Sobrevoltaje
  • Sobrecalentamiento
  • Desconocidos

Selecciona un valor de estado de la batería en Battery status:

  • Desconocidos
  • Charging (predeterminado)
  • Discharging
  • No se está cargando
  • Total
Cámara Puedes cargar imágenes en la escena simulada cuando abres la cámara del emulador. Para obtener más información, consulta Cómo agregar imágenes aumentadas a la escena en la documentación de ARCore.
Teléfono

El emulador te permite simular llamadas telefónicas y mensajes de texto entrantes.

Para iniciar una llamada al emulador, haz lo siguiente:

  1. Selecciona o escribe un número de teléfono en el campo From.
  2. Haz clic en Call Device.
  3. De manera opcional, haz clic en Retener llamada para poner la llamada en espera.
  4. Para finalizar la llamada, haz clic en End Call.

Para enviar un mensaje de texto al emulador:

  1. Selecciona o escribe un número de teléfono en el campo From.
  2. Escribe un mensaje en el campo SMS message.
  3. Haz clic en Send Message.
Directional Pad

Si el AVD tiene habilitado el mando de dirección en el perfil de hardware, puedes usar los controles de este mando con el emulador. Sin embargo, no todos los dispositivos admiten el mando de dirección (por ejemplo, los relojes Android). Los botones simulan las siguientes acciones:

Control de mando de dirección
Micrófono Cuando se activa Virtual microphone uses host audio input, el emulador recibe entradas de audio del micrófono del host. De lo contrario, el emulador no recibirá ninguna entrada de audio. En este momento, no están implementadas las opciones Virtual headset plug inserted, Virtual headset has microphone y Voice Assist.
Huella digital

Con este control, se pueden simular 10 escaneos de huellas digitales diferentes. Puedes usarlo para probar la integración de huellas digitales en tu app. Esta función está inhabilitada para Android 5.1 (nivel de API 22) y versiones anteriores, y Wear OS.

Para simular un escaneo de huella digital en el dispositivo virtual:

  1. Prepara una app para recibir una huella digital.
  2. Selecciona un valor de huella digital en Fingerprint.
  3. Haz clic en Touch Sensor.
Virtual sensors > Device Pose

Este control te permite probar tu app en caso de que cambie la posición o la orientación (o ambas) del dispositivo. Por ejemplo, puedes simular gestos como inclinación y rotación. El acelerómetro no realiza un seguimiento de la posición absoluta del dispositivo; solo detecta cuándo se produce un cambio. El control simula la forma en que responderían el acelerómetro y el magnetómetro si movieras o rotaras un dispositivo real.

Debes habilitar el sensor acelerómetro en tu AVD para usar este control.

El control informa eventos TYPE_ACCELEROMETER en los ejes "x", "y" y "z". Estos valores incluyen la gravedad. Por ejemplo, si se suspendiera el dispositivo en el espacio exterior, experimentaría una aceleración cero (todos los valores de "x", "y" y "z" serían 0). Cuando el dispositivo está en la Tierra, encima de una mesa y con la pantalla hacia arriba, la aceleración es 0, 0 y 9.8 debido a la gravedad.

El control también informa eventos TYPE_MAGNETIC_FIELD, que miden el campo magnético ambiental en los ejes "x", "y" y "z" en microteslas (μT).

Para rotar el dispositivo sobre los ejes "x", "y" y "z", selecciona Rotate y realiza una de las siguientes acciones:

  • Ajusta los controles deslizantes Yaw, Pitch y Roll, y observa la posición en el panel superior.
  • Mueve la representación del dispositivo en el panel superior y observa los valores de Yaw, Pitch y Roll, y cómo cambian los valores resultantes del acelerómetro.

Consulta Cómo calcular la orientación del dispositivo para obtener más información sobre cómo se calculan los valores de Yaw, Pitch y Roll.

Para mover el dispositivo de forma horizontal (x) o vertical (y), selecciona Move y realiza una de las siguientes acciones:

  • Ajusta los controles deslizantes de X y de Y, y observa la posición en el panel superior.
  • Mueve la representación del dispositivo en el panel superior y observa los valores de los controles deslizantes de X y de Y, y cómo cambian los valores resultantes del acelerómetro.

Para colocar el dispositivo a 0, 90, 180 o 270 grados, haz lo siguiente:

  • En el área Device rotation, selecciona un botón para cambiar la rotación.

A medida que ajustes el dispositivo, también cambiarán los valores en los campos Resulting values. A estos valores puede acceder una app.

Para obtener más información sobre estos sensores, consulta Información general de sensores, Sensores de movimiento y Sensores de posición.

Virtual sensors > Additional sensors

El emulador puede simular varios sensores de posición y entorno, y te permite ajustar los siguientes sensores para poder probarlos con tu app:

  • Ambient temperature: Este sensor mide la temperatura del aire del ambiente.
  • Magnetic field: Este sensor de posición mide el campo magnético ambiental en los ejes X, Y, y Z, respectivamente. Los valores están en microteslas (μT).
  • Proximity: Este sensor de posición mide la distancia en relación con un objeto; por ejemplo, puede notificar a un teléfono que hay una cara cerca para hacer una llamada. El sensor de proximidad debe estar habilitado en tu AVD para que puedas usar este control.
  • Light: Este sensor ambiental mide la iluminación. Los valores están en lux.
  • Pressure: Este sensor ambiental mide la presión del aire del ambiente. Los valores están en milibares (hPa).
  • Relative Humidity: Este sensor ambiental mide la humedad relativa del ambiente.

Para obtener más información sobre estos sensores, consulta Información general de sensores, Sensores de posición y Sensores ambientales.

Informe de errores Si tienes problemas con el emulador, puedes preparar y enviar un informe de errores. El emulador recopila automáticamente capturas de pantalla, registros y otros datos para el informe de errores.
Grabación y reproducción Consulta Grabación de pantalla.
Google Play Cuando la imagen del sistema del AVD incluye la app de Play Store, esta muestra la información de la versión de Servicios de Google Play.
Settings > General
  • Emulator window theme: Selecciona el tema claro (Light) o el oscuro (Dark).
  • Send keyboard shortcuts to: En la configuración predeterminada, algunas combinaciones del teclado activarán combinaciones de control del emulador. Si desarrollas una app en la que se incluyen combinaciones de teclas (por ejemplo, una app para dispositivos con teclados Bluetooth), puedes modificar esta configuración y enviar todas las entradas del teclado al dispositivo virtual, incluidas las que serían combinaciones de teclas en el emulador.
  • Screenshot save location: Haz clic en el ícono de carpeta para especificar una ubicación de almacenamiento de las capturas de pantalla del emulador.
  • Use detected ADB location: Si usas el emulador desde Android Studio, debes seleccionar esta configuración (predeterminada). Si ejecutas el emulador desde fuera de Android Studio y quieres que use un ejecutable de adb específico, anula la selección de esta opción y especifica la ubicación de las herramientas del SDK. Si es incorrecta la configuración, no funcionarán las opciones como la captura de pantalla y la instalación de la app con el método de arrastrar y soltar.
  • Cuándo enviar informes de fallas: Selecciona Always (siempre), Never (nunca) o Ask (pregunta).
  • Show window frame around device: De forma predeterminada, se muestran los emuladores con archivos de interfaces del dispositivo en una ventana sin marco.
Settings > Proxy

De forma predeterminada, el emulador usa la configuración de proxy HTTP de Android Studio. Esta pantalla te permite definir de forma manual una configuración de proxy HTTP para el emulador. Para obtener más información, consulta Cómo usar el emulador con un proxy.

Settings > Advanced
  • OpenGL ES renderer: Selecciona el tipo de aceleración de gráficos. (Esto equivale a la opción de línea de comandos -gpu).
    • Autodetect based on host: Deja que el emulador elija la aceleración de gráficos de hardware o software según la configuración de tu computadora. Comprueba si el controlador de la GPU está dentro de una lista de controladores de GPU defectuosos; si esto es así, el emulador inhabilita la emulación de hardware de gráficos y usa la CPU.
    • ANGLE: (solo para Windows). usa ANGLE Direct3D para renderizar gráficos en software.
    • SwiftShader: usa SwiftShader para procesar gráficos en software.
    • Desktop native OpenGL: Usa la GPU de tu computadora host. Esta opción suele ser la más rápida. Sin embargo, algunos controladores tienen problemas con el procesamiento de gráficos OpenGL, por lo que es posible que no sea una opción confiable.
  • OpenGL ES API level: Selecciona la versión máxima de OpenGL ES para usar en el emulador.
    • Autoselect: Deja que el emulador elija la versión de OpenGL ES en función de la compatibilidad de invitado y host.
    • Renderer maximum (up to OpenGL ES 3.1): Intenta utilizar la versión máxima de OpenGL ES.
    • Compatibility (OpenGL ES 1.1/2.0): Usa la versión de OpenGL ES que sea compatible con la mayoría de los entornos.
Help > Keyboard Shortcuts

En este panel, se incluye una lista completa de combinaciones de teclas para usar en el emulador. Si quieres abrir el panel mientras trabajas en el emulador, presiona F1 (Cmd+/ en macOS).

Para que funcionen las combinaciones de teclas, la opción Send keyboard shortcuts del panel de configuración General debe estar definida como Emulator controls (default).

Help > Emulator Help

Si quieres consultar la documentación en línea del emulador, haz clic en Documentation.

Para enviar un error relacionado con el emulador, haz clic en Send feedback. Para obtener más información, descubre cómo informar errores del emulador.

Help > About

Consulta el puerto de adb que usa el emulador y también los números de versión del emulador y de Android. Compara la última versión disponible del emulador con tu versión para determinar si tienes instalado el software más reciente.

El número de serie del emulador es emulator-adb_port. Puedes especificarlo, por ejemplo, como opción de línea de comandos adb.