Las apps de música que usan las plantillas de la biblioteca de Car App pueden personalizar su experiencia de exploración y reproducción de música, a la vez que garantizan que la experiencia esté optimizada para las pantallas de los automóviles y minimice las distracciones mientras se conduce.
En esta guía, se da por sentado que ya tienes una app de música que reproduce audio en un teléfono y que cumple con la arquitectura de apps de música de Android. La biblioteca de Car App te permite reemplazar la experiencia en la app con plantillas en lugar de las que se compilan con la estructura de datos de Cómo compilar apps multimedia para vehículos.MediaBrowser Aun así, debes proporcionar un MediaSession para los controles de reproducción y un MediaBrowserService, que se usa para las recomendaciones y otras experiencias inteligentes.
Configura el manifiesto de tu app
Además de los pasos que se describen en Cómo usar la biblioteca de apps de Android para vehículos, las apps de contenido multimedia basadas en plantillas deben cumplir con los siguientes requisitos:
Declara la compatibilidad de categoría en tu manifiesto
Tu app debe declarar la categoría de app para vehículos androidx.car.app.category.MEDIA en el filtro de intents de su CarAppService.
<application>
...
<service
...
android:name=".MyCarAppService"
android:exported="true">
<intent-filter>
<action android:name="androidx.car.app.CarAppService" />
<category android:name="androidx.car.app.category.MEDIA"/>
</intent-filter>
</service>
...
<application>
Para obtener acceso a MediaPlaybackTemplate, tu app también debe declarar el permiso androidx.car.app.MEDIA_TEMPLATES en su archivo de manifiesto:
<manifest ...>
...
<uses-permission android:name="androidx.car.app.MEDIA_TEMPLATES"/>
...
</manifest>
Cómo establecer el nivel mínimo de API de la app para vehículos
Las apps de medios que usan MediaPlaybackTemplate solo se admiten en la API de CAL 8, así que asegúrate de que tu Car App API level mínimo esté establecido en 8.
<application ...>
...
<meta-data
android:name="androidx.car.app.minCarApiLevel"
android:value="8"/>
...
</application>
Declara la compatibilidad con Android Auto
Asegúrate de que se incluya lo siguiente en el manifiesto de tu app:
<application>
...
<meta-data android:name="com.google.android.gms.car.application"
android:resource="@xml/automotive_app_desc"/>
...
</application>
Luego, agrega la declaración template a automotive_app_desc.xml en tus recursos XML. Debería tener el siguiente aspecto:
<automotiveApp xmlns:android="http://schemas.android.com/apk/res/android">
<uses name="media"/>
<uses name="template"/>
</automotiveApp>
Proporciona un ícono de atribución
Asegúrate de agregar un ícono de atribución para las apps de medios creadas con la Biblioteca de apps para vehículos.
Cómo admitir acciones de voz
Habilita tu app para que se pueda usar con la voz y permite que los usuarios completen acciones comunes sin usar las manos.
Consulta cómo admitir acciones de voz para contenido multimedia para obtener instrucciones de implementación más detalladas. Con una app de medios basada en plantillas, si recibes un comando por voz, no es necesario que actualices tu MediaBrowserService con los resultados de la búsqueda. En su lugar, considera agregar una acción en tu plantilla de reproducción de medios para permitir que el usuario encuentre más contenido en función de esa reproducción o búsqueda. Se requiere admitir comandos de voz para cumplir con el lineamiento de calidad VC-1.
Crea tu plantilla de reproducción
El MediaPlaybackTemplate muestra información sobre la reproducción de contenido multimedia en la app de música de la Biblioteca de apps para vehículos. Esta plantilla permite establecer un encabezado con un título y acciones personalizables, mientras que el host completa la información del contenido multimedia y los controles de reproducción según el estado del objeto MediaSession de tu app.
Figura 1:
MediaPlaybackTemplate con una acción de encabezado para abrir la fila
en la parte superior.
En este ejemplo de código, se muestra cómo compilar una plantilla de reproducción de ejemplo que establece una acción de encabezado que permite al usuario navegar a una pantalla con la fila de canciones.
val playbackTemplate = MediaPlaybackTemplate.Builder()
.setHeader(
Header.Builder()
.setStartHeaderAction(Action.BACK)
.addEndHeaderAction(
Action.Builder()
.setTitle(model.context.getString(R.string.queue_button_title))
.setIcon(
CarIcon.Builder(
IconCompat.createWithResource(
model.context,
R.drawable.gs_queue_music_vd_theme_24,
))
.build())
.setOnClickListener(showQueueScreen())
.build())
.setTitle(model.context.getString(R.string.media_playback_view_title))
.build())
.build()
Cuando uses MediaPlaybackTemplate, registra un token de MediaSession con MediaPlaybackManager en tu CarAppService. De lo contrario, se mostrará un error cuando se envíe un MediaPlaybackTemplate al host.
import androidx.car.app.media.MediaPlaybackManager
…
override fun onCreateSession(sessionInfo: SessionInfo): Session {
return object : Session() {
…
init {
lifecycle.addObserver(
LifecycleEventObserver { _, event ->
if (event == ON_CREATE) {
val token = ... // MediaSessionCompat.Token
(carContext.getCarService(CarContext.MEDIA_PLAYBACK_SERVICE) as MediaPlaybackManager)
.registerMediaPlaybackToken(token)
}
...
}
)
}
}
}
.registerMediaPlaybackToken es necesario para exponer la información y los controles de reproducción de contenido multimedia a Android Auto. Esto también es importante para que el host cree notificaciones específicas de contenido multimedia.
Organiza contenido multimedia con plantillas
Para organizar contenido multimedia para la navegación, como canciones o álbumes, te recomendamos que uses SectionedItemTemplate, que te permite usar GridSection y RowSection juntos para crear diseños que combinen listas de imágenes y elementos de texto.
Figura 2: Un SectionedItemTemplate que contiene un RowSection seguido de un GridSection
Cómo usar SectionedItemTemplate dentro de TabTemplate
Una forma conveniente de categorizar los medios en tu app es usar SectionedItemTemplate dentro de un TabTemplate.
val template =
SectionedItemTemplate.Builder()...build();
val tabTemplate =
TabTemplate.Builder(tabCallback)
.setTabContents(TabContents.Builder(template).build)
.setHeaderAction(Action.APP_ICON)
…
.build();
Si quieres obtener más información para diseñar la interfaz de usuario de tu app de medios con estas plantillas, consulta Apps de medios.
Cómo navegar a los controles de reproducción
Cuando el usuario explora el contenido multimedia, es importante que pueda navegar rápidamente al MediaPlaybackTemplate con la menor distracción posible. Para cumplir con el requisito de calidad de MFT-1, tu app debe tener una forma de acceder a MediaPlaybackTemplate desde todas las pantallas de exploración de contenido multimedia.
Si usas SectionedItemTemplate, puedes lograr esto agregando un botón de acción flotante que te navegue a la pantalla de reproducción de contenido multimedia. En el caso de otras plantillas, una acción de encabezado es otra forma de lograrlo.