Media

与其他应用共享媒体内容和控件。已被 media2 取代。
最近更新时间 当前稳定版 下一候选版本 Beta 版 Alpha 版
2021 年 5 月 5 日 1.3.1 - - 1.4.0-alpha01

声明依赖项

如需添加 Media 的依赖项，您必须将 Google Maven 代码库添加到项目中。如需了解详情，请参阅 Google 的 Maven 代码库。

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

Groovy

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

Kotlin

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

如需详细了解依赖项，请参阅添加构建依赖项。

反馈

您的反馈将帮助我们改进 Jetpack。如果您发现了新问题，或对库的改进有某些建议，请告诉我们。创建新问题前，请先查看此库中的现有问题。您可以点击星标按钮，为现有问题投票。

创建新问题

如需了解详情，请参阅问题跟踪器文档。

版本 1.4.0

版本 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 解决了缺少 intent 的 EXTRA_KEY_EVENT 的问题 (If7557)

版本 1.3.1

版本 1.3.1

2021 年 5 月 5 日

发布了 androidx.media:media:1.3.1。版本 1.3.1 中包含这些提交内容。

问题修复

  • 为 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 extras 迁移到了 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 的 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 extras 迁移到了 MediaConstants。(I290ab)
  • 添加了用于约束 MediaBrowserService 的根子级的常量。(Ifcebd)

问题修复

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

版本 1.2.1

Media 版本 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 extra 中的媒体 ID 添加了 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 的版本上 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 已被移除

问题修复

  • 修复了 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 的 null 参数，已将 IllegalPointerException 更改为 NullPointerException。

版本 1.1.0-alpha04

2019 年 4 月 3 日

发布了 androidx.media:media:1.1.0-alpha04。点击此处可查看此版本中包含的提交内容。

问题修复

  • 略微调整了 version-compat-test 常量 (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