СМИ

Обмен медиаконтентом и элементами управления с другими приложениями. Заменено на media3.
Последнее обновление Стабильный релиз Кандидат на релиз Бета-версия Альфа-релиз
13 августа 2025 г. 1.7.1 - - -

Объявление зависимостей

Чтобы добавить зависимость от Media, необходимо добавить репозиторий Google Maven в свой проект. Подробнее см. в репозитории Google Maven .

Добавьте зависимости для необходимых артефактов в файл build.gradle вашего приложения или модуля:

классный 

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

Котлин 

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

Дополнительные сведения о зависимостях см. в разделе Добавление зависимостей сборки .

Обратная связь

Ваши отзывы помогают улучшить Jetpack. Сообщите нам, если вы обнаружите новые проблемы или у вас есть идеи по улучшению этой библиотеки. Пожалуйста, ознакомьтесь с уже существующими проблемами в этой библиотеке, прежде чем создавать новую. Вы можете проголосовать за существующую проблему, нажав на кнопку со звёздочкой.

Создать новый выпуск

Более подробную информацию см. в документации по системе отслеживания проблем .

Версия 1.7

Версия 1.7.1

13 августа 2025 г.

Выпущен androidx.media:media:1.7.1 . Версия 1.7.1 содержит следующие коммиты .

Исправления ошибок

  • Повысить производительность MediaSession.setMetadata() за счет сокращения количества промежуточных выделений и устранения ненужной парцелляции/распарцелляции растровых изображений.

Версия 1.7.0

29 ноября 2023 г.

Выпущен androidx.media:media:1.7.0 . Версия 1.7.0 содержит следующие коммиты.

Важные изменения с версии 1.6.0

  • Перехватите исключение ForegroundServiceStartNotAllowedException в MediaButtonReceiver и перешлите его в onForegroundServiceStartNotAllowedException . ( I0c939 )
  • Добавьте BROWSER_SERVICE_EXTRAS_KEY_FAVORITES_MEDIA_ITEM для передачи избранного медиа-элемента в корневые дополнения MediaBrowserCompat . ( Id3a11 )
  • Добавьте дополнения для настройки пользовательских действий обзора в корневые дополнения MediaBrowserCompat и описания MediaItem . ( Iab163 )
  • Исправлена ошибка IllegalStateException , вызванная возвратом null из MediaBrowserService.onLoadChildren в старых версиях Android.

Версия 1.7.0-rc01

15 ноября 2023 г.

androidx.media:media:1.7.0-rc01 выпущен без изменений. Версия 1.7.0-rc01 содержит эти коммиты.

Версия 1.7.0-beta01

1 ноября 2023 г.

Выпущен androidx.media:media:1.7.0-beta01 . Версия 1.7.0-beta01 содержит следующие изменения.

Исправления ошибок

  • Исправлена потенциальная утечка памяти MediaBrowserService и MediaBrowserServiceCompat . b/37137738 .
  • Исправлена ошибка IllegalStateException , вызванная возвратом null из MediaBrowserService.onLoadChildren в старых версиях Android.

Версия 1.7.0-альфа01

8 февраля 2023 г.

Выпущен androidx.media:media:1.7.0-alpha01 . Версия 1.7.0-alpha01 содержит следующие коммиты.

Новые функции

  • Перехватите исключение ForegroundServiceStartNotAllowedException в MediaButtonReceiver и перешлите его в onForegroundServiceStartNotAllowedException . ( I0c939 )
  • Добавьте BROWSER_SERVICE_EXTRAS_KEY_FAVORITES_MEDIA_ITEM для передачи избранного медиа-элемента в корневые дополнения MediaBrowserCompat . ( Id3a11 )
  • Добавьте дополнения для настройки пользовательских действий обзора в корневые дополнения MediaBrowserCompat и описания MediaItem . ( Iab163 )

Версия 1.6.0

Версия 1.6.0

20 апреля 2022 г.

Выпущен androidx.media:media:1.6.0 . Версия 1.6.0 содержит следующие коммиты.

Важные изменения с версии 1.5.0

  • Добавьте необходимые дополнения для настройки страницы входа/настроек с помощью CarAppLibrary в медиа-приложении для Android Auto.

Версия 1.6.0-rc01

6 апреля 2022 г.

Выпущен androidx.media:media:1.6.0-rc01 . Версия 1.6.0-rc01 содержит следующие коммиты.

Версия 1.6.0-beta01

23 марта 2022 г.

Выпущен androidx.media:media:1.6.0-beta01 . Версия 1.6.0-beta01 содержит следующие изменения.

  • Никаких изменений с момента последнего альфа-релиза.

Версия 1.6.0-альфа01

23 февраля 2022 г.

Выпущен androidx.media:media:1.6.0-alpha01 . Версия 1.6.0-alpha01 содержит следующие коммиты.

Изменения API

  • Добавьте необходимые дополнения для настройки страницы входа/настроек с помощью CarAppLibrary в медиа-приложении для Android Auto. ( Ifb3ca )

Версия 1.5

Версия 1.5.0

9 февраля 2022 г.

Выпущен androidx.media:media:1.5.0 . Версия 1.5.0 содержит следующие коммиты.

Важные изменения с версии 1.4.0

  • Добавить isVolumeFixed в AudioManagerCompat
  • Добавьте MediaConstants для стилизации отдельных элементов и процента завершения.
  • Для API уровня 30 и выше библиотека не будет внедрять фильтр видимости пакетов для MediaBrowserCompat . Вам необходимо указать элемент <queries> в манифесте вашего приложения.
  • Исправлено неожиданное изменение дополнительных данных getMediaDescription() в API 21.
  • Предотвращение некоторых IllegalStateException в API 19.
  • Исправлен сбой в MediaSessionCompat при использовании Android 12.
  • Исправлен сбой в NotificationCompat на KitKat

Версия 1.5.0-rc01

26 января 2022 г.

androidx.media:media:1.5.0-rc01 выпущен без изменений по сравнению с 1.5.0-beta01 . Версия 1.5.0-rc01 содержит следующие изменения.

Версия 1.5.0-beta01

1 декабря 2021 г.

androidx.media:media:1.5.0-beta01 выпущен без изменений по сравнению с 1.5.0-alpha01 . Версия 1.5.0-beta01 содержит следующие изменения.

Версия 1.5.0-альфа01

3 ноября 2021 г.

Выпущен androidx.media:media:1.5.0-alpha01 . Версия 1.5.0-alpha01 содержит следующие коммиты.

Новые функции

  • Обновить зависимость от ядра для медиа до версии 1.6.0

Изменения API

  • Добавить isVolumeFixed в AudioManagerCompat
  • Добавьте MediaConstants для стилизации отдельных элементов и процента завершения.

Исправления ошибок

  • Для API уровня 30 и выше библиотека не будет внедрять фильтр видимости пакетов для MediaBrowserCompat . Вам необходимо указать элемент <queries> в манифесте вашего приложения.
  • Исправлено неожиданное изменение дополнительных данных getMediaDescription() в API 21.
  • Исправление неэффективного использования ArrayList путем установки размера по умолчанию.
  • Предотвращение некоторых исключений IllegalStateException в API 19.
  • Исправлен сбой в MediaSessionCompat при использовании Android 12.
  • Исправлен сбой в NotificationCompat на KitKat

Версия 1.4

Версия 1.4.3

13 октября 2021 г.

Выпущен androidx.media:media:1.4.3 . Версия 1.4.3 содержит следующие коммиты.

Исправления ошибок

  • Библиотека больше не будет внедрять фильтр видимости пакетов для MediaBrowserCompat . Если вы используете API уровня 30 или выше, укажите элемент <queries> в манифесте приложения. ( I0a964 , b/185314633 )

Версия 1.4.2

15 сентября 2021 г.

Выпущен androidx.media:media:1.4.2 . Версия 1.4.2 содержит следующие коммиты.

Исправления ошибок

  • Исправлен побочный эффект getMediaDescription() в API 21 ( I5c05f )

Версия 1.4.1

4 августа 2021 г.

Выпущен androidx.media:media:1.4.1 . Версия 1.4.1 содержит следующие коммиты.

Исправления ошибок

  • Исправлен флаг изменчивости для создания PendingIntent , чтобы предотвратить сбой при использовании Android S.
  • Исправлена ошибка ClassVerificationFailure для NotificationCompat.MediaStyle .

Версия 1.4.0

21 июля 2021 г.

Выпущен androidx.media:media:1.4.0 . Версия 1.4.0 содержит следующие коммиты.

Важные изменения с версии 1.3.0

  • Добавлен новый ключ пакета METADATA_KEY_SERIES_CONTENT_ID , используемый для идентификатора медиаконтента телесериала в MediaMetadataCompat.
  • Добавлен новый ключ пакета METADATA_KEY_NEXT_EPISODE_CONTENT_ID , используемый для идентификатора контента следующего эпизода телесериала в MediaMetadataCompat.
  • Отменить поддержку MediaControllerCompat.TransportControls#EXTRA_LEGACY_STREAM_TYPE и вместо этого добавить MediaConstants#TRANSPORT_CONTROLS_EXTRAS_KEY_LEGACY_STREAM_TYPE
  • Добавьте дополнительный ключ для перетасовки мультимедиа для playFromUri.
  • Добавить аннотацию @Nullable к классу Result
  • Исправлено отсутствие EXTRA_KEY_EVENT в намерении для MediaButtonReceiver.

Версия 1.4.0-rc01

30 июня 2021 г.

androidx.media:media:1.4.0-rc01 выпущен без изменений по сравнению с 1.4.0-beta01 . Версия 1.4.0-rc01 содержит следующие изменения.

Версия 1.4.0-beta01

17 июня 2021 г.

Выпущен androidx.media:media:1.4.0-beta01 . Версия 1.4.0-beta01 содержит следующие изменения.

Изменения API

  • Добавлен новый ключ пакета METADATA_KEY_SERIES_CONTENT_ID , используемый для идентификатора медиаконтента телесериала в MediaMetadataCompat

  • Добавлен новый ключ пакета METADATA_KEY_NEXT_EPISODE_CONTENT_ID , используемый для идентификатора контента следующего эпизода телесериала в MediaMetadataCompat

Версия 1.4.0-альфа01

5 мая 2021 г.

Выпущен androidx.media:media:1.4.0-alpha01 . Версия 1.4.0-alpha01 содержит следующие коммиты.

Изменения API

  • Отменить поддержку MediaControllerCompat.TransportControls#EXTRA_LEGACY_STREAM_TYPE и вместо этого добавить MediaConstants#TRANSPORT_CONTROLS_EXTRAS_KEY_LEGACY_STREAM_TYPE ( I62f17 )
  • Добавьте дополнительный ключ для перетасовки мультимедиа для playFromUri ( Ibc63c ).
  • Добавить аннотацию @Nullable к классу Result ( I2d617 )

Исправления ошибок

  • Исправлено отсутствие EXTRA_KEY_EVENT в намерении для MediaButtonReceiver ( If7557 ).

Версия 1.3.1

Версия 1.3.1

5 мая 2021 г.

Выпущен androidx.media:media:1.3.1 . Версия 1.3.1 содержит следующие коммиты.

Исправления ошибок

  • Исправлено отсутствие EXTRA_KEY_EVENT в намерении для MediaButtonReceiver ( If7557 ).

Версия 1.3.0

Версия 1.3.0

7 апреля 2021 г.

Выпущен androidx.media:media:1.3.0 . Версия 1.3.0 содержит следующие коммиты.

Основные изменения по сравнению с версией 1.2.0

  • Дополнительные возможности Android Auto перенесены в MediaConstants.

Версия 1.3.0-rc02

24 марта 2021 г.

Выпущен androidx.media:media:1.3.0-rc02 . Версия 1.3.0-rc02 содержит следующие коммиты.

Исправления ошибок

  • Установите FLAG_IMMUTABLE в значение PendingIntent объекта MediaButtonReceiver, что требуется для приложений, ориентированных на Android 12.
  • Исправлено исключение NullPointerException в MediaSessionCompat с API 27 после setCallback(null) .

Версия 1.3.0-rc01

10 марта 2021 г.

Выпущен androidx.media:media:1.3.0-rc01 . Версия 1.3.0-rc01 содержит следующие коммиты.

Никаких изменений с 1.3.0-beta01 .

Версия 1.3.0-beta01

10 февраля 2021 г.

Выпущен androidx.media:media:1.3.0-beta01 . Версия 1.3.0-beta01 содержит следующие изменения.

Изменения API

  • Добавлена новая константа PlaybackStateCompat.ACTION_SET_PLAYBACK_SPEED ( I9d076 )
  • Перенос дополнений Android Auto в MediaConstants. ( I290ab )
  • Добавить константы для ограничения корневых дочерних элементов MediaBrowserService. ( Ifcebd )

Исправления ошибок

  • Добавьте FLAG_RECEIVER_FOREGROUND для кнопки мультимедиа, ожидающей намерения.

Версия 1.2.1

Медиа-версия 1.2.1

2 декабря 2020 г.

Выпущен androidx.media:media:1.2.1 . Версия 1.2.1 содержит следующие коммиты.

Исправления ошибок

  • Исправление NPE после вызова MediaSessionCompat#setCallback(null) в API 27

Версия 1.2.0

Версия 1.2.0

16 сентября 2020 г.

Выпущен androidx.media:media:1.2.0 . Версия 1.2.0 содержит следующие коммиты.

Основные изменения с версии 1.1.0

  • Добавлена поддержка AudioAttributesCompat#setLegacyStreamType для SDK < 21.
  • Поддержка управления громкостью для библиотеки androidx.mediarouter
  • Лучшая поддержка взаимодействия между androidx.media и androidx.media2

Версия 1.2.0-rc01

2 сентября 2020 г.

androidx.media:media:1.2.0-rc01 выпущен без изменений по сравнению с 1.2.0-beta01 . Версия 1.2.0-rc01 содержит следующие изменения.

Версия 1.2.0-beta01

19 августа 2020 г.

Выпущен androidx.media:media:1.2.0-beta01 . Версия 1.2.0-beta01 содержит следующие изменения.

Новые функции

  • Добавлена поддержка AudioAttributesCompat#setLegacyStreamType для API Levels до 21.

Изменения API

  • Добавлен MediaConstants#PLAYBACK_STATE_EXTRAS_KEY_MEDIA_ID для идентификатора носителя в дополнительных параметрах PlaybackStateCompat , который, как ожидается, будет таким же, как MediaMetadataCompat#METADATA_KEY_MEDIA_ID текущих метаданных.

Исправления ошибок

  • Исправлена проблема с AudioAttributesCompat.Builder#setContentType

Версия 1.2.0-альфа04

24 июня 2020 г.

Выпущен androidx.media:media:1.2.0-alpha04 . Версия 1.2.0-alpha04 содержит следующие коммиты.

Новые функции

  • Предоставлен способ поддержки управления громкостью для библиотеки mediarouter.

Изменения API

  • Добавлен AudioManagerCompat#getStreamMaxVolume
  • Добавлен AudioManagerCompat#getStreamMinVolume

Исправления ошибок

  • Исправлена проблема взаимодействия между media и media2 в SDK < 21.

Версия 1.2.0-альфа03

10 июня 2020 г.

Выпущена версия androidx.media:media:1.2.0-alpha03 . Версия 1.2.0-alpha03 содержит следующие коммиты.

Изменения API

  • MediaConstants.SESSION_EXTRAS_KEY_AUTHTOKEN был удален

Исправления ошибок

  • Исправлена проблема с equals() для RemoteUserInfo

Версия 1.2.0-альфа02

15 апреля 2020 г.

Выпущен androidx.media:media:1.2.0-alpha02 . Версия 1.2.0-alpha02 содержит следующие коммиты.

Исправления ошибок

  • Предотвратить изменение классов VersionedParcelable

Версия 1.2.0-альфа01

23 октября 2019 г.

Выпущен androidx.media:media:1.2.0-alpha01 . Версия 1.2.0-alpha01 содержит следующие коммиты .

Изменения API

  • Добавлены следующие методы:
    • MediaSessionCompat.Callback.onSetPlaybackSpeed()
    • MediaControllerCompat.setPlaybackSpeed()
    • MediaControllerCompat.getSessionInfo()

Исправления ошибок

  • Реализовано предотвращение возникновения исключения BadParcelableException при передаче объекта Bundle через вызов IPC.
  • Конструктор MediaControllerCompat больше не выдает исключение RemoteException
  • Реализовано предотвращение вызова методов обратного вызова после MediaSessionCompat.release()

Версия 1.1.0

Версия 1.1.0

5 сентября 2019 г.

Выпущена версия androidx.media:media:1.1.0 . Изменения, включённые в эту версию, можно найти здесь .

Импорт изменений с версии 1.0.0

  • Введены AudioAttributesCompat

Версия 1.1.0-rc01

13 июня 2019 г.

androidx.media:media:1.1.0-rc01 выпущен без изменений по сравнению с 1.1.0-beta02 . Изменения, включённые в эту версию, можно найти здесь .

Версия 1.1.0-beta02

5 июня 2019 г.

Выпущена версия androidx.media:media:1.1.0-beta02 . Изменения, включённые в эту версию, можно найти здесь .

Исправления ошибок

  • Область ограничений скрытых методов, используемых media2-session была смягчена до LIBRARY_GROUP_PREFIX .

Версия 1.1.0-beta01

7 мая 2019 г.

Выпущена версия androidx.media:media:1.1.0-beta01 . Изменения, включённые в эту версию, можно найти здесь .

Новые функции

  • Изменено IllegalPointerException на NullPointerException для аргументов null, помеченных как @NonNull .

Версия 1.1.0-альфа04

3 апреля 2019 г.

Выпущена версия androidx.media:media:1.1.0-alpha04 . Изменения, включённые в эту версию, можно найти здесь .

Исправления ошибок

  • Исправление константы проверки совместимости версий ( aosp/933656 )

Версия 1.1.0-альфа03

21 марта 2019 г.

Выпущена версия androidx.media:media:1.1.0-alpha03 . Полный список изменений, включённых в эту версию, можно найти здесь .

Исправления ошибок

  • Исправлен сбой MedaBrowserServiceCompat при попытке подключения к нему нескольких MediaBrowserCompat . ( aosp/930246 )

Версия 1.1.0-альфа02

13 марта 2019 г.

Выпущена версия androidx.media:media:1.1.0-alpha02 . Полный список изменений, включённых в эту версию, можно найти здесь .

Исправления ошибок

  • Исправлен сбой MediaBrowserCompat при подключении.
  • Исправлена IllegalStateException , возникавшая в getCurrentBrowserInfo() / getBrowserRootHints()
  • Заставьте MediaBrowserServiceCompat.getCurrentBrowserInfo() возвращать тот же экземпляр RemoteUserInfo для того же MediaBrowserCompat в onGetRoot()

Версия 1.0.1

Версия 1.0.1

30 января 2019 г.

Выпущен androidx.media:media 1.0.1 .

Исправления ошибок

  • Исправлена ошибка неожиданного исключения IllegalStateException при использовании MediaBrowserCompat.connect() ( aosp/858075 ).

Версия 1.0.0

Версия 1.0.0-альфа06

17 декабря 2018 г.

Изменения API

Переименовал пакет media.widget и имена классов следующим образом:

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

Версия 1.0.0-альфа01

3 декабря 2018 г.

Изменения API

  • Устаревшие два флага MediaSessionCompat :
    • FLAG_HANDLES_MEDIA_BUTTONS
    • FLAG_HANDLES_TRANSPORT_CONTROLS