Controles de mídia na interface do sistema

No Android 13 e versões mais recentes, os controles de mídia na interface do sistema contêm atualizações nos botões de ação e na reprodução remota. Essas mudanças oferecem uma experiência de controle de mídia mais sofisticada em smartphones e tablets, além de transferências de mídia perfeitas em vários dispositivos.

Atualizações nos controles de mídia

Esta seção descreve as atualizações feitas nos controles de mídia do Android 13 para botões de ação e reprodução remota.

Mudanças nos botões de ação

Para garantir que os usuários possam acessar um conjunto avançado de controles de mídia para apps que reproduzem mídia, os botões de ação nos controles de mídia do Android 13 são derivados dos PlaybackState estados de ação. Com essa mudança, a função MediaDataManager#createActionsFromState gera informações de botões de ação com base no estado de ação PlaybackState. Isso se alinha à forma como os controles de mídia são renderizados em outras plataformas Android, como Auto, Assistente e Wear.

Por outro lado, no Android 12, os botões de ação nos controles de mídia eram determinados por ações de notificação adicionadas a uma notificação.MediaStyle

Para um resumo das mudanças compatíveis com o app para as atualizações de botões de ação, consulte StatusBarManager.

API de reprodução remota

Para oferecer uma experiência de mídia coesa em várias plataformas, a partir do Android 13, uma nova API do sistema Notification#setRemotePlaybackInfo é adicionada para marcar notificações de mídia na interface do sistema de controle de mídia para reprodução remota. Essa API permite que os apps do sistema que postam as notificações façam o seguinte:

  • Fornecer informações e funcionalidades para mídia originada em um dispositivo remoto para o seletor de saída padrão no controle de mídia.
  • Substituir a conveniência do seletor de saída, se necessário.

Os apps do sistema que usam essa notificação precisam ter a permissão MEDIA_CONTENT_CONTROL.

A API Notification#setRemotePlaybackInfo também adiciona os seguintes extras para determinar o nome, o ícone e a intent do dispositivo de reprodução remota:

  • Notification#EXTRA_MEDIA_REMOTE_DEVICE
  • Notification#EXTRA_MEDIA_REMOTE_ICON
  • Notification#EXTRA_MEDIA_REMOTE_INTENT

Com essas informações, a interface do sistema pode substituir as informações do dispositivo de chip do seletor de saída padrão e adicionar o controle de mídia para reprodução remota ao final da lista de controles de mídia locais.

Implementação do controle de mídia

Os OEMs precisam estar cientes dessa mudança no comportamento padrão, porque ela afeta a forma como os controles de mídia para apps são gerados. Os OEMs também precisam garantir que a nova API do sistema funcione conforme aplicável na conveniência do seletor de saída.

Os OEMs não precisam fazer mudanças e podem usar a implementação padrão no AOSP.

Personalização da reprodução remota

Nos casos em que o OEM tem um app do sistema que posta notificações de reprodução de mídia remota, o app pode chamar setRemotePlaybackInfo para notificação, desde que tenha recebido a permissão MEDIA_CONTENT_CONTROL. No entanto, esse não é um requisito, e o parceiro pode optar por não personalizar.

Validação do controle de mídia

Para testar o controle de mídia na interface do sistema, execute um teste manual para validar o seguinte:

  • Os botões funcionam conforme esperado ao reproduzir mídia de um app.
  • O seletor de saída mostra as informações corretas do dispositivo.

Use os testes a seguir para validar a API de reprodução remota:

Consulte o novo requisito do CDD [3.8.3.1/H-1-SR] para recomendações.