A partir de 27 de março de 2025, recomendamos usar android-latest-release
em vez de aosp-main
para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.
Visão geral
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Media fornece uma plataforma para criar apps de mídia que ofereçam experiências de infoentretenimento seguras,
seamless e conectadas em todos os carros com Android.
O Media é um aplicativo do sistema Android projetado para oferecer uma
experiência de reprodução e navegação
Distraction Optimized (DO) para apps de mídia. Uma implementação totalmente funcional de mídia está incluída no
Android Open Source Project (AOSP).
Figura 1. Exemplos de implementação da tela de mídia.
Para saber mais sobre mídia, consulte as seguintes páginas:
- Componentes do sistema e fluxos de usuários.
Saiba mais sobre os componentes que interagem com a mídia e os fluxos de usuários mais comuns.
- Implementar o rádio com mídia.
Leia como integrar a interface do rádio com a mídia para permitir que os usuários interajam com fontes de mídia
e rádio como se fossem um único aplicativo.
- Personalizar mídia.
Aprenda a trabalhar com estilos e recursos definidos em diferentes níveis na estrutura do AOSP.
- Implementar um cartão de mídia.
Implemente um card de mídia para mostrar metadados de mídia, como títulos, capa do álbum e muito mais. Um card de mídia
também pode mostrar uma fila de itens de mídia, como uma playlist.
Terminologia
Estes termos são usados nesta seção.
Fonte de mídia
Um app Android que implementa a API MediaBrowserService
para expor o controle de reprodução e a navegação do catálogo de itens de mídia.
Item de mídia
Um elemento no catálogo de fontes de mídia. Os itens de mídia podem ser:
- Itens de mídia reproduzíveis. Segmentos de áudio que podem ser reproduzidos pelo
sistema, como músicas, capítulos de livros e episódios de podcasts
- Itens de mídia que podem ser navegados. Elementos organizacionais usados para agrupar
itens de mídia reproduzíveis ou outros itens de mídia que podem ser navegados, como categorias de músicas, uma pasta de músicas recentes,
além de podcasts e itens de mídia que podem ser reproduzidos, classificados por artista, autor ou público.
A mídia oferece esses recursos.
Ao dirigir |
Enquanto o veículo está estacionado |
---|
Controle de mídia.
-
Apresentação do item de mídia que está sendo reproduzido (por exemplo, uma música), incluindo título,
capa do álbum, duração, descrição e posição de reprodução atual.
-
Execução de ações de mídia padrão (por exemplo, reproduzir, parar, pausar e pular
para a frente).
-
Execução de ações de mídia personalizadas (ações personalizadas fornecidas por cada fonte de mídia).
-
Apresentação da fila de reprodução, se fornecida pelo app de mídia.
Procurar no catálogo.
-
Exibição de categorias de nível superior.
-
Acesse itens de mídia pesquisáveis (por exemplo, pastas).
-
Seleção de itens de mídia reproduzíveis (por exemplo, músicas), incluindo título, capa do álbum e
indicadores. Por exemplo, conteúdo explícito e conteúdo transferido por download.
|
Tudo o que está listado em Ao dirigir, além de:
-
Fazer login. Para as origens de mídia que exigem login, é possível
iniciar o fluxo de login diretamente da mídia.
-
Configurações. A fonte de mídia pode mostrar uma interface de configurações.
-
Pesquisar com o teclado. Os usuários podem realizar uma pesquisa de texto na mídia.
|
Tarefas
Esta tabela descreve as tarefas de cada parte.
Fabricantes de veículos (vOEMs) |
Google |
Desenvolvedores de apps |
---|
- Crie um sistema de infoentretenimento CDD do Android
totalmente compatível com o Android Automotive.
- Atenda a todas as expectativas das APIs MediaSession e Browser e a interoperabilidade com
a mídia:
- Respeite a estrutura de navegação.
- Respeite as ações personalizadas.
- Delegar ao app o login, as configurações e assim por diante.
- Respeite os elementos de marca do app explicitamente compatíveis com as APIs. Por exemplo, o
nome do app.
|
- Definir e atualizar as APIs de mídia.
- Fornecer implementação de mídia no AOSP.
- Definir o processo de análise de apps para publicação de apps de mídia na Play Store.
- Fornecer documentação para elementos como APIs, personalizações, revisão e
processos de certificação
|
- Implementar APIs Media:
- Forneça a estrutura geral de navegação de mídia com o conteúdo apropriado.
- Forneça ações personalizadas conforme apropriado.
- Disponibiliza os estados de reprodução para o sistema.
- Forneça elementos de marca, como o nome do app.
- Implemente os fluxos de login, inscrição, configurações e resolução de erros conforme necessário.
- Crie e publique APKs para carros na Play Store.
|
Diretrizes de personalização
A implementação de mídia incluída no AOSP usa a
Biblioteca de interface do carro para permitir
personalização e fornece um tema e uma estrutura básicos que podem ser adotados como estão ou modificados
de acordo com as seguintes restrições. A tabela a seguir descreve as responsabilidades do OEM
em relação à personalização de mídia.
Personalização de mídia |
Descrição |
---|
DEVE |
Ajustar o tema e o estilo geral, incluindo a paleta de cores e o tamanho. |
MAI |
Modifique a estrutura de alto nível da mídia (por exemplo, posicionamento da guia). |
NÃO É PERMITIDO |
Modificar contratos da API Media, incluindo o branding do app:
- Interoperabilidade da MediaSession e do MediaBrowser
- Nome e ícone da fonte de mídia
Modificar a arquitetura da informação de:
- Reprodução
- Procurar
- Pesquisar
|
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-07-27 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-27 UTC."],[],[],null,["# Overview\n\n*Media* provides a platform on which to build media apps that provide safe,\nseamless, and connected infotainment experiences in every Android-enabled car.\nMedia is an Android system application designed to provide a\n[Distraction Optimized (DO)](/docs/automotive/driver_distraction/guidelines) playback\nand browse experience for media apps. A fully functional implementation of Media is included with\n[Android Open Source Project (AOSP)](/).\n\n\n\u003cbr /\u003e\n\n\n**Figure 1.** Media screen sample implementations.\n\nTo learn about Media, see the following pages:\n\n- **[System components and user flows](/docs/automotive/hmi/media/technical_details).** Learn more about the components that interact with Media, as well as the most common user flows.\n- **[Implement radio with media](/docs/automotive/hmi/media/radio).** Read how to integrate the Radio UI with Media to provide enable users to interact with media sources and radio as if they were a single application.\n- **[Customize media](/docs/automotive/hmi/media/customization).** Learn how to work with styles and assets defined at different levels in the AOSP structure.\n- **[Implement a media card](/docs/automotive/hmi/media/media-card).** Implement a media card to display media metadata such as titles, album art, and more. A media card can also display a queue of media items, such as a playlist.\n\nTerminology\n-----------\n\nThese terms are used in this section.\nMedia Source An Android app that implements the Android [MediaBrowserService API](https://developer.android.com/guide/topics/media-apps/audio-app/building-an-audio-app) to expose playback control and browsing of its catalog of media items. Media Item An element in the Media Source catalog. Media items can be either:\n\n- Playable Media items. Audio segments that can be played by the system such as songs, chapters of books, and episodes of podcasts\n- Browsable Media items. Organizational elements used to group playable or other browseable media items such as song categories, a recent songs folder, as well as podcasts and playable media items sorted by artist, author, or audience.\n\nMedia features\n--------------\n\nMedia provides these features.\n\n| While driving | While parked |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Playback control. - Presentation of currently playing media item (for example, a song), including title, album art, duration, description, and current play position. - Execution of standard media actions (for example, play, stop, pause, and skip forward). - Execution of custom media actions (custom actions provided by each media source). - Presentation of the playback queue, if provided by the media app. Catalog browse. - Display of top-level categories. - Drill down into browse-able media items (for example, folders). - Selection of playable media items (for example, songs) including title, album art, and indicators. For example, explicit content and downloaded content. | Everything listed under *While Driving* as well as: - Sign-in. For those media sources that require sign-in, it should be possible to start the sign in flow directly from Media. - Settings. Media source can display a settings UI. - Search, with keyboard. Users can perform a text search on Media. |\n\nTasks\n-----\n\nThis table describes the tasks of each party.\n\n| Vehicle makers (vOEMs) | Google | App developers |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| - Build a fully-compliant [Android CDD](/docs/compatibility/10/android-10-cdd) infotainment system with Android Automotive. - Fulfill all expectations of MediaSession and Browser APIs and the interoperability with Media: - Respect browse structure. - Respect custom actions. - Delegate to the app for sign-in, settings, and so on. - Respect the app branding elements explicitly supported by the APIs. For example, the app name. | - Define and evolve Media APIs. - Provide Media implementation in AOSP. - Define app review process for publishing of media apps on Play Store. - Provide documentation for elements such as APIs, customizations, review, and certification processes | - Implement Media APIs: - Provide overall media browse structure with appropriate content. - Provide custom actions as appropriate. - Make playback states available to the system. - Provide branding elements, such as app name. - Implement the sign-in, sign-up, settings, and error resolution flows, as needed. - Build and publish car APKs to the Play Store. |\n\nCustomization guidelines\n------------------------\n\nThe Media implementation included in AOSP uses\n[Car UI Library](/docs/automotive/hmi/car_ui) to enable\ncustomization and provides a base theme and structure that can be adopted as is or modified\naccording to the following restrictions. The following table describes OEM responsibilities\nregarding Media customization.\n\n| Media customization | Description |\n|---------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| SHOULD | Adjust overall theme and styling, including color pallette and sizing. |\n| MAY | Modify the high-level structure of Media (for example, tab placement). |\n| MUST NOT | Modify Media API contracts, including app branding: - MediaSession and MediaBrowser interoperability - Media source name, icon Modify information architecture of: - Playback - Browse - Search |"]]