此页面由 Cloud Translation API 翻译。

Media2

API 参考文档
androidx.media2.common
androidx.media2.player
androidx.media2.session
androidx.media2.widget

与其他应用共享媒体内容和控件。

最近更新时间	稳定版	候选版	Beta 版	Alpha 版
2024 年 1 月 10 日	1.3.0	-	-	-

声明依赖项

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

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

Groovy

dependencies {
    def media2_version = "1.3.0"

    // Interacting with MediaSessions
    implementation "androidx.media2:media2-session:$media2_version"
    // optional - UI widgets for VideoView and MediaControlView
    implementation "androidx.media2:media2-widget:$media2_version"
    // optional - Implementation of a SessionPlayer
    implementation "androidx.media2:media2-player:$media2_version"
}

Kotlin

dependencies {
    val media2_version = "1.3.0"

    // Interacting with MediaSessions
    implementation("androidx.media2:media2-session:$media2_version")
    // optional - UI widgets for VideoView and MediaControlView
    implementation("androidx.media2:media2-widget:$media2_version")
    // optional - Implementation of a SessionPlayer
    implementation("androidx.media2:media2-player:$media2_version")
}

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

反馈

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

创建新问题

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

版本 1.3

版本 1.3.0

2024 年 1 月 10 日

发布了 androidx.media2:media2-*:1.3.0。版本 1.3.0 中包含这些提交内容。

自 1.2.0 以来的重要变更

androidx.media2 现已完全废弃。请改用 androidx.media3。

版本 1.3.0-rc01

2023 年 12 月 13 日

发布了 androidx.media2:media2-*:1.3.0-rc01，该版本与 Media2 1.3.0-beta01 相比没有变化。版本 1.3.0-rc01 中包含这些提交内容。

版本 1.3.0-beta01

2023 年 11 月 29 日

发布了 androidx.media2:media2-*:1.3.0-beta01，该版本与 Media2 1.3.0-alpha01 相比没有变化。版本 1.3.0-beta01 中包含这些提交内容。

版本 1.3.0-alpha01

2023 年 11 月 15 日

发布了 androidx.media2:media2-*:1.3.0-alpha01。版本 1.3.0-alpha01 中包含这些提交内容。

API 变更

androidx.media2 现已完全弃用。已改用 androidx.media3。(I53164)

版本 1.2.1

2022 年 2 月 9 日

发布了 androidx.media2:media2-*:1.2.1。版本 1.2.1 中包含这些提交内容。

bug 修复

修复了以 API 33 为目标平台时对自定义 Parcelable 进行的检查。

版本 1.2.0

2021 年 9 月 15 日

发布了 androidx.media2:media2-*:1.2.0。版本 1.2.0 中包含这些提交内容。

自 1.1.0 以来的重要变更

支持与 (prepare|play)From(MediaId|Uri|Search) 的 AndroidX 媒体互操作
在 MediaConstants 中添加了 MEDIA_URI_PATH_SET_MEDIA_URI 和 MEDIA_URI_QUERY_URI

版本 1.2.0-rc01

2021 年 9 月 1 日

发布了 androidx.media2:media2-*:1.2.0-rc01。版本 1.2.0-rc01 中包含这些提交内容。

bug 修复

修复了关闭媒体通知时出现的 ANR 问题（Ifdcc2、b/148011394）

版本 1.2.0-beta01

2021 年 6 月 30 日

发布了 androidx.media2:media2-*:1.2.0-beta01。版本 1.2.0-beta01 中包含这些提交内容。

新功能

支持与 (prepare|play)From(MediaId|Uri|Search) 的 AndroidX 媒体互操作

API 变更

在 MediaConstants 中添加了 MEDIA_URI_PATH_SET_MEDIA_URI 和 MEDIA_URI_QUERY_URI

版本 1.2.0-alpha01

2021 年 4 月 21 日

发布了 androidx.media2:media2-*:1.2.0-alpha01。版本 1.2.0-alpha01 中包含这些提交内容。

API 变更

添加了对 (prepare|play)From(MediaId|Uri|Search) 的支持（I13475、b/176949057）

bug 修复

修复了由不必要的同步块导致的死锁问题。
在没有可播放项时重置播放器
允许 onCurrentMediaItemChanged 获取 null 媒体项
在当前媒体项变化时更新通知
在创建会话后立即修复与控制器 compat 之间的互操作性

版本 1.1.3

2021 年 4 月 21 日

发布了 androidx.media2:media2-*:1.1.3。版本 1.1.3 中包含这些提交内容。

bug 修复

修复了由不必要的同步块导致的死锁问题。

版本 1.1.2

2021 年 1 月 27 日

发布了 androidx.media2:media2-*:1.1.2。版本 1.1.2 中包含这些提交内容。

bug 修复

修复了 VersionedParcelable 中的 NPE（I1ec28、b/177060207）

版本 1.1.1

2020 年 12 月 16 日

发布了 androidx.media2:media2-*:1.1.1。版本 1.1.1 中包含这些提交内容。

bug 修复

在当前媒体项变化时更新媒体通知。

版本 1.1.0

2020 年 12 月 2 日

发布了 androidx.media2:media2-*:1.1.0。版本 1.1.0 中包含这些提交内容。

自 1.0.0 以来的重要变更

添加了更多用于处理媒体轨道的 API
更好地支持与 AndroidX 媒体库之间的互操作性
- 添加了 MediaSession#setMediaUri
- 通过 MediaSession#getSessionCompatToken() 公开了 MediaSessionCompat.Token

版本 1.1.0-rc01

2020 年 10 月 28 日

发布了 androidx.media2:media2-*:1.1.0-rc01。版本 1.1.0-rc01 中包含这些提交内容。

修复了 MediaController 在持有锁期间通知回调，从而可能导致死锁的问题 (I76c56
修复了 MediaSessionImplBase#isClosed() 在已释放的 MediaSessionCompat 上调用 getCurrentControllerInfo() 时可能崩溃的问题。(aosp/1423291]
修复了 media2 MediaSession 未将有效队列项 ID 设为 PlaybackStateCompat 的问题 (aosp/1421652)
在绑定到服务时添加了 BIND_INCLUDE_CAPABILITIES 标记，以允许无头媒体应用在获得相应权限的情况下使用位置信息。这对于 Android Auto 应用尤其有用。(aosp/1440731)

版本 1.1.0-beta01

2020 年 9 月 16 日

发布了 androidx.media2:media2-*:1.1.0-beta01。版本 1.1.0-beta01 中包含这些提交内容。

bug 修复

当媒体项更改时重置当前位置
建立连接后发送元数据和缓冲状态
修复了在会话与控制器之间发送大量数据时发生崩溃的问题
在 Android 11 中，为 media 和 media2 的清单添加了 <queries>
修复了 MediaController.getPlaylist() 的 NPE 问题
不允许使用 seek 命令时，停用 MediaControlView 的进度条
当会话的当前媒体项更改时，通知 PlaybackStateCompat
修复了 SessionPlayer.TrackInfo 的打包问题

版本 1.1.0-alpha01

2020 年 6 月 24 日

发布了 androidx.media2:media2-*:1.1.0-alpha01。版本 1.1.0-alpha01 中包含这些提交内容。

bug 修复

修复了在更新元数据时出现的时间问题（I45567、b/143999611）
SessionResult 将保留来自 PlayerResult 的 MediaItem（I927b0、b/154885520）
修复了 MediaController#setVolumeTo() 可能会更改错误音频流音量的问题。（I76870、b/151204736）

版本 1.0.3

2020 年 2 月 19 日

发布了 androidx.media2:media2-*:1.0.3。media2-{common,player,session} 的版本 1.0.3 中包含这些提交内容，media2-widget 的版本 1.0.3 中包含这些提交内容。

bug 修复

修复了使用 null 回调创建 MediaController 时的 NullPointerException
修复了在 MediaPlayer.setMediaItem 之后未调用 onPlaylistChanged() 的问题

版本 1.0.2

2020 年 2 月 5 日

发布了 androidx.media2:media2-*:1.0.2。media2-{common,player,session} 的版本 1.0.2 中包含这些提交内容，media2-widget 的版本 1.0.2 中包含这些提交内容。

bug 修复

修复了 MediaPlayer#getSelectedTrack() 中的 IndexOutOfBoundsException。(aosp/987003)
改进了以下情况的处理方式：ExoPlayer 调用 getDuration()，而媒体内容不存在 (aosp/987484)
修复了当在 IDLE 状态调用 getDuration() 时，ExoPlayer 不会抛出 IllegalStateException 的错误 (aosp/987246)
不允许 media2 的自定义 Parcelable (aosp/1091056)
修复了导致 close() 中断的问题 (aosp/1096455)
MediaBrowser：改进了使用 MediaBrowserService 在 subscribe() 中处理错误的方式 (aosp/1158057)
修复了与框架 MediaSession 有关的 MediaController 崩溃问题 (aosp/1177663)
建立连接后，不通过回调提供会话信息（aosp/1195030、b/142925848）
修复了可通过 MediaController 多次意外发送 SessionResult 的问题 (aosp/1198634)
修复了 MediaController 可能会向 MediaSession 发送不允许的命令的问题，因此 MediaSession 现在会发送 RESULT_ERROR_PERMISSION_DENIED (aosp/1204183)
修复了与 MediaControllerView#setPlayer 有关的异常问题 (aosp/987004)

版本 1.0.1

2019 年 10 月 9 日

发布了 androidx.media2:media2-*:1.0.1。androidx.media2:media2-{player, session}:1.0.1 的版本 1.0.1 中包含这些提交内容，androidx.media2:media2-widget:1.0.1 的版本 1.0.1 中包含这些提交内容。

bug 修复

修复了跨进程发送 MediaItem 子类时出现的 RuntimeException (aosp/1098971)
修复了播放播放列表时 MediaPlayer 仅调用 onCurrentMediaItemChanged() 一次的问题
修复了 MediaPlayer 可以播放包含 2 个以上项目的播放列表的问题 (aosp/1108440)
修复了播放器即使不可见也继续在 SurfaceView 上播放的问题
修复了在调用 setPlayer 之前调用 setViewType 时出现的 VideoView 播放的问题

版本 1.0.0

2019 年 9 月 5 日

发布了 androidx.media2:media2-*:1.0.0。前者是 media2-{player, session}:1.0.0 中包含的提交，后者是 media2-widget:1.0.0 中包含的提交。

Media2 1.0.0 的主要功能

Media2 是下列 Media API 的新一代：MediaSession、MediaController、MediaBrowser、MediaBrowserService、VideoView 和 MediaControlView。

media2.player.MediaPlayer
- API 主要与 android.media.MediaPlayer 匹配，底层引擎是 ExoPlayer
- 内置音频焦点和噪声处理
- 实现 SessionPlayer
media2.session.MediaSession
- 提供细粒度权限控制
- 支持自定义布局
- 易于使用 SessionPlayer，如 androidx.media2.player.MediaPlayer
- 可与 MediaControllerCompat 互操作
media2.session.MediaSessionService
- 轻量级版本的 MediaLibraryService
- 为后台播放提供服务生命周期管理
- 可与 MediaControllerCompat 和 MediaBrowserServiceCompat 互操作
media2.session.MediaLibraryService
- 支持更好的分页，以便浏览媒体项或搜索包含大量项目的结果
- 可与 MediaControllerCompat 和 MediaBrowserServiceCompat 互操作
media2.session.MediaController
- 可以连接到 MediaSession、MediaSessionService 和 MediaLibraryService
- 可与 MediaSessionCompat 和 MediaBrowserServiceCompat 互操作
media2.session.MediaBrowser
- 继承 MediaController
- 可以连接到 MediaSession、MediaSessionService 和 MediaLibraryService
- 可与 MediaSessionCompat 和 MediaBrowserServiceCompat 互操作
media2.widget.VideoView
- 包含 android.widget.VideoView 的所有功能
- 能够在 TextureView 和 SurfaceView 之间切换
- 可以与 MediaSession 配合使用
media2.widget.MediaControlView
- 改善外观
- 包含 android.widget.MediaController 的所有功能
- 提供字幕轨道选择、播放速度选择和全屏模式

版本 1.0.0-rc02

2019 年 8 月 22 日

发布了 androidx.media2:media2-*:1.0.0-rc02，点击此处可查看此版本中包含的更改。此版本包含 androidx.media2:media2-widget:1.0.0-rc02，点击此处可查看此版本中包含的更改。

新功能

当 MediaControlView 属于 VideoView 时，不再允许通过 MediaControlView (MCV) 调用 setPlayer 或 setController

bug 修复

MediaControlView：仅当存在下一个或上一个媒体项时，下一个和上一个按钮才可点击。
MediaControlView：修复了调用 onAttachedToWindow() 时的异常 NullPointerException
现在，如果当前媒体项发生更改，Media2 Widget 能够正常处理新媒体项的元数据

2019 年 7 月 2 日

发布了 androidx.media2:media2-widget:1.0.0-beta01。点击此处可查看此版本中包含的提交内容。

新功能

后台播放：VideoView 可以获取 SessionPlayer 或 MediaController，以便应用无缝切换到后台播放模式，而不必在 VideoView 内部创建播放器。
移除了与 media2-player 库的依赖关系
添加了 onViewTypeChangedListener

API 变更

公开范围从公开更改为受保护：
- VideoView.onMeasure(int, int)
- VideoView.onAttachedToWindow()
- VideoView.onDetachedFromWindow()
- MediaControlView.onMeasure(int, int)
已移除：
- VideoView.getSessionToken()
- VideoView.setAudioAttributes(AudioAttributesCompat)
- VideoView.setMedaItem(MediaItem)
- MediaControlView.setSessionToken(SessionToken)
已添加：
- VideoView.setMediaController(MediaController)
- VideoView.getMediaControlView()
- VideoView.setMediaController(MediaController)
- VideoView.setPlayer(SessionPlayer)
- VideoView.setOnViewTypeChangedListener()
- MediaControlView.setPlayer(SessionPlayer)
- MediaControlView.setMediaController(MediaContoller)

版本 1.0.0-rc01

2019 年 6 月 18 日

发布了 androidx.media2:media2-common:1.0.0-rc01、androidx.media2:media2-player:1.0.0-rc01 和 androidx.media2:media2-session:1.0.0-rc01。点击此处可查看此版本中包含的提交内容。

API 变更

对 ListenableFuture 的依赖项已迁移回到 Guava 的独立实现。
请注意，如果您有测试目标依赖于完整 Guava 工件，在使用某些版本的 Android Gradle 插件时可能会遇到依赖关系解析冲突。如果遇到涉及 ListenableFuture 的 Could not resolve all artifacts 错误，可以通过向项目编译配置添加 android.dependency.useConstraints=false 来暂时解决这个问题。我们目前正在努力开发 Android Gradle 插件内的永久性修复方案，将于晚些时候发布。

版本 1.0.0-beta02

2019 年 6 月 5 日

发布了 androidx.media2:media2-common:1.0.0-beta02、androidx.media2:media2-player:1.0.0-beta02 和 androidx.media2:media2-session:1.0.0-beta02。点击此处可查看此版本中包含的提交内容。

bug 修复

在 androidx.media.player.MediaPlayer 上设置负播放速度将返回 RESULT_ERROR_BAD_VALUE。
将 Guava ListenableFuture 替换为 Jetpack 实现 (aosp/968828)

版本 1.0.0-beta01

2019 年 5 月 7 日

发布了 androidx.media2:media2-common:1.0.0-beta01、androidx.media2:media2-player:1.0.0-beta01 和 androidx.media2:media2-session:1.0.0-beta01。点击此处可查看此版本中包含的提交内容。

新功能

库拆分成 3 个部分：media2-common、media2-player、media2-session
对于标记为 @NonNull 的 null 参数，已将 IllegalPointerException 更改为 NullPointerException。

API 变更

引入了 MediaController.Builder
针对 FileMediaItem.Builder 的可选字段添加了 setter 方法
MediaController 和 MediaBrowser 可以将应用的连接提示发送到 MediaSession、MediaSessionService 或 MediaLibraryService
部分方法已经重命名以符合 Android 10 Media2 API

版本 1.0.0-alpha04

2018 年 12 月 17 日

API 变更

已重命名以下类：
- MediaPlayer2 → MediaPlayer
- MediaSession2 → MediaSession
- MediaController2 → MediaController
- MediaSessionService2 → MediaSessionService
- MediaLibraryService2 → MediaLibraryService
- MediaBrowser2 → MediaBrowser
- MediaMetadata2 → MediaMetadata
- Rating2 → Rating
- SessionToken2 → SessionToken
- SessionCommand2 → SessionCommand
- SessionCommandGroup2 → SessionCommandGroup
已合并以下类：
- DataSourceDesc2 和 MediaItem2 已合并为 MediaItem
- MediaPlaylistAgent 和 MediaPlayerConnector 已合并为 SessionPlayer
添加了 Rating 的以下子类：HeartRating、PercentageRating、StarRating 和 ThumbRating
Media2 现在将 ListenableFuture 用于异步方法

Media2

声明依赖项

Groovy

Kotlin

反馈

版本 1.3

版本 1.3.0

版本 1.3.0-rc01

版本 1.3.0-beta01

版本 1.3.0-alpha01

版本 1.2.1

版本 1.2.1

版本 1.2.0

版本 1.2.0

版本 1.2.0-rc01

版本 1.2.0-beta01

版本 1.2.0-alpha01

版本 1.1.3

版本 1.1.3

版本 1.1.2

版本 1.1.2

版本 1.1.1

版本 1.1.1

版本 1.1.0

版本 1.1.0

版本 1.1.0-rc01

版本 1.1.0-beta01

版本 1.1.0-alpha01

版本 1.0.3

版本 1.0.3

版本 1.0.2

版本 1.0.2

版本 1.0.1

版本 1.0.1

版本 1.0.0

版本 1.0.0-rc02

Media2-Widget 版本 1.0.0-beta01

版本 1.0.0-rc01

版本 1.0.0-beta02

版本 1.0.0-beta01

版本 1.0.0-alpha04