Mídia

Compartilhe conteúdo e controles de mídia com outros apps. Substituída pela Media3.
Atualização mais recente Versão estável Versão candidata a lançamento Versão Beta Versão Alfa
13 de agosto de 2025 1.7.1 - - -

Declarar dependências

Para adicionar uma dependência à Media, adicione o repositório Maven do Google ao seu projeto. Leia Repositório Maven do Google para ver mais informações.

Adicione as dependências dos artefatos necessários ao arquivo build.gradle do seu app ou módulo:

Groovy

dependencies {
    implementation "androidx.media:media:1.7.1"
}

Kotlin

dependencies {
    implementation("androidx.media:media:1.7.1")
}

Para mais informações sobre dependências, consulte Adicionar dependências de build.

Feedback

Seu feedback ajuda a melhorar o Jetpack. Avise se você descobrir novos problemas ou tiver ideias para melhorar esta biblioteca. Consulte os problemas conhecidos nesta biblioteca antes de criar um novo. Adicione seu voto a um problema clicando no botão de estrela.

Criar novo problema

Consulte a documentação do Issue Tracker para saber mais.

Versão 1.7

Versão 1.7.1

13 de agosto de 2025

Lançamento de androidx.media:media:1.7.1. A versão 1.7.1 contém estas confirmações.

Correções de bugs

  • Melhore a performance de MediaSession.setMetadata() reduzindo o número de alocações intermediárias e removendo o empacotamento/desempacotamento desnecessário de bitmaps.

Versão 1.7.0

29 de novembro de 2023

Lançamento de androidx.media:media:1.7.0. A versão 1.7.0 contém estas confirmações.

Mudanças importantes desde a versão 1.6.0

  • Detecção da ForegroundServiceStartNotAllowedException no MediaButtonReceiver e encaminhamento para a onForegroundServiceStartNotAllowedException (I0c939).
  • Adicionamos BROWSER_SERVICE_EXTRAS_KEY_FAVORITES_MEDIA_ITEM para transmitir o item de mídia de favoritos nos extras raiz de MediaBrowserCompat (Id3a11).
  • Adicionamos extras para definir ações personalizadas de navegação em extras de raiz MediaBrowserCompat e descrições de MediaItem (Iab163).
  • Correção de IllegalStateException causada pelo retorno de nulo de MediaBrowserService.onLoadChildren em versões mais antigas do Android.

Versão 1.7.0-rc01

15 de novembro de 2023

Lançamento de androidx.media:media:1.7.0-rc01 sem mudanças. A versão 1.7.0-rc01 contém estas confirmações.

Versão 1.7.0-beta01

1º de novembro de 2023

Lançamento de androidx.media:media:1.7.0-beta01. A versão 1.7.0-beta01 contém estas confirmações.

Correções de bugs

  • Correção de um possível vazamento de memória de MediaBrowserService e MediaBrowserServiceCompat. b/37137738.
  • Correção de IllegalStateException causada pelo retorno de nulo de MediaBrowserService.onLoadChildren em versões mais antigas do Android.

Versão 1.7.0-alpha01

8 de fevereiro de 2023

Lançamento de androidx.media:media:1.7.0-alpha01. A versão 1.7.0-alpha01 contém estas confirmações.

Novos recursos

  • Detecção da ForegroundServiceStartNotAllowedException no MediaButtonReceiver e encaminhamento para a onForegroundServiceStartNotAllowedException (I0c939).
  • Adicionamos BROWSER_SERVICE_EXTRAS_KEY_FAVORITES_MEDIA_ITEM para transmitir o item de mídia de favoritos nos extras raiz de MediaBrowserCompat (Id3a11).
  • Adicionamos extras para definir ações personalizadas de navegação em extras de raiz MediaBrowserCompat e descrições de MediaItem (Iab163).

Versão 1.6.0

Versão 1.6.0

20 de abril de 2022

Lançamento de androidx.media:media:1.6.0. A versão 1.6.0 contém estas confirmações.

Mudanças importantes desde a versão 1.5.0

  • Foram adicionados extras necessários para configurar a página de login/configurações usando CarAppLibrary em um app de música do Android Auto

Versão 1.6.0-rc01

6 de abril de 2022

Lançamento de androidx.media:media:1.6.0-rc01. A versão 1.6.0-rc01 contém estas confirmações.

Versão 1.6.0-beta01

23 de março de 2022

Lançamento de androidx.media:media:1.6.0-beta01. A versão 1.6.0-beta01 contém estas confirmações.

  • Nenhuma mudança desde a última versão Alfa.

Versão 1.6.0-alpha01

23 de fevereiro de 2022

androidx.media:media:1.6.0-alpha01 é lançado. A versão 1.6.0-alpha01 contém estas confirmações.

Mudanças na API

  • Foram adicionados extras necessários para configurar a página de login/configurações usando CarAppLibrary em um app de música do Android Auto (Ifb3ca).

Versão 1.5

Versão 1.5.0

9 de fevereiro de 2022

Lançamento de androidx.media:media:1.5.0. A versão 1.5.0 contém estas confirmações.

Mudanças importantes desde a versão 1.4.0

  • Adição de isVolumeFixed à AudioManagerCompat.
  • Adição da classe MediaConstants para realizar estilizações únicas e mostrar porcentagens de conclusão.
  • A biblioteca não vai mais injetar o filtro de visibilidade de pacotes para a classe MediaBrowserCompat na API de nível 30 ou mais recente. Agora, é necessário especificar um elemento <queries> no manifesto do app.
  • Foi corrigida a mudança inesperada nos extras de getMediaDescription() na API 21.
  • Algumas IllegalStateException foram impedidas na API 19.
  • Foi corrigida uma falha na MediaSessionCompat destinada ao Android 12.
  • Foi corrigida uma falha na NotificationCompat no KitKat.

Versão 1.5.0-rc01

26 de janeiro de 2022

Lançamento de androidx.media:media:1.5.0-rc01 sem mudanças desde 1.5.0-beta01. A versão 1.5.0-rc01 contém estas confirmações.

Versão 1.5.0-beta01

1.º de dezembro de 2021

Lançamento de androidx.media:media:1.5.0-beta01 sem mudanças desde 1.5.0-alpha01. A versão 1.5.0-beta01 contém estas confirmações.

Versão 1.5.0-alpha01

3 novembro de 2021

Lançamento de androidx.media:media:1.5.0-alpha01. A versão 1.5.0-alpha01 contém estas confirmações.

Novos recursos

  • A dependência do núcleo para mídia da versão 1.6.0 foi atualizada.

Mudanças na API

  • O isVolumeFixed foi adicionado à classe AudioManagerCompat.
  • A classe MediaConstants foi adicionada para executar estilizações únicas e mostrar porcentagens de conclusão.

Correções de bugs

  • A biblioteca não vai mais injetar o filtro de visibilidade de pacotes para a classe MediaBrowserCompat na API de nível 30 ou mais recente. Agora, é necessário especificar um elemento <queries> no manifesto do app.
  • Foi corrigida a mudança inesperada nos extras de getMediaDescription() na API 21.
  • Foi corrigido o uso ineficiente de ArrayList com a definição do tamanho padrão.
  • Algumas IllegalStateExceptions foram bloqueadas na API 19.
  • Foi corrigida uma falha na MediaSessionCompat destinada ao Android 12.
  • Foi corrigida uma falha na NotificationCompat no KitKat.

Versão 1.4

Versão 1.4.3

13 de outubro de 2021

androidx.media:media:1.4.3 é lançado. A versão 1.4.3 contém estas confirmações.

Correções de bugs

  • A biblioteca não injetará mais o filtro de visibilidade do pacote para o MediaBrowserCompat. Especifique um elemento <queries> no manifesto do app ao direcionar para a API de nível 30 ou mais recente (I0a964, b/185314633).

Versão 1.4.2

15 de setembro de 2021

Lançamento de androidx.media:media:1.4.2. A versão 1.4.2 contém estas confirmações.

Correções de bugs

  • Correção do efeito colateral do getMediaDescription() na API 21 (I5c05f).

Versão 1.4.1

4 de agosto de 2021

Lançamento de androidx.media:media:1.4.1. A versão 1.4.1 contém estas confirmações.

Correções de bugs

  • A sinalização de mutabilidade para criar PendingIntent a fim de evitar falhas ao destinar ao Android S foi corrigida.
  • Correção da ClassVerificationFailure para NotificationCompat.MediaStyle.

Versão 1.4.0

21 de julho de 2021

Lançamento de androidx.media:media:1.4.0. A versão 1.4.0 contém estas confirmações.

Mudanças importantes desde a versão 1.3.0

  • Adição de uma nova chave de pacote METADATA_KEY_SERIES_CONTENT_ID, usada no ID de conteúdo de mídia de séries de TV em MediaMetadataCompat.
  • Adição de uma nova chave de pacote METADATA_KEY_NEXT_EPISODE_CONTENT_ID, usada no ID de conteúdo do próximo episódio de séries de TV em MediaMetadataCompat.
  • Descontinuação de MediaControllerCompat.TransportControls#EXTRA_LEGACY_STREAM_TYPE e adição de MediaConstants#TRANSPORT_CONTROLS_EXTRAS_KEY_LEGACY_STREAM_TYPE.
  • Nova chave extra para a reprodução aleatória de mídia de playFromUri.
  • Adição da anotação @Nullable à classe Result.
  • Correção da ausência do EXTRA_KEY_EVENT da intent para MediaButtonReceiver.

Versão 1.4.0-rc01

30 de junho de 2021

androidx.media:media:1.4.0-rc01 é lançado sem mudanças desde 1.4.0-beta01. A versão 1.4.0-rc01 contém estas confirmações.

Versão 1.4.0-beta01

17 de junho de 2021

Lançamento de androidx.media:media:1.4.0-beta01. A versão 1.4.0-beta01 contém estas confirmações.

Mudanças na API

  • Uma nova chave de pacote METADATA_KEY_SERIES_CONTENT_ID usada no ID de conteúdo de mídia de séries de TV em MediaMetadataCompat foi adicionada

  • Uma nova chave de pacote METADATA_KEY_NEXT_EPISODE_CONTENT_ID usada no ID de conteúdo do próximo episódio da série de TV em MediaMetadataCompat foi adicionada

Versão 1.4.0-alpha01

5 de maio de 2021

Lançamento de androidx.media:media:1.4.0-alpha01. A versão 1.4.0-alpha01 contém estas confirmações.

Mudanças na API

  • Descontinuação de MediaControllerCompat.TransportControls#EXTRA_LEGACY_STREAM_TYPE e adição de MediaConstants#TRANSPORT_CONTROLS_EXTRAS_KEY_LEGACY_STREAM_TYPE (I62f17).
  • Nova chave extra para a reprodução aleatória de mídia de playFromUri (Ibc63c).
  • A anotação @Nullable foi adicionada à classe Result (I2d617).

Correções de bugs

  • Correção da ausência do EXTRA_KEY_EVENT da intent para o MediaButtonReceiver (If7557).

Versão 1.3.1

Versão 1.3.1

5 de maio de 2021

Lançamento de androidx.media:media:1.3.1. A versão 1.3.1 contém estas confirmações.

Correções de bugs

  • Correção da ausência do EXTRA_KEY_EVENT da intent para MediaButtonReceiver (If7557).

Versão 1.3.0

Versão 1.3.0

7 de abril de 2021

Lançamento de androidx.media:media:1.3.0. A versão 1.3.0 contém estas confirmações.

Principais mudanças desde a versão 1.2.0

  • Migração dos extras do Android Auto para MediaConstants.

Versão 1.3.0-rc02

24 de março de 2021

Lançamento de androidx.media:media:1.3.0-rc02. A versão 1.3.0-rc02 contém estas confirmações.

Correções de bugs

  • Defina FLAG_IMMUTABLE como a PendingIntent do MediaButtonReceiver. Isso é obrigatório para apps destinados ao Android 12.
  • Uma NullPointerException na MediaSessionCompat com o nível 27 da API após setCallback(null) foi corrigida.

Versão 1.3.0-rc01

10 de Março de 2021

Lançamento de androidx.media:media:1.3.0-rc01. A versão 1.3.0-rc01 contém estas confirmações.

Nenhuma mudança desde a versão 1.3.0-beta01.

Versão 1.3.0-beta01

10 de fevereiro de 2021

Lançamento de androidx.media:media:1.3.0-beta01. A versão 1.3.0-beta01 contém estas confirmações.

Mudanças na API

  • Adição de uma nova constante PlaybackStateCompat.ACTION_SET_PLAYBACK_SPEED (I9d076, link em inglês).
  • Migração dos extras do Android Auto para MediaConstants (I290ab, link em inglês).
  • Adição de constantes para restringir filhos raiz do MediaBrowserService (Ifcebd, link em inglês).

Correções de bugs

  • Adição de FLAG_RECEIVER_FOREGROUND ao botão de mídia com intent pendente.

Version 1.2.1

Media versão 1.2.1

2 de dezembro de 2020

Lançamento de androidx.media:media:1.2.1. A versão 1.2.1 contém estas confirmações.

Correções de bugs

  • Correção de NPE após chamar MediaSessionCompat#setCallback(null) na API 27

Versão 1.2.0

Versão 1.2.0

16 de setembro de 2020

androidx.media:media:1.2.0 é lançado. A versão 1.2.0 contém estas confirmações.

Principais mudanças desde a versão 1.1.0

  • Inclusão de suporte a AudioAttributesCompat#setLegacyStreamType para o SDK anterior à versão 21.
  • Suporte de controle de volume para a biblioteca androidx.mediarouter.
  • Melhor suporte de interoperabilidade entre androidx.media e androidx.media2.

Versão 1.2.0-rc01

2 de setembro de 2020

androidx.media:media:1.2.0-rc01 é lançado sem mudanças desde 1.2.0-beta01. A versão 1.2.0-rc01 contém estas confirmações.

Versão 1.2.0-beta01

19 de agosto de 2020

androidx.media:media:1.2.0-beta01 é lançado. A versão 1.2.0-beta01 contém estas confirmações.

Novos recursos

  • Foi incluído suporte a AudioAttributesCompat#setLegacyStreamType para níveis de API anteriores ao 21.

Mudanças na API

  • Adição de MediaConstants#PLAYBACK_STATE_EXTRAS_KEY_MEDIA_ID no código da mídia em extras PlaybackStateCompat, que precisam ser os mesmos que MediaMetadataCompat#METADATA_KEY_MEDIA_ID dos metadados atuais.

Correções de bugs

  • Correção de um problema com AudioAttributesCompat.Builder#setContentType.

Versão 1.2.0-alpha04

24 de junho de 2020

androidx.media:media:1.2.0-alpha04 é lançado. A versão 1.2.0-alpha04 contém estas confirmações.

Novos recursos

  • Nova maneira de oferecer suporte ao controle de volume para a biblioteca mediarouter.

Mudanças na API

  • Adição de AudioManagerCompat#getStreamMaxVolume.
  • Adição de AudioManagerCompat#getStreamMinVolume.

Correções de bugs

  • Correção de um problema de interoperabilidade entre media e media2 no SDK < 21.

Versão 1.2.0-alpha03

10 de junho de 2020

androidx.media:media:1.2.0-alpha03 é lançado. A versão 1.2.0-alpha03 contém estas confirmações.

Mudanças na API

  • MediaConstants.SESSION_EXTRAS_KEY_AUTHTOKEN foi removido.

Correções de bugs

  • Correção de um problema com equals() de RemoteUserInfo

Versão 1.2.0-alpha02

15 de abril de 2020

androidx.media:media:1.2.0-alpha02 é lançado. A versão 1.2.0-alpha02 contém estas confirmações.

Correções de bugs

  • Impedir modificações de classes VersionedParcelable.

Versão 1.2.0-alpha01

23 de outubro de 2019

androidx.media:media:1.2.0-alpha01 é lançado. A versão 1.2.0-alpha01 contém estas confirmações (link em inglês).

Mudanças na API

  • Os seguintes métodos foram adicionados:
    • MediaSessionCompat.Callback.onSetPlaybackSpeed()
    • MediaControllerCompat.setPlaybackSpeed()
    • MediaControllerCompat.getSessionInfo()

Correções de bugs

  • Foi implementada a prevenção contra uma BadParcelableException ao transmitir um objeto Bundle por uma chamada IPC.
  • O construtor de MediaControllerCompat não gera mais um RemoteException.
  • Implementação da prevenção contra a chamada de métodos de callback após MediaSessionCompat.release().

Versão 1.1.0

Versão 1.1.0

5 de setembro de 2019

Lançamento de androidx.media:media:1.1.0. As confirmações incluídas nessa versão podem ser encontradas neste link (em inglês).

Importar mudanças desde a versão 1.0.0

  • Lançamento de AudioAttributesCompat

Versão 1.1.0-rc01

13 de junho de 2019

Lançamento do androidx.media:media:1.1.0-rc01 sem mudanças desde o 1.1.0-beta02. As confirmações incluídas nessa versão podem ser encontradas neste link (em inglês).

Versão 1.1.0-beta02

5 de junho de 2019

androidx.media:media:1.1.0-beta02 é lançado. As confirmações incluídas nessa versão podem ser encontradas aqui (link em inglês).

Correções de bugs

  • O escopo de restrição dos métodos ocultos usados por media2-session foi flexibilizado para LIBRARY_GROUP_PREFIX.

Versão 1.1.0-beta01

7 de maio de 2019

Lançamento de androidx.media:media:1.1.0-beta01. As confirmações incluídas nessa versão podem ser encontradas neste link.

Novos recursos

  • Mudança de IllegalPointerException para NullPointerException para os argumentos nulos marcados como @NonNull.

Versão 1.1.0-alpha04

3 de abril de 2019

Lançamento de androidx.media:media:1.1.0-alpha04. As confirmações incluídas nessa versão podem ser encontradas aqui (link em inglês).

Correções de bugs

  • Ajuste em uma constante de teste de compatibilidade de versão (aosp/933656).

Versão 1.1.0-alpha03

21 de março de 2019

androidx.media:media:1.1.0-alpha03 é lançado. A lista completa de confirmações incluídas nessa versão pode ser encontrada aqui (link em inglês).

Correções de bugs

  • A falha de MedaBrowserServiceCompat quando vários MediaBrowserCompat tentam se conectar a ela foi corrigida (aosp/930246, link em inglês).

Versão 1.1.0-alpha02

13 de março de 2019

androidx.media:media:1.1.0-alpha02 é lançado. A lista completa de confirmações incluídas nessa versão pode ser encontrada aqui (link em inglês).

Correções de bugs

  • Correção da falha de MediaBrowserCompat durante a conexão
  • Correção de IllegalStateException em getCurrentBrowserInfo()/getBrowserRootHints()
  • MediaBrowserServiceCompat.getCurrentBrowserInfo() agora retorna a mesma instância RemoteUserInfo para o mesmo MediaBrowserCompat em onGetRoot()

Versão 1.0.1

Versão 1.0.1

30 de janeiro de 2019

Lançamento de androidx.media:media 1.0.1.

Correções de bugs

  • Correção do erro de uma IllegalStateException inesperada ao usar MediaBrowserCompat.connect() (aosp/858075).

Versão 1.0.0

Versão 1.0.0-alpha06

17 de dezembro de 2018

Mudanças na API

Mudança dos nomes das classes e do pacote media.widget da seguinte forma:

  • androidx.media.widget.VideoView2 → androidx.media2.widget.VideoView
  • androidx.media.widget.MediaControlView2 → androidx.media2.widget.MediaControlView

Versão 1.0.0-alpha01

3 de dezembro de 2018

Mudanças na API

  • Dois tipos de sinalização MediaSessionCompat foram descontinuados:
    • FLAG_HANDLES_MEDIA_BUTTONS
    • FLAG_HANDLES_TRANSPORT_CONTROLS