Cycle de vie du service de navigateur multimédia
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Cette section explique comment Android Automotive OS (AAOS) et Android Auto interagissent avec votre service de navigateur multimédia au cours d'un workflow utilisateur standard :
L'utilisateur lance votre application sur AAOS ou Android Auto.
L'application hôte se lie à votre service de navigateur multimédia, que l'OS démarre s'il n'est pas déjà en cours d'exécution. Dans l'implémentation de la méthode onCreate(), vous devez créer et enregistrer un objet MediaSessionCompat ainsi que son objet de rappel. Pour en savoir plus, consultez Enregistrer une session multimédia.
AAOS ou Android Auto appelle la méthode onGetRoot de votre service pour récupérer la racine de votre hiérarchie de contenu. La racine n'est pas affichée.
Il récupère plutôt plus de contenu de votre application lors des étapes suivantes.
AAOS ou Android Auto appelle la méthode onLoadChildren() de votre service pour récupérer les descendants de l'élément multimédia racine. AAOS et Android Auto affichent ces éléments multimédias en tant que premier niveau d'éléments de contenu. Consultez la section Structurer le menu racine pour en savoir plus sur les attentes du système.
Lorsque l'utilisateur sélectionne un élément multimédia consultable, la méthode onLoadChildren() de votre service est de nouveau appelée.
Si l'utilisateur sélectionne un élément multimédia lisible, AAOS ou Android Auto appelle la méthode de rappel de la session multimédia appropriée pour effectuer l'action.
Si votre application l'y autorise, l'utilisateur peut également effectuer des recherches dans votre contenu. Dans ce cas, AAOS ou Android Auto appelle la méthode onSearch() de votre service.
Pour en savoir plus, consultez Afficher des résultats de recherche consultables.
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/22 (UTC).
[null,null,["Dernière mise à jour le 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)."]]
