Integra acciones de voz en tu app de música para mejorar la seguridad y la comodidad del conductor, y minimizar las distracciones. Cuando Android Auto o el SO Android Automotive (AAOS) detectan e interpretan una acción de voz, entregan la acción a tu app a través de la devolución de llamada onPlayFromSearch.
Cuando recibe la devolución de llamada, tu app encuentra contenido que coincide con la cadena de búsqueda y, luego, comienza la reproducción. Tu app debe tener en cuenta varias categorías de búsqueda, como género, artista, álbum, nombre de la canción, estación de radio o playlist. Además, tu app debe controlar una cadena de búsqueda vacía, lo que indica una solicitud general de música.
Si tu app está reproduciendo un elemento multimedia, el usuario puede decir "Reproducir [título de la canción]" para indicarle a tu app que reproduzca una canción diferente sin mirar ni tocar la pantalla del auto. Para iniciar las consultas, los usuarios pueden hacer clic en los botones correspondientes del volante o decir en voz alta las palabras clave "Hey Google".
Cuando Android Auto o AAOS detectan e interpretan una acción de voz, Android Auto o AAOS entregan esa acción de voz a la app a través de onPlayFromSearch. Cuando recibe esta devolución de llamada, la app encuentra contenido que coincide con la cadena query y, luego, comienza la reproducción.
Los usuarios pueden especificar diferentes categorías de términos en su consulta: género, artista, álbum, nombre de la canción, estación de radio o playlist, entre otros. Cuando crees compatibilidad con la búsqueda, ten en cuenta todas las categorías que sean adecuadas para tu app. Si Android Auto o AAOS detectan que una búsqueda determinada se ajusta a una categoría específica, se agregarán extras en el parámetro extras. Puedes enviar los siguientes extras:
Ten en cuenta que Android Auto o AAOS pueden enviar una cadena query vacía si el usuario no especifica términos de búsqueda. Por ejemplo, si el usuario dice "Reproducir música". En este caso, tu app puede comenzar una pista nueva o que se reprodujo recientemente.
Si tu app no puede procesar una búsqueda rápidamente, no bloquees en onPlayFromSearch.
En cambio, establece el estado de reproducción en STATE_CONNECTING y realiza la búsqueda en un subproceso asíncrono.
Cuando comience la reproducción, considera propagar la cola de la sesión multimedia con contenido relacionado. Por ejemplo, si el usuario solicita que se reproduzca un álbum, tu app podría llenar la cola con la lista de pistas del álbum.
Además de las consultas de "Reproducir", Android Auto y AAOS reconocen las consultas por voz para controlar la reproducción, como "pausar música" y "siguiente canción", y hacen coincidir estos comandos con las devoluciones de llamada de sesión multimedia adecuadas, como onPause y onSkipToNext.
Para obtener más información sobre la implementación de acciones de reproducción habilitadas para voz, consulta Asistente de Google y las apps de música.