Os apps de mídia que usam os modelos da biblioteca Car App podem personalizar a experiência de navegação e reprodução de mídia, garantindo que ela seja otimizada para telas de carros e minimizando as distrações ao dirigir.
Este guia presume que você já tenha um app de música que reproduz áudio em um smartphone
e que ele seja compatível com a arquitetura de app de mídia do Android. A
biblioteca de apps para carros permite substituir a experiência no app por
modelos em vez de aqueles criados usando a estrutura de dados Criar apps de mídia para carros
MediaBrowser. Você ainda precisa fornecer um MediaSession
para controles de reprodução e um MediaBrowserService, que é usado para
recomendações e outras experiências inteligentes.
Configurar o manifesto do app
Além das etapas descritas em Como usar a biblioteca Android for Cars App, os seguintes requisitos são obrigatórios para apps de mídia com modelos:
Declarar suporte à categoria no manifesto
Seu app precisa declarar a categoria de app para carros
androidx.car.app.category.MEDIA no filtro de intent de
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 ter acesso ao MediaPlaybackTemplate, seu app também
precisa declarar a permissão androidx.car.app.MEDIA_TEMPLATES no
arquivo de manifesto:
<manifest ...>
...
<uses-permission android:name="androidx.car.app.MEDIA_TEMPLATES"/>
...
</manifest>
Definir o nível mínimo da API Car App
Os apps de mídia que usam MediaPlaybackTemplate têm suporte apenas na API CAL 8.
Verifique se o Car App API level mínimo está definido como 8.
<application ...>
...
<meta-data
android:name="androidx.car.app.minCarApiLevel"
android:value="8"/>
...
</application>
Declarar compatibilidade com o Android Auto
Verifique se os seguintes itens estão incluídos no manifesto do app:
<application>
...
<meta-data android:name="com.google.android.gms.car.application"
android:resource="@xml/automotive_app_desc"/>
...
</application>
Em seguida, adicione a declaração template a automotive_app_desc.xml nos recursos
XML. Ele vai ficar assim:
<automotiveApp xmlns:android="http://schemas.android.com/apk/res/android">
<uses name="media"/>
<uses name="template"/>
</automotiveApp>
Fornecer um ícone de atribuição
Adicione um ícone de atribuição para apps de mídia criados com a biblioteca Car App.
Oferecer compatibilidade com comandos de voz
Ative a voz no app para que os usuários possam realizar ações comuns sem usar as mãos.
Consulte Suporte a comandos de voz para mídia para conferir instruções de implementação
mais detalhadas. Com um app de mídia com modelo, se você receber um comando de voz, não
será necessário atualizar o MediaBrowserService com os resultados da pesquisa. Em vez disso,
adicione uma ação no modelo de reprodução de mídia para permitir que o usuário
encontre mais conteúdo com base nessa consulta de reprodução ou pesquisa. A compatibilidade com comandos de voz
é necessária para atender à diretriz de qualidade VC-1.
Criar seu modelo de reprodução
O MediaPlaybackTemplate mostra informações de reprodução
de mídia na biblioteca de apps de mídia para carros. Esse modelo permite definir um
cabeçalho com um título e ações personalizáveis, enquanto as informações de mídia e
os controles de reprodução são preenchidos pelo host com base no estado do
MediaSession do app.
Figura 1:MediaPlaybackTemplate com uma ação de cabeçalho para abrir a fila
na parte de cima.
Este exemplo de código mostra como criar um modelo de reprodução de exemplo que define uma ação de cabeçalho que permite ao usuário navegar até uma tela com a fila de músicas.
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()
Ao usar MediaPlaybackTemplate, registre um
token MediaSession usando o MediaPlaybackManager na
CarAppService. Se isso não for feito, um erro será exibido quando um
MediaPlaybackTemplate for enviado ao 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)
}
...
}
)
}
}
}
O .registerMediaPlaybackToken é necessário para expor informações e controles de
reprodução de mídia ao Android Auto. Isso também é importante para que o host
crie notificações específicas para mídia.
Organizar mídia usando modelos
Para organizar mídias para navegação, como músicas ou álbuns, recomendamos usar o
SectionedItemTemplate,
que permite usar o GridSection e
RowSection juntos para criar layouts que misturam listas de imagens
e itens de texto.
Figura 2. Uma
SectionedItemTemplate contendo um RowSection
seguido por um GridSection.
Como usar o SectionedItemTemplate dentro de um TabTemplate
Uma maneira conveniente de categorizar mídias no app é usar o
SectionedItemTemplate dentro de um
TabTemplate.
val template =
SectionedItemTemplate.Builder()...build();
val tabTemplate =
TabTemplate.Builder(tabCallback)
.setTabContents(TabContents.Builder(template).build)
.setHeaderAction(Action.APP_ICON)
…
.build();
Para saber mais sobre como projetar a interface do usuário do seu app de mídia usando esses modelos, consulte Apps de mídia.
Como navegar até os controles de mídia
Ao navegar pela mídia, é importante que o usuário possa navegar rapidamente
até o MediaPlaybackTemplate com o mínimo de distração. Para atender ao
requisito de qualidade MFT-1, o app precisa ter uma maneira de acessar
o MediaPlaybackTemplate em todas as telas de navegação de mídia.
Se você estiver usando SectionedItemTemplate, adicione um
botão de ação flutuante que navegue até a tela de reprodução de mídia. Para
outros modelos, uma ação de cabeçalho é outra maneira de fazer isso.