Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.

Cómo probar apps de Android para vehículos

Cuando pruebas tu app para vehículos, ayudas a garantizar que los usuarios no encontrarán resultados inesperados ni tendrán una mala experiencia. La manera en la que pruebes la app dependerá de si esta se ejecutará en Android Auto o en el SO Android Automotive.

Consulta una de las siguientes secciones para comenzar:

Prueba tu app para Android Auto

La consola central de escritorio (DHU, por su sigla en inglés) habilita tu máquina de desarrollo a emular una consola central de Android Auto, de modo que puedas ejecutar y probar tus apps de Android Auto. La DHU se ejecuta en sistemas con Windows, macOS y Linux.

En esta sección, se explica cómo instalar y ejecutar la DHU en la máquina de desarrollo para probar tus apps. Después de instalar la DHU, podrás probar tus apps de Android Auto conectando el teléfono a ella mediante la herramienta adb.

Para informar errores o solicitar funciones relacionadas con la DHU, usa esta herramienta de seguimiento de errores.

Instala la DHU

La última versión disponible de la DHU es la 2.0 rc1. Esta versión incluye funciones que no están disponibles en la versión anterior (1.1) y es la versión recomendada para su instalación y uso. Si tienes problemas con la versión 2.0 rc1, puedes instalar la versión 1.1 en su lugar.

Instala la DHU versión 2.0 rc1

Sigue estos pasos a fin de instalar la DHU 2.0 rc1 en tu máquina de desarrollo:

  1. Habilita el modo de desarrollador en un dispositivo móvil que ejecute Android 6.0 (nivel de API 23) o versiones posteriores, según se describe en Cómo habilitar las opciones para desarrolladores en el dispositivo.
  2. Compila e instala tu app en el dispositivo.
  3. Instala Android Auto en el dispositivo. Si ya está instalada, asegúrate de estar usando la versión más reciente.
  4. Abre Android Studio y cámbialo al canal beta. Si se te solicita que actualices a una versión más reciente de Android Studio, puedes ignorar el aviso.
  5. Abre SDK Manager, navega a la pestaña SDK tools y, luego, descarga la versión 2.0 rc1 del paquete del emulador de la consola central de escritorio de Android Auto.

    SDK Manager muestra DHU 2.0 rc1.

    La DHU se instalará en el directorio SDK_LOCATION/extras/google/auto/. Una vez que haya finalizado la descarga, podrás volver a cambiar la configuración de Android Studio al canal estable si no quieres usar la versión del canal beta de otras herramientas.

  6. En sistemas Linux o macOS, ejecuta el siguiente comando a fin de asegurarte de que el objeto binario de la DHU sea ejecutable:

    chmod +x ./desktop-head-unit
    
Pasos adicionales para Linux únicamente

Si ejecutas la versión 2.0 rc1 en un sistema Linux, deberás instalar algunas bibliotecas adicionales. El objeto binario de la DHU depende de la versión 2.27 o posterior de GLIBC. Puedes comprobar la versión de GLIBC de tu sistema ejecutando este comando:

ldd --version

Si la versión es anterior a la 2.27, deberás actualizar GLIBC a versión 2.27 o una posterior, o bien actualizar el SO a una versión compatible con GLIBC 2.27 o una versión posterior.

También deberás instalar las bibliotecas libc++1 y libc++abi1. El procedimiento de instalación varía según la distribución de Linux. Por ejemplo, en las distribuciones de Linux derivadas de Debian, puedes instalar las bibliotecas con este comando:

sudo apt-get install libc++1 libc++abi1

Instala la versión 1.1 de la DHU

Si tienes problemas con la versión 2.0 rc1, sigue estos pasos a fin de instalar la DHU 1.1 en tu máquina de desarrollo:

  1. Habilita el modo de desarrollador en un dispositivo móvil que ejecute Android 6.0 (nivel de API 23) o versiones posteriores, según se describe en Cómo habilitar las opciones para desarrolladores en el dispositivo.
  2. Compila e instala tu app en el dispositivo.
  3. Instala Android Auto en el dispositivo. Si ya está instalada, asegúrate de estar usando la versión más reciente.
  4. Abre Android Studio y comprueba que esté usando el canal estable.
  5. Abre SDK Manager, navega a la pestaña SDK tools y, luego, descarga la versión 1.1 del paquete del emulador de la consola central de escritorio de Android Auto.

    La DHU se instalará en el directorio SDK_LOCATION/extras/google/auto/. Una vez que haya finalizado la descarga, podrás volver a cambiar la configuración de Android Studio a otro canal de actualización si no quieres usar la versión del canal estable de otras herramientas.

  6. En sistemas Linux o macOS, ejecuta el siguiente comando a fin de asegurarte de que el objeto binario de la DHU sea ejecutable:

    chmod +x ./desktop-head-unit
    
Pasos adicionales para Linux únicamente

Si ejecutas la versión 1.1 en un sistema Linux, deberás instalar algunas bibliotecas adicionales. Instala portaudio, libpng, sdl2 y sdl2_ttf. El procedimiento de instalación varía según la distribución de Linux. Por ejemplo, en las distribuciones de Linux derivadas de Debian, puedes instalar las bibliotecas con este comando:

sudo apt-get install libsdl2-2.0-0 libsdl2-ttf-2.0-0 libportaudio2 libpng12-0

Ejecuta la DHU

Después de instalar la DHU, podrás probar tus apps de Android Auto conectando el teléfono y la estación de trabajo mediante USB. Para ejecutar la DHU, conecta tu dispositivo móvil a una máquina de desarrollo y establece conexión con el servidor de la consola central a través de Android Debug Bridge (ADB).

Sigue estos pasos para configurar túneles y ejecutar la DHU:

  1. Realiza una de las siguientes acciones a fin de abrir la configuración de Android Auto, según la versión de Android que se ejecute en el dispositivo:

    • Android 10 o versiones posteriores: En el dispositivo, presiona Configuración > Apps y notificaciones > Ver todas las apps > Android Auto > Avanzada > Opciones de configuración adicionales de la app.
    • Android 9 o versiones anteriores: En la app de Android Auto, presiona Menú y, luego, Configuración.
  2. Desplázate hasta la sección Acerca de, cerca de la parte inferior, y presiona Versión para mostrar toda la información de la versión y los permisos.

  3. Presiona la sección Información de la versión y los permisos 10 veces.

    Se mostrará el cuadro de diálogo Permitir configuración de desarrollo.

  4. Presiona Aceptar.

    Se habilitará el modo de desarrollador y podrás acceder a las opciones para desarrolladores en el menú ampliado. Solo deberás habilitar el modo de desarrollador la primera vez que ejecutes la app de Android Auto.

  5. Si aún no se está ejecutando el servidor de la consola central, presiona los tres puntos de la esquina superior derecha de la pantalla para abrir el menú ampliado y selecciona Iniciar servidor unidad princ. (consulta la Figura 1).

    En el dispositivo, se mostrará un servicio en primer plano en el área de notificaciones que indica que el servidor está en ejecución (consulta la Figura 2).

    Menú contextual con opciones para desarrolladores

    Figura 1: Menú contextual con opciones para desarrolladores

    Notificación que indica que el servidor de la unidad principal se está ejecutando

    Figura 2: Notificación que indica que el servidor de la unidad principal está en ejecución

  6. En la app de Android Auto, presiona Vehículos conectados anteriormente, cerca de la parte superior de Configuración, y asegúrate de que la opción Agregar automóviles nuevos a Android Auto esté habilitada.

  7. Conecta el dispositivo móvil a la máquina de desarrollo por USB.

  8. Asegúrate de que la pantalla del dispositivo móvil esté desbloqueada; de lo contrario, no se podrá iniciar la DHU.

  9. En la máquina de desarrollo, ejecuta el siguiente comando de adb a fin de reenviar conexiones de sockets del puerto 5277 de la máquina de desarrollo al mismo número de puerto en el dispositivo Android. Esta configuración permite que la DHU se conecte al servidor de la consola central que se ejecuta en el teléfono a través de un socket TCP.

    adb forward tcp:5277 tcp:5277
    
  10. Para iniciar la DHU, ejecuta el comando desktop-head-unit.exe (en Windows) o ./desktop-head-unit (en macOS o Linux) desde el directorio SDK_LOCATION/extras/google/auto/.

    cd SDK_LOCATION/extras/google/auto
    desktop-head-unit.exe # Windows
    ./desktop-head-unit # macOS or Linux
    

    La DHU se inicia en la máquina de desarrollo

  11. Si es la primera vez que conectas el dispositivo móvil a la DHU, consulta la pantalla del dispositivo móvil a fin de aceptar las Condiciones del Servicio y ajustar la configuración de los permisos según sea necesario.

Después de que se inicie la DHU, podrás usar los comandos de la DHU para ejecutar y probar tu app.

Opciones de línea de comandos

De forma predeterminada, el servidor de la unidad principal se conecta a través del puerto 5277. Para anular el host o el puerto (por ejemplo, a los efectos de reenviar a través de SSH), usa la marca --adb=<[localhost:]port>, como en el siguiente ejemplo:

./desktop-head-unit --adb=5999

De forma predeterminada, la DHU emula una consola central compatible con Android Auto con una interfaz de usuario de pantalla táctil. Puedes simular las entradas táctiles de los usuarios haciendo clic en la DHU con un mouse. A fin de emular las consolas centrales que usan un control rotativo para la entrada, puedes usar la marca -i controller, como en este ejemplo:

./desktop-head-unit -i controller

Cuando la DHU está en modo de control rotativo, puedes usar combinaciones de teclas a los efectos de simular las operaciones del control. Si quieres obtener información detallada, consulta Control rotativo. En el modo de control rotativo, la DHU ignorará los clics del mouse, y deberás manejar Android Auto con las operaciones simuladas del control rotativo.

El conjunto completo de opciones de la línea de comandos que admite la DHU varía según si usas la versión 2.0 rc1 o 1.1.

Versión 2.0 rc1
Opción Descripción
c, --config=FILE Usa el archivo de configuración .ini especificado. Consulta la sección Configura la DHU para obtener más detalles.
i, --input=INPUT Usa el modo de entrada de texto especificado, uno de los siguientes: touch, rotary o hybrid.
-a, --adb=HOSTPORT Usa el transporte de ADB (host:port o port opcionales). El valor predeterminado es el puerto 5277.
v, --version Muestra la información de la versión.
l, --licenses Muestra las licencias de código abierto.
h, --headless Se ejecuta en modo sin interfaz gráfica (sin IU).
?, --help Muestra este listado de ayuda.
Versión 1.1
Opción Descripción
i, --input=INPUT Usa el modo de entrada de texto especificado, uno de los siguientes: touch o rotary.
-a, --adb=HOSTPORT Usa el transporte de ADB (host:port o port opcionales). El valor predeterminado es el puerto 5277.
v, --version Muestra la información de la versión.
l, --licenses Muestra las licencias de código abierto.
h, --headless Se ejecuta en modo sin interfaz gráfica (sin IU).

Guía del usuario de la DHU (versión 2.0 rc1)

En esta sección, se describen las funciones compatibles con la versión 2.0 rc1 de la DHU y la manera de usarlas.

Los comandos se ingresan en la ventana de la terminal en la que iniciaste la DHU. Se pueden ejecutar varios comandos en la misma línea separándolos con un ;.

Sistema

Comando Clave Descripción
help [command] Muestra el conjunto de comandos completo. Si se especifica un nombre de comando (por ejemplo, help day), muestra ayuda para ese comando.
quit
exit
Alt + Q Sale de la unidad principal.
sleep [seconds] Suspende la unidad durante un segundo. Si se especifica un retraso, se suspende por esa cantidad de seconds. Esto se puede usar para crear secuencias de comandos de la consola central (./desktop-head-unit < script.txt), por ejemplo, en un entorno de CI.
screenshot filename.png Guarda una captura de pantalla en filename.png..
licenses Muestra las licencias de las bibliotecas utilizadas en la DHU.
keycode keycode Envía keycode, uno de los nombres que aparece en la sección Códigos de teclas.

Modo y panel táctiles

Cuando se habilitan el modo o panel táctiles, si haces clic en la ventana de la pantalla (en el primer caso) o en la del panel táctil (en el segundo), se registrarán los eventos táctiles.

En el caso del modo táctil, puedes simular la función multitáctil haciendo clic con el botón derecho en la ubicación del primer dedo y, para el segundo, manteniendo presionado el botón derecho. El punto central de los dos dedos permanecerá fijo, y mover el mouse te permitirá rotarlos alrededor del centro o pellizcar hacia adentro o hacia afuera (o ambos).

En el caso del panel táctil, mantén presionado el botón izquierdo a fin de desplazarte entre diferentes elementos de la IU en la pantalla. Haz clic en el botón derecho para seleccionar el elemento enfocado actualmente.

Comando Clave Descripción
tap x y Simula un evento táctil en las coordenadas especificadas.

Control rotativo

La DHU es compatible con el control rotativo. Cuando está habilitado, se admiten las siguientes acciones:

  • Arriba, abajo, izquierda y derecha en el controlador direccional
  • Rotar en sentido horario y antihorario
  • Rotar y girar (5 pasos a la vez)
  • Hacer clic en Abajo y Atrás en el control

A continuación, se indican los comandos y las vinculaciones de teclas.

Una rueda de desplazamiento en un mouse enviará comandos dpad rotate, y el clic en el botón central del mouse (por lo general, la rueda de desplazamiento) enviará comandos dpad click.

Ten en cuenta que la mayoría de los vehículos tienen pantallas táctiles. Algunos autos solo tienen control rotativo y otros tienen un sistema híbrido de entradas táctiles y de control. Los vehículos también pueden tener compatibilidad con un panel táctil, que podrá usarse para el desplazamiento lateral de mapas y la entrada de texto. Ten en cuenta estas configuraciones diferentes cuando simules distintas consolas centrales de vehículos.

Comando Clave Descripción
dpad {up|down|left|right} Teclas de flecha Movimiento del control rotativo.
dpad {ur|dl|ul|dr} Movimiento del control rotativo.
dpad soft {left|right} Mayúsculas + teclas de flecha Botones laterales disponibles en algunos controles rotativos.
dpad click Volver Presión del control rotativo.
dpad back Retroceso Botón Atrás disponible debajo de algunos controles rotativos.
dpad rotate left 1 Movimiento de control rotativo izquierdo (sentido antihorario).
dpad rotate right 2 Movimiento de control rotativo derecho (sentido horario).
dpad flick left Mayúscula + 1 Giro rápido en sentido antihorario del control rotativo.
dpad flick right Mayúscula + 2 Giro rápido en sentido horario del control rotativo.
dpad 0-9*#+ Teclado numérico

Micrófono

La DHU es compatible con el uso de un micrófono para las entradas de voz o la reproducción de una pista de voz grabada previamente. Te proporcionamos los siguientes archivos de sonido con comandos por voz comunes. Estos archivos de sonido se instalaron en el directorio SDK_LOCATION/extras/google/auto/voice/.

Nombre del archivo Texto
navhome.wav "Navegar a casa"
navwork.wav "Navegar al trabajo"
navsoh.wav "Navegar a la Ópera de Sídney"
navgoogle.wav "Navegar a 1600 Amphitheatre Parkway, California, EE.UU."
exitnav.wav "Salir de la navegación"
howlong.wav "¿En cuánto tiempo llegaré?"
showtraffic.wav "Mostrar estado del tráfico"
showalternateroute.wav "Mostrar rutas alternativas"
pause.wav "Pausar música"
nextturn.wav "¿Cuándo debo doblar?"

Si quieres ejecutar un archivo .wav individual en la DHU, usa el siguiente directorio:

mic play /path/to/filename.wav
Comando Clave Descripción
mic begin M Activa el micrófono (equivalente a hacer clic en el botón del volante) y espera la entrada del micrófono de la computadora.
mic play filename.wav Activa el micrófono y reproduce la grabación del archivo WAV especificado. Nota: No escucharás el archivo WAV en reproducción, pero escucharás la respuesta de Android Auto.
mic repeat Repite la última grabación que se usó con mic play.
mic reject {on|off} Habilita o inhabilita el rechazo de las solicitudes de micrófono. Si activas esta opción, se rechazarán todas las solicitudes del micrófono.

Modo diurno o nocturno

La DHU admite la simulación del cambio entre los modos diurno y nocturno por medio de los siguientes comandos y vinculaciones de teclas.

Comando Clave Descripción
day Mayúscula + N Activa el modo diurno (brillo alto, a todo color).
night Ctrl + N Activa el modo nocturno (brillo bajo, contraste alto).
daynight
nightday
N Activa o desactiva los modos día o nocturno.

Restricciones/estado de la conducción

La DHU admite la simulación de ciertas restricciones cuando el vehículo está en movimiento, como inhabilitar el teclado y las configuraciones del teléfono.

Comando Clave Descripción
restrict none U Inhabilita todas las restricciones.
restrict all Mayúsculas + U Habilita todas las restricciones (por ejemplo, para simular la conducción).

Clúster de instrumentos

La DHU admite la emulación de un clúster de instrumentos (por lo general ubicado detrás del volante) que muestra información básica durante la navegación acerca del próximo paso (como el nombre de la ruta, la distancia/hora o una flecha de giro) e información sobre una llamada telefónica en curso.

Se puede habilitar mediante la entrada instrumentcluster en el archivo de configuración o las entradas navcluster o phonecluster a fin de controlar cada función por separado.

Estado de la reproducción de contenido multimedia

La DHU es compatible con una pantalla de información adicional que muestra el estado de reproducción de contenido multimedia (por ejemplo, qué pista se está reproduciendo).

Esto se puede habilitar mediante la entrada playbackstatus en el archivo de configuración.

Códigos de teclas

La DHU proporciona un conjunto de códigos predeterminados de teclas que simula el conjunto de botones de combinación de teclas que suelen estar disponibles en diferentes vehículos. Por ejemplo, el código de tecla home se puede activar en el mensaje de la DHU de la siguiente manera:

keycode home
Clave de código Descripción
home Ir a la pantalla principal
back Volver
call
endcall
Hacer una llamada o finalizarla
search Activar una búsqueda
media_play_pause
media_play
media_pause
Reproducir o pausar contenido multimedia
media_next
media_previous
Ir a la pista multimedia siguiente o a la anterior
media Ir a la app de música predeterminada
navigation Ir a la app de navegación predeterminada
tel Ir a la app de teléfono predeterminada

Configura la DHU

La DHU admite un archivo de configuración .ini a los efectos de cambiar los modos disponibles de entrada de texto (táctil, por control), la velocidad de fotogramas, la resolución y los DPI que la consola central solicita desde el teléfono.

La ubicación predeterminada del archivo de configuración es ~/.android/headunit.ini. Si deseas cambiar la configuración de la consola central en tu sistema, puedes modificar este archivo.

También puedes especificar un archivo de configuración para cargar mediante la marca -c.

./desktop-head-unit -c /path/to/config.ini
Configuración de ejemplo
[general]
touch = true
touchpad = false
controller = false
instrumentcluster = false
resolution = 800x480
dpi = 160
framerate = 30

Se pueden encontrar archivos de configuración de ejemplo en la carpeta SDK_LOCATION/extras/google/auto/config/ que demuestran diferentes configuraciones de consolas centrales que puedes usar para realizar pruebas. Para casos de uso más avanzados, consulta la configuración compatible que se incluye a continuación.

Configuración de entrada
Nombre Predeterminado Tipo Descripción
inputmode default String Define el modo de entrada. Las opciones touch, rotary, hybrid habilitan e inhabilitan la compatibilidad con la pantalla táctil y el control rotativo, y establecen los códigos predeterminados de teclas según corresponda, mientras que default difiere a las opciones touch y controller que se incluyen a continuación.
controller false Booleano Habilita la entrada del control rotativo. Se ignorará, a menos que inputmode sea default.
touch true Booleano Habilita la pantalla táctil. Se ignorará, a menos que inputmode sea default.
touchpad false Booleano Habilita el panel táctil.
touchpadnavigation false Booleano Habilita el panel táctil que se usará en la navegación de la IU.
touchpadtapasselect false Booleano Si es verdadero, presionar el panel táctil será un evento de selección.
touchpaduiabsolute false Booleano Cuando touchpadnavigation es true, esto establece si los toques deben tratarse como absolutos o como gestos.
Configuración de video

Android Auto admite tres resoluciones de video:

  1. 480 píxeles (800 x 480, el valor predeterminado)
  2. 720 p (1280 x 720)
  3. 1080 p (1920 x 1080)

A fin de admitir relaciones de aspecto distintas de las anteriores, se puede especificar en la consola central un margen en letterbox (formato 16:9) o letterbox (formato 16:9), según sea necesario. Por ejemplo, si quisieras una pantalla de 1000 x 600, deberías establecer la resolución en 720 p (1280 x 720) y un margen con 280 de ancho y 120 de altura. Esto tendrá el efecto de agregar un margen de 140 px en los bordes izquierdo y derecho, y uno de 60 px en los bordes superior e inferior.

Configuración de ejemplo para emular una pantalla típica de 6 pulgadas (750 x 450):

[general]
...
resolution = 800x480
marginwidth = 50
marginheight = 30

Y otra para una pantalla muy ancha:

[general]
...
resolution = 1280x720
marginwidth = 0
marginheight = 220
Nombre Predeterminado Tipo Descripción
resolution 800x480 Strings Uno de los siguientes: 800x480, 1280x720 o 1920x1080.
dpi 160 Entero
normalizedpi false Booleano Cuando es true, reduce el tamaño de ventana de la DHU a fin de tener valores de DPI más grandes. Cuando es false, los valores de DPI más grandes generan ventanas más grandes (que no imitan pantallas reales, pero permiten inspeccionar el contenido visual con mayor facilidad).
realdpi 160 Entero Se usa en la configuración de video.
framerate 30 Entero Se usa en la configuración de video.
marginheight 0 Entero Se usa en la configuración de video.
marginwidth 0 Entero Se usa en la configuración de video.
margins 0,0,0,0 String Se usa en la configuración de video. Anula marginwidth y marginheight si están presentes. El formato es arriba, abajo, izquierda y derecha.
contentinsets 0,0,0,0 String Se usa en la configuración de video. El formato es arriba, abajo, izquierda y derecha.
stablecontentinsets 0,0,0,0 String Se usa en la configuración de video. El valor predeterminado es el de contentinsets. El formato es arriba, abajo, izquierda y derecha.
cropmargins false Booleano Si se especifican margins, marginheight o marginwidth, un valor true para esta configuración quita esos márgenes del video que se muestra. Esto refleja en mayor medida lo que ve el usuario final.
pixelaspectratio 1.0 Flotante Se usa en la configuración de video.
Varios
Nombre Predeterminado Tipo Descripción
instrumentcluster false Booleano Habilitar el clúster de instrumentos. Agregar una ventana a la IU para mostrar el estado de la navegación y el teléfono.
navcluster false Booleano Habilitar el clúster de instrumentos. Agregar una ventana a la IU para mostrar el estado de la navegación.
phonecluster false Booleano Habilitar el clúster de instrumentos. Agregar una ventana a la IU para mostrar el estado del teléfono.
playbackstatus false Booleano Habilitar el estado de reproducción. Agregar una ventana a la IU para mostrar los mensajes de estado de la reproducción.
driverposition left String Uno de los siguientes: left, center o right.
windowleft Entero Establecer la posición izquierda de la ventana principal.
windowtop Entero Establecer la posición superior de la ventana principal.

Guía del usuario de la DHU (versión 1.1)

Los comandos de la DHU te permiten probar tu app con las funciones de Android Auto, como la reproducción de entradas de voz o el cambio entre los modos de visualización diurno y nocturno. Puedes ejecutar comandos de la DHU desde la ventana de la terminal donde la iniciaste. También puedes ejecutar comandos si seleccionas la ventana de DHU y usas combinaciones de teclas. Los comandos de la DHU y las vinculaciones de teclas de todos los controles se enumeran en Comandos y vinculaciones de teclas de la DHU.

Cambia entre los modos diurno y nocturno

Android Auto admite diferentes esquemas de colores para el día y la noche. Debes probar tu app tanto en modo diurno como en modo nocturno. Puedes cambiar entre ambos modos de cualquiera de las siguientes maneras:

  • Ejecuta el comando daynight en la terminal donde iniciaste la DHU.
  • Selecciona la ventana de la DHU y presiona la tecla N.

Prueba el micrófono

La DHU admite el uso de un micrófono para la entrada de voz. También puedes indicarle a la DHU que trate una pista de voz pregrabada como entrada, como si hubiera escuchado la pista a través del micrófono.

Para usar un archivo de sonido pregrabado como entrada, ingresa el siguiente comando:

mic play <sound_file_path>/<sound_file>.wav

Te proporcionamos los siguientes archivos de sonido con comandos por voz comunes. Estos archivos de sonido se instalaron en el directorio <sdk>/extras/google/auto/voice/.

Nombre del archivo Texto
navhome.wav "Navegar a casa"
navwork.wav "Navegar al trabajo"
navsoh.wav "Navegar a la Ópera de Sídney"
navgoogle.wav "Navegar a 1600 Amphitheatre Parkway, California, EE.UU."
exitnav.wav "Salir de la navegación"
howlong.wav "¿En cuánto tiempo llegaré?"
showtraffic.wav "Mostrar estado del tráfico"
showalternateroute.wav "Mostrar rutas alternativas"
pause.wav "Pausar música"
nextturn.wav "¿Cuándo debo doblar?"
Comandos y vinculaciones de teclas de la DHU

La DHU admite los siguientes comandos.

Tabla 1: Comandos y vinculaciones de teclas

Categoría Comando Subcomando Argumentos Combinaciones de teclas Descripción
Sistema help [command] Muestra el conjunto de comandos completo. Si especificas un nombre de comando (por ejemplo, help day) el sistema mostrará la ayuda para ese comando.
quit Alt+q Sale de la unidad principal.
sleep [seconds] Suspende la unidad durante un segundo. Si especificas un argumento (por ejemplo, sleep 30) el sistema suspende el número específico de segundos. Este comando es útil si escribes secuencias de comandos para la DHU. (Puedes ejecutar una secuencia de comandos usando el redireccionamiento de E/S desde la línea de comandos: ./desktop-head-unit < script.txt cargará los comandos del archivo script.txt).
screenshot filename.png Guarda una captura de pantalla en filename.png.
Micrófono mic begin m Activa el micrófono (equivalente a presionar el botón de micrófono en el volante) y espera la entrada del micrófono de la computadora.
play filename.wav Hace que la DHU trate a filename.wav como entrada de voz, como si ese sonido se retransmitiera a través del micrófono. No se escuchará el archivo de sonido en reproducción, pero sí la respuesta de Android Auto.
repeat Repite el último comando mic play, como si volvieras a llamar a mic play con el mismo parámetro de archivo de sonido.
Entrada dpad up
down
left
right
Teclas de flecha Simula el movimiento del control rotativo.
soft left
soft right
Mayúscula + teclas de flecha Simula la presión de los botones laterales disponibles en algunos controles rotativos.
click Intro Simula la presión del control rotativo.
back Retroceso Simula la presión del botón Atrás disponible en algunos controles rotativos.
rotate left
rotate right
1
2
Simula la rotación del control rotativo hacia la izquierda (en sentido antihorario) o hacia la derecha (en sentido horario).
flick left
flick right
Mayúscula + 1
Mayúscula + 2
Simula un giro rápido del control rotativo hacia la izquierda (en sentido antihorario) o hacia la derecha (sentido horario).
tap x y Simula un evento táctil en las coordenadas especificadas. Por ejemplo: tap 50 100.
Día/noche day Mayúscula + N Activa el modo día (brillo alto, a todo color).
night Control + N Activa el modo nocturno (brillo bajo, contraste alto).
daynight n Activa o desactiva el modo diurno/nocturno.

Prueba tu app para el SO Android Automotive

Puedes usar Android Emulator a fin de probar cómo se ejecuta la app optimizada para conductores en la pantalla de un vehículo con SO Android Automotive. En esta sección, se describe cómo configurar un dispositivo virtual de Android (AVD) a fin de probar tu app.

Edita las configuraciones de ejecución

Las apps del SO Automotive son diferentes de otras apps para Android. El SO Android Automotive interactúa con tu app utilizando intents explícitos y enviando llamadas a tu servicio de navegador multimedia.

Si quieres probar tu app, verifica que no tenga actividad de inicio en su manifiesto y, luego, evita que tu módulo automotor se inicie con una actividad. Para ello, sigue estos pasos:

  1. En Android Studio, selecciona Run > Edit Configurations.

    El cuadro de diálogo Run/Debug Configurations.

  2. Selecciona el módulo automotriz desde la lista de módulos de tu app.

  3. En Launch Options > Launch, selecciona Nothing.

  4. Haz clic en Apply y, luego, en OK.

Agrega imágenes del sistema

Antes de crear AVD que coincidan con el hardware de fabricantes específicos, debes agregar imágenes del sistema para estos dispositivos mediante el SDK Manager de Android Studio. Luego, cuando crees un AVD, podrás descargar estas imágenes del sistema para usarlas con el AVD.

Agrega imágenes del sistema de fabricantes de automóviles

Actualmente, puedes agregar una imagen del sistema específica de OEM para Polestar 2 y Volvo. Sigue estos pasos a fin de agregar una imagen del sistema:

  1. En Android Studio, selecciona Tools > SDK Manager.
  2. Haz clic en la pestaña SDK Update Sites.
  3. Haz clic en Add Agrega un ícono.
  4. Completa los campos Name y URL con la siguiente información y haz clic en OK:

    Name: Imagen del sistema Polestar 2

    URL: https://developer.polestar.com/sdk/polestar2-sys-img.xml

    Nombre: Imagen del sistema Volvo

    URL: https://developer.volvocars.com/sdk/volvo-sys-img.xml

  5. Haz clic en Apply y, a continuación, en OK.

Instala imágenes genéricas del sistema

Android Studio también incluye una imagen genérica del sistema para el SO Android Automotive que puedes usar a fin de probar tu app. Esta imagen incluye Asistente de Google para que puedas probar la integración de tu app.

Sigue estos pasos a los efectos de instalar la imagen genérica del sistema:

  1. En Android Studio, selecciona Tools > SDK Manager.
  2. Haz clic en la pestaña SDK Platforms.
  3. Haz clic en Show Package Details.
  4. En Android 9.0 (Pie), selecciona Automotive Intel x86 Atom System Image.
  5. Haz clic en Apply y, a continuación, en OK.

    Lista de componentes de la plataforma del SDK con la imagen genérica del sistema seleccionada.

Crea un AVD de vehículo y ejecuta el emulador

Sigue estos pasos a fin de crear un dispositivo virtual de Android (AVD) que represente un vehículo con SO Android Automotive y, luego, usa ese AVD para ejecutar el emulador:

  1. En Android Studio, selecciona Tools > AVD Manager.
  2. Haz clic en Create Virtual Device.
  3. En el diálogo Select Hardware, selecciona Automotive y un dispositivo y, luego, haz clic en Next.
  4. Selecciona una imagen del sistema destinada a Automotive, como Android 9.0 (Automotive) y, luego, haz clic en Next.
  5. Asigna el AVD y selecciona otras opciones que quieras personalizar. Luego, haz clic en Finish.
  6. En la barra de ventanas de herramientas, selecciona tu AVD del SO Android Automotive como destino de implementación.
  7. Haz clic en Run Ícono Run.

Prueba tu app en pantallas de teléfonos

Sigue estos pasos para transferir tu app a un teléfono y probarla.

Paso 1: En la app de Android Auto, habilita el Modo de desarrollador y las Fuentes desconocidas

  1. Instala la app Android Auto en el teléfono, que está disponible en Google Play. Si ya está instalada, asegúrate de estar usando la versión más reciente.
  2. En la app de Android Auto, presiona el menú de opciones y, luego, Configuración.
  3. Desplázate hasta la sección Acerca de, cerca de la parte inferior, y presiona Versión para mostrar toda la información de la versión y los permisos.
  4. Presiona la sección Información de la versión y los permisos 10 veces.

    Se mostrará el cuadro de diálogo Permitir configuración de desarrollo.

  5. Presiona Aceptar.
  6. Presiona los tres puntos de la esquina superior derecha de la pantalla para abrir el menú ampliado. Luego, presiona Configuración para desarrolladores.
  7. Presiona Modo de aplicación y selecciona Desarrollador.

    La app mostrará la lista de opciones de configuración del desarrollador.

  8. Desplázate hacia abajo hasta Fuentes desconocidas y presiona la casilla de verificación.
  9. Reinicia Android Auto.

Paso 2: En tu teléfono, habilita la depuración de USB

  1. En Configuración > Acerca del dispositivo, presiona Número de compilación siete veces para habilitar las Opciones para desarrolladores.
  2. Regresa a Configuración > Opciones para desarrolladores y habilita Depuración por USB.

Paso 3: Instala tu app en el teléfono y pruébala

  1. Conecta el teléfono a tu máquina mediante un puerto USB para que puedas instalar las apps directamente durante el desarrollo. Usa el comando adb devices a fin de asegurarte de que la computadora de desarrollo pueda detectar tu dispositivo cuando esté conectado mediante USB.
  2. Una vez que el dispositivo esté configurado y conectado a través de USB, navega al directorio platform-tools/ de tu SDK e instala el .apk en el dispositivo con el siguiente comando:

    adb -d install path/to/your/app.apk
    

    Ahora puedes probar tu app y verificar que todo funciona correctamente.

Requisitos de pruebas adicionales para apps de música

Si estás probando una app de música, también deberías probar las situaciones que se tratan en esta sección (además de probar la app en Android Auto, en el SO Android Automotive o en ambos).

Prueba situaciones de inicio de MediaBrowseService

A fin de ayudar a que los conductores y los pasajeros permanezcan seguros, los usuarios tienen restricciones adicionales para interactuar con las apps mientras conducen. Por este motivo, Android Auto y el SO Android Automotive tienen algunas situaciones de inicio de MediaBrowserService que tu app debe poder controlar de modo que los usuarios puedan seguir disfrutando de tu contenido mientras viajan.

Prueba tu app para asegurarte de que pueda manejar cada una de las siguientes situaciones:

  • Antes de que se abra alguna Activity, se ejecuta MediaBrowserService.
  • Si no puede mostrar ninguna Activity, se ejecuta MediaBrowserService.
  • Si el usuario no accedió, se ejecuta MediaBrowserService.

Mientras pruebas estas situaciones, asegúrate de probar los siguientes métodos:

  • Fuerza la detención de la app de música y, luego, inicia Android Auto o el SO Android Automotive.
  • Borra los datos de la app de música y, luego, inicia Android Auto o el SO Android Automotive.

Además, asegúrate de configurar un mensaje de error apropiado cuando sea necesario.

Herramientas de prueba de multimedia

La app de prueba del controlador multimedia te permite probar las complejidades de la reproducción de contenido multimedia en Android y verificar la implementación de tu sesión multimedia. Para comenzar a usar esta herramienta, consulta Cómo usar la app de prueba del controlador multimedia.