媒体

与其他应用共享媒体内容和控件。已被 media2 取代。
最新更新 稳定版 候选版本 Beta 版 Alpha 版
2023 年 11 月 29 日 1.7.0 - - -

声明依赖项

要添加对 Media 的依赖项，您必须将 Google Maven 存储库添加到您的项目中。阅读Google 的 Maven 存储库以了解更多信息。

在应用或模块的build.gradle文件中添加所需构件的依赖项

Groovy

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

Kotlin

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）
  • 修复在旧版 Android 版本上从 MediaBrowserService.onLoadChildren 返回 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。
  • 修复在旧版 Android 版本上从 MediaBrowserService.onLoadChildren 返回 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 以来重要更改

  • 将 isVolumeFixed 添加到 AudioManagerCompat
  • 添加 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

API 更改

  • 将 isVolumeFixed 添加到 AudioManagerCompat
  • 添加 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 以来重要更改

  • 添加了一个新的 bundle 键 METADATA_KEY_SERIES_CONTENT_ID，用于 MediaMetadataCompat 中电视剧的媒体内容 ID
  • 添加了一个新的 bundle 键 METADATA_KEY_NEXT_EPISODE_CONTENT_ID，用于 MediaMetadataCompat 中电视剧下一集的媒体内容 ID
  • 弃用 MediaControllerCompat.TransportControls#EXTRA_LEGACY_STREAM_TYPE 并改用 MediaConstants#TRANSPORT_CONTROLS_EXTRAS_KEY_LEGACY_STREAM_TYPE
  • 添加一个额外的键来为 playFromUri 随机播放媒体
  • 将 @Nullable 注解添加到 Result 类
  • 修复 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 更改

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

  • 添加了一个新的 bundle 键 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）
  • 将 @Nullable 注解添加到 Result 类（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 包含以下提交。

错误修复

  • 为 MediaButtonReceiver 的 PendingIntent 设置 FLAG_IMMUTABLE，这是面向 Android 12 的应用所需的。
  • 修复了 API 27 中 MediaSessionCompat 在 setCallback(null) 之后出现的 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，它应该与当前元数据的 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 已发布。此版本中包含的提交可以在这里找到 这里。

新功能

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

版本 1.1.0-alpha04

2019 年 4 月 3 日

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

错误修复

版本 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