媒体

声明依赖项

要添加对 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

2023 年 11 月 29 日

androidx.media:media:1.7.0 已发布。 版本 1.7.0 包含以下提交。

自 1.6.0 以来重要的更改

• 在 MediaButtonReceiver 中捕获 ForegroundServiceStartNotAllowedException 并将其转发到 onForegroundServiceStartNotAllowedException。 (I0c939)
• 添加 BROWSER_SERVICE_EXTRAS_KEY_FAVORITES_MEDIA_ITEM 用于在 MediaBrowserCompat 根附加信息中传递收藏的媒体项。 (Id3a11)
• 添加附加信息以在 MediaBrowserCompat 根附加信息和 MediaItem 说明中设置浏览自定义操作。 (Iab163)
• 修复由 MediaBrowserService.onLoadChildren 在旧版 Android 版本上返回 null 导致的 IllegalStateException。

版本 1.7.0-rc01

2023 年 11 月 15 日

androidx.media:media:1.7.0-rc01 已发布，没有更改。 版本 1.7.0-rc01 包含以下提交。

版本 1.7.0-beta01

2023 年 11 月 1 日

androidx.media:media:1.7.0-beta01 已发布。 版本 1.7.0-beta01 包含以下提交。

错误修复

• 修复 MediaBrowserService 和 MediaBrowserServiceCompat 的潜在内存泄漏。 b/37137738.
• 修复由 MediaBrowserService.onLoadChildren 在旧版 Android 版本上返回 null 导致的 IllegalStateException。

版本 1.7.0-alpha01

2023 年 2 月 8 日

androidx.media:media:1.7.0-alpha01 已发布。 版本 1.7.0-alpha01 包含以下提交。

新功能

• 在 MediaButtonReceiver 中捕获 ForegroundServiceStartNotAllowedException 并将其转发到 onForegroundServiceStartNotAllowedException。 (I0c939)
• 添加 BROWSER_SERVICE_EXTRAS_KEY_FAVORITES_MEDIA_ITEM 用于在 MediaBrowserCompat 根附加信息中传递收藏的媒体项。 (Id3a11)
• 添加附加信息以在 MediaBrowserCompat 根附加信息和 MediaItem 说明中设置浏览自定义操作。 (Iab163)

版本 1.6.0

版本 1.6.0

2022 年 4 月 20 日

androidx.media:media:1.6.0 已发布。 版本 1.6.0 包含以下提交。

自 1.5.0 版本以来的重要变更

• 添加在 Android Auto 的媒体应用程序中使用 CarAppLibrary 设置登录/设置页面所需的额外信息。

版本 1.6.0-rc01

2022 年 4 月 6 日

androidx.media:media:1.6.0-rc01 已发布。 版本 1.6.0-rc01 包含以下提交。

版本 1.6.0-beta01

2022 年 3 月 23 日

androidx.media:media:1.6.0-beta01 已发布。 版本 1.6.0-beta01 包含以下提交。

• 自上次 alpha 版本以来没有变化。

版本 1.6.0-alpha01

2022 年 2 月 23 日

androidx.media:media:1.6.0-alpha01 已发布。 版本 1.6.0-alpha01 包含以下提交。

API 变更

• 添加在 Android Auto 的媒体应用程序中使用 CarAppLibrary 设置登录/设置页面所需的额外信息。 (Ifb3ca)

版本 1.5

版本 1.5.0

2022 年 2 月 9 日

androidx.media:media:1.5.0 已发布。 版本 1.5.0 包含以下提交。

自 1.4.0 版本以来的重要变更

• 在 AudioManagerCompat 中添加 isVolumeFixed
• 添加用于单项样式和完成百分比的 MediaConstants。
• 对于 API 级别 30 或更高版本，该库将不再为 MediaBrowserCompat 注入包可见性过滤器。 您需要在应用程序清单中指定 <queries> 元素。
• 修复 API 21 上 getMediaDescription() 的额外信息的意外更改
• 防止 API 19 上出现一些 IllegalStateException。
• 修复针对 Android 12 时 MediaSessionCompat 中的崩溃
• 修复 KitKat 上 NotificationCompat 中的崩溃

版本 1.5.0-rc01

2022 年 1 月 26 日

androidx.media:media:1.5.0-rc01 已发布，自 1.5.0-beta01 以来没有变化。 版本 1.5.0-rc01 包含以下提交。

版本 1.5.0-beta01

2021 年 12 月 1 日

androidx.media:media:1.5.0-beta01 已发布，自 1.5.0-alpha01 以来没有变化。 版本 1.5.0-beta01 包含以下提交。

版本 1.5.0-alpha01

2021 年 11 月 3 日

androidx.media:media:1.5.0-alpha01 已发布。 版本 1.5.0-alpha01 包含以下提交。

新功能

• 将媒体的依赖项更新为 1.6.0 版本的 core。

API 变更

• 在 AudioManagerCompat 中添加 isVolumeFixed。
• 添加用于单项样式和完成百分比的 MediaConstants。

错误修复

• 对于 API 级别 30 或更高版本，该库将不再为 MediaBrowserCompat 注入包可见性过滤器。 您需要在应用程序清单中指定 <queries> 元素。
• 修复 API 21 上 getMediaDescription() 的额外信息的意外更改
• 修复通过设置默认大小来提高 ArrayList 的使用效率。
• 防止 API 19 上出现一些 IllegalStateException。
• 修复针对 Android 12 时 MediaSessionCompat 中的崩溃
• 修复 KitKat 上 NotificationCompat 中的崩溃

版本 1.4

版本 1.4.3

2021 年 10 月 13 日

androidx.media:media:1.4.3 已发布。 版本 1.4.3 包含以下提交。

错误修复

• 该库将不再为 MediaBrowserCompat 注入包可见性过滤器。 针对 API 级别 30 或更高版本时，请在应用程序清单中指定 <queries> 元素。 (I0a964, b/185314633)

版本 1.4.2

2021 年 9 月 15 日

androidx.media:media:1.4.2 已发布。 版本 1.4.2 包含以下提交。

错误修复

• 修复 API 21 上 getMediaDescription() 的副作用 (I5c05f)

版本 1.4.1

2021 年 8 月 4 日

androidx.media:media:1.4.1 已发布。 版本 1.4.1 包含以下提交。

错误修复

• 修复用于创建 PendingIntent 的可变性标志，以防止针对 Android S 时崩溃。
• 修复 NotificationCompat.MediaStyle 的 ClassVerificationFailure。

版本 1.4.0

2021 年 7 月 21 日

androidx.media:media:1.4.0 已发布。 版本 1.4.0 包含以下提交。

自 1.3.0 版本以来的重要变更

• 添加了一个新的捆绑键 METADATA_KEY_SERIES_CONTENT_ID，用于 MediaMetadataCompat 中的电视连续剧的媒体内容 ID
• 添加了一个新的捆绑键 METADATA_KEY_NEXT_EPISODE_CONTENT_ID，用于 MediaMetadataCompat 中的电视节目的下一集内容 ID
• 弃用 MediaControllerCompat.TransportControls#EXTRA_LEGACY_STREAM_TYPE，并添加 MediaConstants#TRANSPORT_CONTROLS_EXTRAS_KEY_LEGACY_STREAM_TYPE 代替
• 为 playFromUri 添加一个额外的键来对媒体进行随机播放
• 在 Result 类中添加 @Nullable 注解
• 修复 MediaButtonReceiver 的意图中缺少 EXTRA_KEY_EVENT

版本 1.4.0-rc01

2021 年 6 月 30 日

androidx.media:media:1.4.0-rc01 已发布，自 1.4.0-beta01 以来没有变化。 版本 1.4.0-rc01 包含以下提交。

版本 1.4.0-beta01

2021 年 6 月 17 日

androidx.media:media:1.4.0-beta01 已发布。 版本 1.4.0-beta01 包含以下提交。

API 变更

• 添加了一个新的捆绑键 METADATA_KEY_SERIES_CONTENT_ID，用于 MediaMetadataCompat 中的电视连续剧的媒体内容 ID

• 添加了一个新的捆绑键 METADATA_KEY_NEXT_EPISODE_CONTENT_ID，用于 MediaMetadataCompat 中的电视节目的下一集内容 ID

版本 1.4.0-alpha01

2021 年 5 月 5 日

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)
• 在 Result 类中添加 @Nullable 注解 (I2d617)

错误修复

• 修复 MediaButtonReceiver 的意图中缺少 EXTRA_KEY_EVENT (If7557)

版本 1.3.1

版本 1.3.1

2021 年 5 月 5 日

androidx.media:media:1.3.1 已发布。 版本 1.3.1 包含以下提交。

错误修复

• 修复 MediaButtonReceiver 的意图中缺少 EXTRA_KEY_EVENT (If7557)

版本 1.3.0

版本 1.3.0

2021 年 4 月 7 日

androidx.media:media:1.3.0 已发布。 版本 1.3.0 包含以下提交。

自 1.2.0 版本以来的重大变更

• 将 Android Auto 额外信息迁移到 MediaConstants 中。

版本 1.3.0-rc02

2021 年 3 月 24 日

androidx.media:media:1.3.0-rc02 已发布。 版本 1.3.0-rc02 包含以下提交。

错误修复

• 将 FLAG_IMMUTABLE 设置为 MediaButtonReceiver 的 PendingIntent，这是针对 Android 12 的应用程序所需的。
• 修复了在 API 27 中调用 setCallback(null) 之后 MediaSessionCompat 中的 NullPointerException。

版本 1.3.0-rc01

2021 年 3 月 10 日

androidx.media:media:1.3.0-rc01 已发布。 版本 1.3.0-rc01 包含以下提交。

自 1.3.0-beta01 以来没有变化。

版本 1.3.0-beta01

2021 年 2 月 10 日

androidx.media:media:1.3.0-beta01 已发布。 版本 1.3.0-beta01 包含以下提交。

API 变更

• 添加了一个新的常量 PlaybackStateCompat.ACTION_SET_PLAYBACK_SPEED (I9d076)
• 将 Android Auto 额外信息迁移到 MediaConstants 中。 (I290ab)
• 添加用于约束 MediaBrowserService 的根级子节点的常量。 (Ifcebd)

错误修复

• 为媒体按钮的 PendingIntent 添加 FLAG_RECEIVER_FOREGROUND。

版本 1.2.1

媒体版本 1.2.1

2020 年 12 月 2 日

androidx.media:media:1.2.1 已发布。 版本 1.2.1 包含以下提交。

错误修复

• 修复在 API 27 中调用 MediaSessionCompat#setCallback(null) 之后的 NPE

版本 1.2.0

版本 1.2.0

2020 年 9 月 16 日

androidx.media:media:1.2.0 已发布。 版本 1.2.0 包含以下提交。

自 1.1.0 版本以来的重大变更

• 为 SDK < 21 添加了对 AudioAttributesCompat#setLegacyStreamType 的支持
• 支持 androidx.mediarouter 库的音量控制
• 更好地支持 androidx.media 和 androidx.media2 之间的互操作性

版本 1.2.0-rc01

2020 年 9 月 2 日

androidx.media:media:1.2.0-rc01 已发布，自 1.2.0-beta01 以来没有变化。 版本 1.2.0-rc01 包含以下提交。

版本 1.2.0-beta01

2020 年 8 月 19 日

androidx.media:media:1.2.0-beta01 已发布。 版本 1.2.0-beta01 包含以下提交。

新功能

• 为 API 级别低于 21 的版本添加了对 AudioAttributesCompat#setLegacyStreamType 的支持

API 变更

• 在 PlaybackStateCompat 附加信息中添加了 MediaConstants#PLAYBACK_STATE_EXTRAS_KEY_MEDIA_ID 用于媒体 ID，该 ID 预计与当前元数据的 MediaMetadataCompat#METADATA_KEY_MEDIA_ID 相同。

错误修复

• 修复了 AudioAttributesCompat.Builder#setContentType 的一个问题

版本 1.2.0-alpha04

2020 年 6 月 24 日

androidx.media:media:1.2.0-alpha04 已发布。 版本 1.2.0-alpha04 包含这些提交。

新功能

• 提供了一种支持 mediarouter 库的音量控制的方法

API 变更

• 添加了 AudioManagerCompat#getStreamMaxVolume
• 添加了 AudioManagerCompat#getStreamMinVolume

错误修复

• 修复了 SDK < 21 上媒体和媒体 2 之间的互操作性问题

版本 1.2.0-alpha03

2020 年 6 月 10 日

androidx.media:media:1.2.0-alpha03 已发布。 版本 1.2.0-alpha03 包含这些提交。

API 变更

• MediaConstants.SESSION_EXTRAS_KEY_AUTHTOKEN 已被删除

错误修复

• 修复了 RemoteUserInfo 的 equals() 的一个问题

版本 1.2.0-alpha02

2020 年 4 月 15 日

androidx.media:media:1.2.0-alpha02 已发布。 版本 1.2.0-alpha02 包含这些提交。

错误修复

• 防止修改 VersionedParcelable 类

版本 1.2.0-alpha01

2019 年 10 月 23 日

androidx.media:media:1.2.0-alpha01 已发布。 版本 1.2.0-alpha01 包含这些提交.

API 更改

• 添加了以下方法
  • MediaSessionCompat.Callback.onSetPlaybackSpeed()
  • MediaControllerCompat.setPlaybackSpeed()
  • MediaControllerCompat.getSessionInfo()

错误修复

• 在通过 IPC 调用传递 Bundle 对象时，实现了防止 BadParcelableException 的机制
• MediaControllerCompat 的构造函数不再抛出 RemoteException
• 实现了防止在 MediaSessionCompat.release() 之后调用回调方法的机制

版本 1.1.0

版本 1.1.0

2019 年 9 月 5 日

androidx.media:media:1.1.0 已发布。此版本中包含的提交可以在这里找到 这里.

自 1.0.0 以来导入的更改

• 引入了 AudioAttributesCompat

版本 1.1.0-rc01

2019 年 6 月 13 日

androidx.media:media:1.1.0-rc01 已发布，与 1.1.0-beta02 相比没有更改。此版本中包含的提交可以在这里找到 这里.

版本 1.1.0-beta02

2019 年 6 月 5 日

androidx.media:media:1.1.0-beta02 已发布。此版本中包含的提交可以在这里找到 这里.

错误修复

• 由 media2-session 使用的隐藏方法的限制范围已放宽至 LIBRARY_GROUP_PREFIX。

版本 1.1.0-beta01

2019 年 5 月 7 日

androidx.media:media:1.1.0-beta01 已发布。此版本中包含的提交可以在这里找到 这里.

新功能

• 将 IllegalPointerException 更改为 NullPointerException，用于标记为 @NonNull 的空参数。

版本 1.1.0-alpha04

2019 年 4 月 3 日

androidx.media:media:1.1.0-alpha04 已发布。此版本中包含的提交可以在这里找到 这里.

错误修复

• 调整版本兼容性测试常量 (aosp/933656)

版本 1.1.0-alpha03

2019 年 3 月 21 日

androidx.media:media:1.1.0-alpha03 已发布。此版本中包含的完整提交列表可以在这里找到 这里.

错误修复

• 修复了当多个 MediaBrowserCompat 尝试连接到它时，MedaBrowserServiceCompat 崩溃的问题。 (aosp/930246)

版本 1.1.0-alpha02

2019 年 3 月 13 日

androidx.media:media:1.1.0-alpha02 已发布。此版本中包含的完整提交列表可以在这里找到 这里.

错误修复

• 修复了连接时 MediaBrowserCompat 崩溃的问题
• 修复了 getCurrentBrowserInfo()/getBrowserRootHints() 中发生的 IllegalStateException
• 使 MediaBrowserServiceCompat.getCurrentBrowserInfo() 在 onGetRoot() 中为相同的 MediaBrowserCompat 返回相同的 RemoteUserInfo 实例

版本 1.0.1

版本 1.0.1

2019 年 1 月 30 日

androidx.media:media 1.0.1 已发布。

错误修复

• 修复了在使用 MediaBrowserCompat.connect() 时发生的意外 IllegalStateException 的错误 (aosp/858075)

版本 1.0.0

版本 1.0.0-alpha06

2018 年 12 月 17 日

API 更改

将 media.widget 包和类名重命名如下

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

版本 1.0.0-alpha01

2018 年 12 月 3 日

API 更改

• 弃用了两个 MediaSessionCompat 标志
  • FLAG_HANDLES_MEDIA_BUTTONS
  • FLAG_HANDLES_TRANSPORT_CONTROLS