СМИ

СМИ

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

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

Делитесь мультимедийным содержимым и элементами управления с другими приложениями. Заменено media3.

Последнее обновление	Стабильный выпуск	Кандидат на выпуск	Бета-версия	Альфа-релиз
29 ноября 2023 г.	1.7.0	-	-	-

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

Чтобы добавить зависимость от Media, вы должны добавить в свой проект репозиторий Google Maven. Для получения дополнительной информации прочтите репозиторий Google Maven .

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

классный

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

Котлин

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

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

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

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

Создать новую задачу

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

Версия 1.7

Версия 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-бета01

1 ноября 2023 г.

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

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

• Исправлена ​​потенциальная утечка памяти MediaBrowserService и MediaBrowserServiceCompat . б/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-бета01

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. ( Еслиb3ca )

Версия 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-бета01

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 . Укажите элемент <queries> в манифесте вашего приложения при настройке уровня API 30 или выше. ( I0a964 , б/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-бета01

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-бета01

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. ( Еслибд )

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

• Добавьте 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-бета01

19 августа 2020 г.

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

Новые возможности

• Добавлена ​​поддержка AudioAttributesCompat#setLegacyStreamType для уровней API до 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 содержит эти коммиты.

Новые возможности

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

Изменения 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-бета01

7 мая 2019 г.

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

Новые возможности

• IllegalPointerException изменен на NullPointerException для нулевых аргументов, помеченных как @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 пытались подключиться к нему. ( аосп/930246 )

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

13 марта 2019 г.

Примечание. Если вы хотите использовать эти новые функции, обновитесь до версии 1.1.0-alpha03 . Версия 1.1.0-alpha03 содержит критическое исправление MedaBrowserServiceCompat ; аосп/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