Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Este guia presume que você 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úsica do Android. Você também vai aprender o que
seu app precisa de MediaBrowserService e MediaSession para ser executado no Android
Auto ou no AAOS. Depois de concluir a infraestrutura de mídia principal, você pode adicionar
suporte para Android Auto e AAOS ao seu app de música.
Conteúdo
Estas páginas detalham como trabalhar com os apps de mídia:
Se o app se concentrar na reprodução de mídia de áudio, use as ferramentas descritas aqui. Você
pode criar apps de mídia para carros de duas maneiras:
Use MediaBrowserService e um MediaSession para criar um app que o Android
Auto e o AAOS possam se conectar. Isso permite que a interface da tela de infoentretenimento
renderize interfaces do usuário de navegação e reprodução de mídia otimizadas para uso
no carro.
Este guia presume que você 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úsica do Android. Este guia
descreve os componentes necessários de um MediaBrowserService e MediaSession
que seu app precisa para ser compatível com o Android Auto ou o AAOS. Depois de
concluir a infraestrutura de mídia principal, você pode
adicionar suporte ao Android Auto e ao AAOS no seu app
de música.
Criar apps de mídia de vídeo
Se o conteúdo principal fornecido pelo seu app for vídeo, consulte:
Estes termos são usados em relação à criação de apps de mídia para carros:
Navegador de mídia
Uma API usada por apps de música para descobrir serviços de navegador de mídia e mostrar
o conteúdo deles. O Android Auto e o AAOS usam um navegador de mídia para
encontrar o serviço de navegação de mídia do seu app.
Serviço de navegador de mídia
Um serviço do Android implementado pelo seu app de mídia de acordo com a
API
MediaBrowserServiceCompat. O app usa esse serviço para expor
conteúdo. Também oferecemos suporte a `MediaLibrarySerice'.
Item de mídia
O navegador de mídia organiza o conteúdo em uma árvore de objetos MediaItem. Um item de mídia pode ter uma ou as duas flags. Um item de mídia que pode ser navegado e reproduzido funciona como uma playlist. Você pode selecionar o item
para reproduzir todos os descendentes ou navegar por eles.
FLAG_PLAYABLE indica que o item é uma folha na árvore de conteúdo.
O item representa um único fluxo de som, como uma música de um álbum,
o capítulo de um audiolivro ou o episódio de um podcast.
FLAG_BROWSABLE indica que o item é um nó na árvore de conteúdo
e tem descendentes. Por exemplo, o item representa um álbum, e seus
descendentes são as músicas dele.
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 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)"]]
