Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa guida presuppone che tu abbia un'app multimediale che riproduce audio su uno smartphone e che
la tua app multimediale sia conforme all'architettura delle app multimediali per Android. Scopri anche di cosa ha bisogno la tua app da MediaBrowserService e MediaSession per essere eseguita su Android Auto o AAOS. Una volta completata l'infrastruttura multimediale di base, puoi aggiungere il supporto di Android Auto e AAOS alla tua app multimediale.
Sommario
Queste pagine descrivono in dettaglio come utilizzare le app multimediali:
Se la tua app si concentra sulla riproduzione di contenuti audio, utilizza gli strumenti descritti qui. Puoi
creare app multimediali per le auto in due modi:
Utilizza MediaBrowserService e un MediaSession per creare un'app a cui Android
Auto e AAOS possono connettersi. In questo modo, l'interfaccia dello schermo dell'infotainment
può eseguire il rendering delle interfacce utente di navigazione e riproduzione dei contenuti multimediali ottimizzate per l'utilizzo
in auto.
Questa guida presuppone che tu abbia un'app multimediale che riproduce audio su uno smartphone e che
la tua app multimediale sia conforme all'architettura delle app multimediali di Android. Questa guida
descrive i componenti richiesti di un MediaBrowserService e di un MediaSession
necessari per la compatibilità dell'app con Android Auto o AAOS. Dopo aver
completato l'infrastruttura multimediale di base, puoi
aggiungere il supporto di Android Auto e aggiungere il supporto di AAOS alla tua app
multimediale.
Creare app multimediali video
Se i contenuti principali forniti dalla tua app sono video, consulta:
Questi termini vengono utilizzati in relazione alla creazione di app multimediali per le auto:
Browser multimediale
Un'API utilizzata dalle app multimediali per scoprire i servizi del browser multimediale e per visualizzare
i loro contenuti. Android Auto e AAOS utilizzano un browser multimediale per
trovare il servizio di browser multimediale della tua app.
Servizio di browser multimediale
Un servizio Android implementato dalla tua app multimediale conforme all'API
MediaBrowserServiceCompat. La tua app utilizza questo servizio per esporre
i contenuti. Supportiamo anche `MediaLibrarySerice'.
Elemento multimediale
Il browser dei contenuti multimediali organizza i contenuti in una struttura ad albero di oggetti MediaItem. Un elemento multimediale può avere uno o entrambi questi flag. Un elemento multimediale che può
essere sfogliato per e� riprodotto funziona come una playlist. Puoi selezionare l'elemento
per riprodurre tutti i suoi discendenti oppure puoi sfogliarli.
FLAG_PLAYABLE indica che l'elemento è una foglia dell'albero dei contenuti.
L'elemento rappresenta un singolo stream audio, ad esempio un brano di un album,
un capitolo di un audiolibro o una puntata di un podcast.
FLAG_BROWSABLE indica che l'elemento è un nodo dell'albero dei contenuti
e ha elementi secondari. Ad esempio, l'elemento rappresenta un album e i suoi
discendenti sono i brani dell'album.
I campioni di contenuti e codice in questa pagina sono soggetti alle licenze descritte nella Licenza per i contenuti. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o delle sue società consociate.
Ultimo aggiornamento 2025-08-22 UTC.
[null,null,["Ultimo aggiornamento 2025-08-22 UTC."],[],[],null,["# Media apps for cars overview\n\nThis guide assumes you have a media app that plays audio on a phone and that\nyour media app conforms to Android media app architecture. You also learn what\nyour app needs from `MediaBrowserService` and `MediaSession` to run on Android\nAuto or AAOS. When you complete the core media infrastructure, you can add\nsupport for Android Auto and AAOS to your media app.\n| **Caution:** Google takes driver distraction seriously. Your app must meet specific design requirements before it can be listed on Google Play for Android Auto or AAOS. By adhering to these requirements, you can make it more straightforward to build and test your app. To learn more, see [Android app quality for cars](/docs/quality-guidelines/car-app-quality?category=media).\n\nContents\n--------\n\nThese pages detail how to work with the media apps:\n\n- [Configure the manifest file](/training/cars/media/configure-manifest)\n- [Enable playback controls](/training/cars/media/enable-playback)\n- [Support voice actions](/training/cars/media/voice-actions)\n- [Implement distraction safeguards](/training/cars/media/distraction-safeguards)\n- [Handle errors](/training/cars/media/errors)\n\nCreate audio media apps\n-----------------------\n\nIf your app focuses on playing audio media, use the tools described here. You\ncan create media apps for cars in one of two ways:\n\n1. Use `MediaBrowserService` and a `MediaSession` to create an app that Android\n Auto and AAOS can connect to. This allows the infotainment screen interface\n to render media browsing and playback user interfaces optimized for in-car\n use.\n\n *or*\n2. Use the [Cars App Library](/training/cars/apps) templates to build apps with a customized\n media browsing and playback experience, including custom actions. To learn\n more, see [Build a templated media app](/training/cars/apps/media).\n\n | **Note:** Templated media apps are supported only on Android Auto.\n\n| **Caution:** Aside from [voice guidance audio for navigation apps](/training/cars/apps/navigation#voice-guidance) and the media apps described here, in-app media playback while driving is **not** permitted.\n\nThis guide assumes you have a media app that plays audio on a phone and that\nyour media app conforms to Android [media app architecture](/guide/topics/media-apps/media-apps-overview). This guide\ndescribes the required components of a `MediaBrowserService` and `MediaSession`\nneeded by your app to be compatible with Android Auto or AAOS. After you\ncomplete the core media infrastructure, you can\n[add support for Android Auto](/training/cars/media/auto) and [add support for AAOS](/training/cars/media/automotive-os) to your media\napp.\n\nCreate video media apps\n-----------------------\n\nIf the primary content provided by your app is video, see:\n\n- [Build video apps for Android Automotive OS](/training/cars/parked/video)\n- [Build parked apps for cars](/training/cars/parked)\n\nBefore you start\n----------------\n\nBe sure to consult:\n\n- [Android media API documentation](/guide/topics/media-apps/media-apps-overview)\n- Design guidance: [Create media apps](https://developers.google.com/cars/design/create-apps/app-types/media)\n- Terminology: [Key terms and concepts](#terms-concepts)\n\nLearn key terms and concepts\n----------------------------\n\nThese terms are used in relation to building media apps for cars:\n\nMedia browser\n: An API used by media apps to discover media browser services and to display\n their content. Android Auto and AAOS use a media browser to\n find your app's media browser service.\n\nMedia browser service\n: An Android service implemented by your media app that complies with the\n [`MediaBrowserServiceCompat`](/reference/androidx/media/MediaBrowserServiceCompat) API. Your app uses this service to expose\n content. We also support [\\`MediaLibrarySerice'](/training/cars/media/configure-manifest).\n\nMedia item\n\n: The media browser organizes content in a tree of [`MediaItem`](/training/cars/parked/video) objects. A\n media item can have either or both of these flags. A media item that can\n be browsed for **and** played operates like a playlist. You can select the item\n to play all of its descendants, or you can browse its descendants.\n\n- `FLAG_PLAYABLE` indicates that the item is a leaf on the content tree.\n The item represents a single sound stream, such as a song on an album,\n a chapter in an audio book, or an episode of a podcast.\n\n- `FLAG_BROWSABLE` indicates that the item is a node on the content tree\n and has descendants. For example, the item represents an album, and its\n descendants are the songs on the album.\n\nSee additional resources\n------------------------\n\nFor additional information, see:\n\n- [Universal Media Player sample](//github.com/googlesamples/android-UniversalMusicPlayer)\n- [Audio app overview](/training/managing-audio)\n- [ExoPlayer overview](/guide/topics/media/exoplayer)"]]
