Contenido multimedia

Comparte contenido y controles multimedia con otras apps. Sustituida por media3.
Actualización más reciente Versión estable Versión potencial Versión beta Versión alfa
29 de noviembre de 2023 1.7.0 - - -

Cómo declarar dependencias

Para agregar una dependencia en Media, debes agregar el repositorio de Maven de Google a tu proyecto. Consulta el repositorio de Maven de Google para obtener más información.

Agrega las dependencias de los artefactos que necesites en el archivo build.gradle de tu app o módulo:

Groovy

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

Kotlin

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

Para obtener más información sobre las dependencias, consulta Cómo agregar dependencias de compilación.

Comentarios

Tus comentarios ayudan a mejorar Jetpack. Avísanos si descubres nuevos errores o tienes ideas para mejorar esta biblioteca. Consulta los errores existentes de esta biblioteca antes de crear uno nuevo. Puedes agregar tu voto a un error existente haciendo clic en el botón de la estrella.

Crear un error nuevo

Consulta la documentación sobre la Herramienta de seguimiento de errores para obtener más información.

Versión 1.7

Versión 1.7.0

29 de noviembre de 2023

Lanzamiento de androidx.media:media:1.7.0. La versión 1.7.0 contiene estas confirmaciones.

Cambios importantes desde la versión 1.6.0

  • Se capturó ForegroundServiceStartNotAllowedException en MediaButtonReceiver y se lo reenvió a onForegroundServiceStartNotAllowedException. (I0c939).
  • Se agregó BROWSER_SERVICE_EXTRAS_KEY_FAVORITES_MEDIA_ITEM para pasar el elemento multimedia de Favoritos en los servicios adicionales raíz MediaBrowserCompat (Id3a11).
  • Se agregaron servicios adicionales para configurar acciones personalizadas de exploración en los servicios adicionales raíz MediaBrowserCompat y en las descripciones de MediaItem (Iab163).
  • Se corrigió IllegalStateException que se generaba cuando se mostraba un valor nulo desde MediaBrowserService.onLoadChildren en versiones anteriores de Android.

Versión 1.7.0-rc01

15 de noviembre de 2023

Se lanzó androidx.media:media:1.7.0-rc01 sin cambios. La versión 1.7.0-rc01 contiene estas confirmaciones.

Versión 1.7.0-beta01

1 de noviembre de 2023

Lanzamiento de androidx.media:media:1.7.0-beta01. La versión 1.7.0-beta01 contiene estas confirmaciones.

Correcciones de errores

  • Se corrigió una posible fuga de memoria de MediaBrowserService y MediaBrowserServiceCompat. b/37137738.
  • Se corrigió el error IllegalStateException que se generaba cuando se mostraba un valor nulo desde MediaBrowserService.onLoadChildren en versiones anteriores de Android.

Versión 1.7.0-alpha01

8 de febrero de 2023

Lanzamiento de androidx.media:media:1.7.0-alpha01. La versión 1.7.0-alpha01 contiene estas confirmaciones.

Nuevas funciones

  • Se capturó ForegroundServiceStartNotAllowedException en MediaButtonReceiver y se lo reenvió a onForegroundServiceStartNotAllowedException (I0c939).
  • Se agregó BROWSER_SERVICE_EXTRAS_KEY_FAVORITES_MEDIA_ITEM para pasar el elemento multimedia de Favoritos en los servicios adicionales raíz MediaBrowserCompat (Id3a11).
  • Se agregaron servicios adicionales para configurar acciones personalizadas de exploración en los servicios adicionales raíz MediaBrowserCompat y en las descripciones de MediaItem (Iab163).

Versión 1.6.0

Versión 1.6.0

20 de abril de 2022

Se lanzó androidx.media:media:1.6.0. La versión 1.6.0 contiene estas confirmaciones.

Cambios importantes desde la versión 1.5.0

  • Se agregaron elementos adicionales necesarios para configurar la página de acceso o configuración con CarAppLibrary en una app de música de Android Auto

Versión 1.6.0-rc01

6 de abril de 2022

Lanzamiento de androidx.media:media:1.6.0-rc01. La versión 1.6.0-rc01 contiene estas confirmaciones.

Versión 1.6.0-beta01

23 de marzo de 2022

Lanzamiento de androidx.media:media:1.6.0-beta01. La versión 1.6.0-beta01 contiene estas confirmaciones.

  • Sin modificaciones desde la última versión alfa.

Versión 1.6.0-alpha01

23 de febrero de 2022

Lanzamiento de androidx.media:media:1.6.0-alpha01. La versión 1.6.0-alpha01 contiene estas confirmaciones.

Cambios en la API

  • Se agregaron elementos adicionales necesarios para configurar la página de acceso o configuración con CarAppLibrary en una app de música de Android Auto (Ifb3ca).

Versión 1.5

Versión 1.5.0

9 de febrero de 2022

Lanzamiento de androidx.media:media:1.5.0. La versión 1.5.0 contiene estas confirmaciones.

Cambios importantes desde la versión 1.4.0

  • Se agregó isVolumeFixed a AudioManagerCompat.
  • Se agregó MediaConstants para el estilo de un solo elemento y el porcentaje de finalización.
  • En el caso del nivel de API 30 o posteriores, la biblioteca no insertará el filtro de visibilidad del paquete de MediaBrowserCompat. Debes especificar un elemento <queries> en el manifiesto de tus apps.
  • Se corrigió el cambio inesperado de servicios adicionales getMediaDescription() en el nivel de API 21.
  • Se evitaron algunos IllegalStateException en el nivel de API 19.
  • Se corrigió una falla en MediaSessionCompat cuando se orienta a Android 12.
  • Se corrigió una falla en NotificationCompat en KitKat.

Versión 1.5.0-rc01

26 de enero de 2022

Lanzamiento de androidx.media:media:1.5.0-rc01 sin cambios desde 1.5.0-beta01. La versión 1.5.0-rc01 contiene estas confirmaciones.

Versión 1.5.0-beta01

1 de diciembre de 2021

Lanzamiento de androidx.media:media:1.5.0-beta01 sin cambios desde 1.5.0-alpha01. La versión 1.5.0-beta01 contiene estas confirmaciones.

Versión 1.5.0-alpha01

3 de noviembre de 2021

Lanzamiento de androidx.media:media:1.5.0-alpha01. La versión 1.5.0-alpha01 contiene estas confirmaciones.

Nuevas funciones

  • Se actualizó la dependencia en núcleo para contenido multimedia a 1.6.0.

Cambios en la API

  • Se agregó isVolumeFixed a AudioManagerCompat.
  • Se agregó MediaConstants para el estilo de un solo elemento y el porcentaje de finalización.

Correcciones de errores

  • En el caso del nivel de API 30 o posteriores, la biblioteca no insertará el filtro de visibilidad del paquete de MediaBrowserCompat. Debes especificar un elemento <queries> en el manifiesto de tus apps.
  • Se corrigió el cambio inesperado de servicios adicionales de getMediaDescription() en el nivel de API 21.
  • Se corrigió el uso ineficiente de ArrayList con la configuración del tamaño predeterminado.
  • Se evitaron algunas IllegalStateException en el nivel de API 19.
  • Se corrigió una falla en MediaSessionCompat cuando se orienta a Android 12.
  • Se corrigió una falla en NotificationCompat en KitKat.

Versión 1.4

Versión 1.4.3

13 de octubre de 2021

Se lanzó androidx.media:media:1.4.3. La versión 1.4.3 contiene estas confirmaciones.

Correcciones de errores

  • La biblioteca ya no insertará el filtro de visibilidad del paquete para MediaBrowserCompat. Especifica un elemento <queries> en el manifiesto de tus apps cuando orientes tu contenido al nivel de API 30 o superior. (I0a964, b/185314633)

Versión 1.4.2

15 de septiembre de 2021

Lanzamiento de androidx.media:media:1.4.2. La versión 1.4.2 contiene estas confirmaciones.

Correcciones de errores

  • Se corrigió un efecto secundario de getMediaDescription() en el nivel de API 21 (I5c05f).

Versión 1.4.1

4 de agosto de 2021

Lanzamiento de androidx.media:media:1.4.1. La versión 1.4.1 contiene estas confirmaciones.

Correcciones de errores

  • Se corrigió la marca de mutación tras crear PendingIntent para evitar fallas cuando se orienta a Android S.
  • Se corrigió ClassVerificationFailure para NotificationCompat.MediaStyle.

Versión 1.4.0

21 de julio de 2021

Lanzamiento de androidx.media:media:1.4.0. La versión 1.4.0 contiene estas confirmaciones.

Cambios importantes desde la versión 1.3.0

  • Se agregó una nueva clave de paquete METADATA_KEY_SERIES_CONTENT_ID, que se usa para el ID de contenido multimedia de las series de TV en MediaMetadataCompat.
  • Se agregó una nueva clave de paquete METADATA_KEY_NEXT_EPISODE_CONTENT_ID, que se usa para el ID de contenido del próximo episodio de TV en MediaMetadataCompat.
  • MediaControllerCompat.TransportControls#EXTRA_LEGACY_STREAM_TYPE dejó de estar disponible, y se agregó MediaConstants#TRANSPORT_CONTROLS_EXTRAS_KEY_LEGACY_STREAM_TYPE.
  • Se agregó una clave adicional para reproducir aleatoriamente el contenido multimedia de playFromUri.
  • Se agregó la anotación @Nullable a la clase Result.
  • Se corrigió el EXTRA_KEY_EVENT faltante del intent para MediaButtonReceiver.

Versión 1.4.0-rc01

30 de junio de 2021

Lanzamiento de androidx.media:media:1.4.0-rc01 sin cambios desde 1.4.0-beta01. La versión 1.4.0-rc01 contiene estas confirmaciones.

Versión 1.4.0-beta01

17 de junio de 2021

Lanzamiento de androidx.media:media:1.4.0-beta01. La versión 1.4.0-beta01 contiene estas confirmaciones.

Cambios en la API

  • Se agregó una nueva clave de paquete METADATA_KEY_SERIES_CONTENT_ID, que se usa para el ID de contenido multimedia de las series de TV en MediaMetadataCompat.

  • Se agregó una nueva clave de paquete METADATA_KEY_NEXT_EPISODE_CONTENT_ID, que se usa para el ID de contenido del próximo episodio de TV en MediaMetadataCompat.

Versión 1.4.0-alpha01

5 de mayo de 2021

Lanzamiento de androidx.media:media:1.4.0-alpha01. La versión 1.4.0-alpha01 contiene estas confirmaciones.

Cambios en la API

  • MediaControllerCompat.TransportControls#EXTRA_LEGACY_STREAM_TYPE dejó de estar disponible, y se agregó MediaConstants#TRANSPORT_CONTROLS_EXTRAS_KEY_LEGACY_STREAM_TYPE en su lugar (I62f17).
  • Se agregó una clave adicional para reproducir aleatoriamente el contenido multimedia de playFromUri (Ibc63c).
  • Se agregó la anotación @Nullable a la clase Result (I2d617).

Correcciones de errores

  • Se corrigió el EXTRA_KEY_EVENT faltante del intent para MediaButtonReceiver (If7557).

Versión 1.3.1

Versión 1.3.1

5 de mayo de 2021

Lanzamiento de androidx.media:media:1.3.1. La versión 1.3.1 contiene estas confirmaciones.

Correcciones de errores

  • Se corrigió el EXTRA_KEY_EVENT faltante del intent para MediaButtonReceiver (If7557).

Versión 1.3.0

Versión 1.3.0

7 de abril de 2021

Lanzamiento de androidx.media:media:1.3.0. La versión 1.3.0 contiene estas confirmaciones.

Cambios importantes desde la versión 1.2.0

  • Se migraron los extras de Android Auto a MediaConstants.

Versión 1.3.0-rc02

24 de marzo de 2021

Lanzamiento de androidx.media:media:1.3.0-rc02. La versión 1.3.0-rc02 contiene estas confirmaciones.

Correcciones de errores

  • Se configuró FLAG_IMMUTABLE en el PendingIntent de MediaButtonReceiver, que se requiere para las apps orientadas a Android 12.
  • Se corrigió una NullPointerException en MediaSessionCompat con la API 27 después de setCallback(null).

Versión 1.3.0-rc01

10 de marzo de 2021

Lanzamiento de androidx.media:media:1.3.0-rc01. La versión 1.3.0-rc01 contiene estas confirmaciones.

Sin cambios desde 1.3.0-beta01

Versión 1.3.0-beta01

10 de febrero de 2021

Lanzamiento de androidx.media:media:1.3.0-beta01. La versión 1.3.0-beta01 contiene estas confirmaciones.

Cambios en la API

  • Se agregó una nueva constante PlaybackStateCompat.ACTION_SET_PLAYBACK_SPEED (I9d076).
  • Se agregaron los extras de Android Auto a MediaConstants. (I290ab).
  • Agrega constantes para restringir los elementos secundarios raíz de MediaBrowserService (Ifcebd).

Correcciones de errores

  • Se agregó FLAG_RECEIVER_FOREGROUND para el intent pendiente del botón multimedia.

Versión 1.2.1

Media versión 1.2.1

2 de diciembre de 2020

Lanzamiento de androidx.media:media:1.2.1. La versión 1.2.1 contiene estas confirmaciones.

Correcciones de errores

  • Se corrigió NPE después de llamar a MediaSessionCompat#setCallback(null) en el nivel de API 27.

Versión 1.2.0

Versión 1.2.0

16 de septiembre de 2020

Lanzamiento de androidx.media:media:1.2.0. La versión 1.2.0 contiene estas confirmaciones.

Cambios importantes desde la versión 1.1.0

  • Se agregó compatibilidad con AudioAttributesCompat#setLegacyStreamType para el SDK < 21
  • Se agregó compatibilidad con el control de volumen para la biblioteca androidx.mediarouter.
  • Se agregó mejor compatibilidad con la interoperabilidad entre androidx.media y androidx.media2.

Versión 1.2.0-rc01

2 de septiembre de 2020

Lanzamiento de androidx.media:media:1.2.0-rc01 sin cambios desde 1.2.0-beta01. La versión 1.2.0-rc01 contiene estas confirmaciones.

Versión 1.2.0-beta01

19 de agosto de 2020

Lanzamiento de androidx.media:media:1.2.0-beta01. La versión 1.2.0-beta01 contiene estas confirmaciones.

Nuevas funciones

  • Se agregó compatibilidad con AudioAttributesCompat#setLegacyStreamType para las API de niveles anteriores al 21.

Cambios en la API

  • Se agregó MediaConstants#PLAYBACK_STATE_EXTRAS_KEY_MEDIA_ID para el ID de contenido multimedia en servicios adicionales PlaybackStateCompat, que se espera que sea igual a MediaMetadataCompat#METADATA_KEY_MEDIA_ID de los metadatos actuales.

Correcciones de errores

  • Se corrigió un problema con AudioAttributesCompat.Builder#setContentType.

Versión 1.2.0-alpha04

24 de junio de 2020

Lanzamiento de androidx.media:media:1.2.0-alpha04. La versión 1.2.0-alpha04 contiene estas confirmaciones.

Nuevas funciones

  • Se proporcionó una manera de admitir el control de volumen para la biblioteca de mediarouter.

Cambios en la API

  • Se agregó AudioManagerCompat#getStreamMaxVolume.
  • Se agregó AudioManagerCompat#getStreamMinVolume.

Correcciones de errores

  • Se solucionó un problema de interoperabilidad entre media y media2 en el SDK < 21.

Versión 1.2.0-alpha03

10 de junio de 2020

Lanzamiento de androidx.media:media:1.2.0-alpha03. La versión 1.2.0-alpha03 contiene estas confirmaciones.

Cambios en la API

  • Se quitó MediaConstants.SESSION_EXTRAS_KEY_AUTHTOKEN.

Correcciones de errores

  • Se solucionó un problema con equals() de RemoteUserInfo.

Versión 1.2.0-alpha02

15 de abril de 2020

Lanzamiento de androidx.media:media:1.2.0-alpha02. La Versión 1.2.0-alpha02 contiene estas confirmaciones.

Correcciones de errores

  • Evita las modificaciones de las clases VersionedParcelable.

Versión 1.2.0-alpha01

23 de octubre de 2019

Lanzamiento de androidx.media:media:1.2.0-alpha01. La versión 1.2.0-alpha01 contiene estas confirmaciones.

Cambios en la API

  • Se agregaron los siguientes métodos:
    • MediaSessionCompat.Callback.onSetPlaybackSpeed()
    • MediaControllerCompat.setPlaybackSpeed()
    • MediaControllerCompat.getSessionInfo()

Correcciones de errores

  • Se implementó la prevención contra un elemento BadParcelableException cuando se pasa un objeto Bundle a través de una llamada IPC.
  • El constructor de MediaControllerCompat ya no arroja un error RemoteException.
  • Se implementó una prevención contra la llamada de métodos de devolución de llamada después de MediaSessionCompat.release().

Versión 1.1.0

Versión 1.1.0

5 de septiembre de 2019

Lanzamiento de androidx.media:media:1.1.0. Para conocer las confirmaciones incluidas en esta versión, consulta este vínculo.

Cambios importados desde la versión 1.0.0

  • Se introdujo AudioAttributesCompat.

Versión 1.1.0-rc01

13 junio de 2019

Lanzamiento de androidx.media:media:1.1.0-rc01 sin cambios desde 1.1.0-beta02. Para conocer las confirmaciones incluidas en esta versión, consulta este vínculo.

Versión 1.1.0-beta02

5 de junio de 2019

Lanzamiento de androidx.media:media:1.1.0-beta02. Para conocer las confirmaciones incluidas en esta versión, consulta este vínculo.

Correcciones de errores

  • El alcance de restricción de los métodos ocultos que usa media2-session se relajó a LIBRARY_GROUP_PREFIX.

Versión 1.1.0-beta01

7 de mayo de 2019

Lanzamiento de androidx.media:media:1.1.0-beta01. Para conocer las confirmaciones incluidas en esta versión, consulta este vínculo.

Nuevas funciones

  • Se cambió IllegalPointerException por NullPointerException para los argumentos nulos que se marcaron como @NonNull.

Versión 1.1.0-alpha04

3 de abril de 2019

Lanzamiento de androidx.media:media:1.1.0-alpha04. Para conocer las confirmaciones incluidas en esta versión, consulta este vínculo.

Correcciones de errores

  • Se ajustó una constante de prueba de compatibilidad de versión (aosp/933656).

Versión 1.1.0-alpha03

21 de marzo de 2019

Lanzamiento de androidx.media:media:1.1.0-alpha03. Para obtener una lista completa de las confirmaciones incluidas en esta versión, consulta este artículo.

Correcciones de errores

  • Se solucionó la falla de MedaBrowserServiceCompat cuando varios MediaBrowserCompat intentaban conectarse a él (aosp/930246).

Versión 1.1.0-alpha02

13 de marzo de 2019

Lanzamiento de androidx.media:media:1.1.0-alpha02. Para obtener una lista completa de las confirmaciones incluidas en esta versión, consulta este artículo.

Correcciones de errores

  • Se corrigió el bloqueo de MediaBrowserCompat durante la conexión.
  • Se corrigió IllegalStateException en getCurrentBrowserInfo()/getBrowserRootHints().
  • Ahora MediaBrowserServiceCompat.getCurrentBrowserInfo() muestra la misma instancia de RemoteUserInfo para el mismo objeto MediaBrowserCompat en onGetRoot().

Versión 1.0.1

Versión 1.0.1

30 de enero de 2019

Lanzamiento de androidx.media:media 1.0.1.

Correcciones de errores

  • Se corrigió el error de una IllegalStateException inesperada cuando se usa MediaBrowserCompat.connect() (aosp/858075).

Versión 1.0.0

Versión 1.0.0-alpha06

17 de diciembre de 2018

Cambios en la API

Se cambiaron el nombre y la clase del paquete media.widget de la siguiente manera:

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

Versión 1.0.0-alpha01

3 de diciembre de 2018

Cambios en la API

  • Se dieron de baja dos marcas MediaSessionCompat:
    • FLAG_HANDLES_MEDIA_BUTTONS
    • FLAG_HANDLES_TRANSPORT_CONTROLS