Ciclo de vida do serviço de navegador de mídia
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Esta seção descreve como o Android Automotive OS (AAOS) e o Android Auto
interagem com o serviço de navegação de mídia durante um fluxo de trabalho típico do usuário:
O usuário inicia seu app no AAOS ou no Android Auto.
O app host se vincula ao serviço de navegação de mídia, que o SO inicia se ainda não estiver em execução. Na implementação do método onCreate()
,
crie e registre um objeto MediaSessionCompat
e o respectivo
objeto de callback. Para saber mais, consulte Registrar uma sessão de mídia.
O AAOS ou o Android Auto chama o método onGetRoot
do serviço para
recuperar a raiz na hierarquia de conteúdo. A raiz não é mostrada.
Em vez disso, ele recupera mais conteúdo do seu app nas etapas subsequentes.
O AAOS ou o Android Auto chama o método onLoadChildren()
do serviço para
recuperar os descendentes do item de mídia raiz. O AAOS e o Android Auto
mostram esses itens de mídia como o nível superior dos itens de conteúdo. Consulte
Estruturar o menu raiz para saber mais sobre o que o sistema espera.
Quando o usuário seleciona um item de mídia navegável, o método
onLoadChildren()
do serviço é chamado novamente.
Se o usuário selecionar um item de mídia reproduzível, o AAOS ou o Android Auto vai chamar
o método de callback da sessão de mídia adequado para executar a ação.
Se o app permitir, o usuário também vai poder pesquisar seu conteúdo. Nesse
caso, o AAOS ou o Android Auto chama o método onSearch()
do serviço.
Para saber mais, consulte Exibir resultados de pesquisa navegáveis.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-08-22 UTC.
[null,null,["Última atualização 2025-08-22 UTC."],[],[],null,["# Media browser service lifecycle\n\nThis section describes how Android Automotive OS (AAOS) and Android Auto\ninteract with your media browser service during a typical user workflow:\n\n1. The user launches your app on AAOS or Android Auto.\n\n2. The host app binds to your media browser service, which the OS starts if it\n isn't already running. In your implementation of the `onCreate()` method,\n you must create and register a [`MediaSessionCompat`](/reference/android/support/v4/media/session/MediaSessionCompat) object and its\n callback object. To learn more, see [Register a media session](/training/cars/media/enable-playback#registering_mediasession).\n\n3. AAOS or Android Auto calls your service's [`onGetRoot`](/training/cars/media/content-hierarchy#onGetRoot) method to\n retrieve the root in your content hierarchy. The root is not displayed.\n Instead, it retrieves more content from your app in subsequent steps.\n\n4. AAOS or Android Auto calls your service's [`onLoadChildren()`](/reference/androidx/media/MediaBrowserServiceCompat#onLoadChildren(java.lang.String,androidx.media.MediaBrowserServiceCompat.Result%3Cjava.util.List%3Candroid.support.v4.media.MediaBrowserCompat.MediaItem%3E%3E)%5D) method to\n retrieve the descendants of the root media item. AAOS and Android Auto\n display these media items as the top level of content items. See\n [Structure the root menu](/training/cars/media/content-media-browser/content-hierarchy#root-menu-structure) to learn more about what the system expects.\n\n5. When the user selects a **browsable** media item, your service's\n `onLoadChildren()` method is called again.\n\n6. If the user selects a **playable** media item, AAOS or Android Auto calls\n the appropriate media session callback method to perform the action.\n\n7. If supported by your app, the user can also search your content. In this\n case, AAOS or Android Auto call your service's [`onSearch()`](/reference/androidx/media/MediaBrowserServiceCompat#onSearch(java.lang.String,android.os.Bundle,androidx.media.MediaBrowserServiceCompat.Result%3Cjava.util.List%3Candroid.support.v4.media.MediaBrowserCompat.MediaItem%3E%3E)) method.\n To learn more, see [Display browsable search results](/training/cars/media/create-media-browser/browsable-search)."]]