媒体

与其他应用共享媒体内容和控件。已被 media3 取代。
最新更新 稳定版 候选发布版 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 包含这些提交。

Bug 修复

  • 修复 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 包含这些提交。

新功能

  • 将 media 对 core 的依赖项更新到 1.6.0

API 变更

  • 将 isVolumeFixed 添加到 AudioManagerCompat
  • 为单项样式和完成百分比添加 MediaConstants。

Bug 修复

  • 对于 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 包含这些提交。

Bug 修复

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

版本 1.4.2

2021 年 9 月 15 日

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

Bug 修复

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

版本 1.4.1

2021 年 8 月 4 日

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

Bug 修复

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

版本 1.4.0

2021 年 7 月 21 日

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

自 1.3.0 以来的重要变更

  • 在 MediaMetadataCompat 中添加了一个新的捆绑包键 METADATA_KEY_SERIES_CONTENT_ID，用于电视连续剧的媒体内容 ID
  • 在 MediaMetadataCompat 中添加了一个新的捆绑包键 METADATA_KEY_NEXT_EPISODE_CONTENT_ID，用于电视节目的下一集内容 ID
  • 弃用 MediaControllerCompat.TransportControls#EXTRA_LEGACY_STREAM_TYPE 并改为添加 MediaConstants#TRANSPORT_CONTROLS_EXTRAS_KEY_LEGACY_STREAM_TYPE
  • 为 playFromUri 添加一个附加键来随机播放媒体
  • 为 Result 类添加 @Nullable 注解
  • 修复 MediaButtonReceiver 的 intent 缺少 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 变更

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

  • 在 MediaMetadataCompat 中添加了一个新的捆绑包键 METADATA_KEY_NEXT_EPISODE_CONTENT_ID，用于电视节目的下一集内容 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）

Bug 修复

  • 修复 MediaButtonReceiver 的 intent 缺少 EXTRA_KEY_EVENT 的问题（If7557）

版本 1.3.1

版本 1.3.1

2021 年 5 月 5 日

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

Bug 修复

  • 修复 MediaButtonReceiver 的 intent 缺少 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 包含这些提交。

Bug 修复

  • 为 MediaButtonReceiver 的 PendingIntent 设置 FLAG_IMMUTABLE，这是针对 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）

Bug 修复

  • 为媒体按钮待处理 intent 添加 FLAG_RECEIVER_FOREGROUND。

版本 1.2.1

媒体版本 1.2.1

2020 年 12 月 2 日

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

Bug 修复

  • 修复在 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 附加数据中的媒体 ID 添加了 MediaConstants#PLAYBACK_STATE_EXTRAS_KEY_MEDIA_ID，预计该 ID 与当前元数据的 MediaMetadataCompat#METADATA_KEY_MEDIA_ID 相同。

Bug 修复

  • 修复了 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

Bug 修复

  • 修复了 SDK < 21 上 media 和 media2 之间的互操作性问题

版本 1.2.0-alpha03

2020 年 6 月 10 日

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

API 变更

  • MediaConstants.SESSION_EXTRAS_KEY_AUTHTOKEN 已被移除

Bug 修复

  • 修复了 RemoteUserInfo 的 equals() 方法的问题

版本 1.2.0-alpha02

2020 年 4 月 15 日

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

Bug 修复

  • 阻止对 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()

Bug 修复

  • 实现了防止通过 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 已发布。此版本中包含的提交可在此处找到。

Bug 修复

  • 已将 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 已发布。此版本中包含的提交可在此处找到。

Bug 修复

版本 1.1.0-alpha03

2019 年 3 月 21 日

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

Bug 修复

  • 修复了当多个 MediaBrowserCompat 尝试连接到 MedaBrowserServiceCompat 时发生的崩溃问题。（aosp/930246）

版本 1.1.0-alpha02

2019 年 3 月 13 日

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

Bug 修复

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

版本 1.0.1

版本 1.0.1

2019 年 1 月 30 日

androidx.media:media 1.0.1 已发布。

Bug 修复

  • 修复了使用 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