СМИ

СМИ

Пример кода руководства пользователя

Справочник API
androidx.media
androidx.media.app
androidx.media.session

Обмен медиаконтентом и элементами управления с другими приложениями. Заменено на 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 г.

Примечание: Для использования этих новых функций обновитесь до версии 1.1.0-alpha03 . Версия 1.1.0-alpha03 содержит исправление критической ошибки MedaBrowserServiceCompat ; aosp/930246 .

Выпущена версия 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