HowTo

Media3 1.11 - 新变化

阅读用时:3 分钟
查看 Toni Heidenreich 的个人资料
Toni Heidenreich 软件工程师,Android

Media3 1.11 已发布。此版本为绝大多数顶级 Android 媒体应用提供支持,带来了新功能、问题修复,并对播放、编辑和界面组件进行了改进。我们正在扩展 Jetpack Compose 界面模块,提供可自定义的 Player 槽位和易于使用的默认设置、互动手势、状态观察器,以及使用 PlayerPool 的短视频预加载功能。我们还对 Media3 Cast 集成进行了现代化改造,增加了对 SystemUI 输出切换器的支持,引入了新的 Ktor HTTP 客户端网络扩展,并为 Ogg 和 WAV 文件添加了新的多路复用实用程序。

请继续阅读,了解主要亮点,并查看完整的版本说明,了解变更的完整列表。

播放界面和 Compose

随着 Android 转向 Compose 优先,我们将继续扩展 media3-ui-compose 和 media3-ui-compose-material3 模块。此次更新引入了对播放器布局的更精细控制、更丰富的互动模式,以及与 Material3 的更深度集成。

可自定义的播放器布局

Material 3 Player 可组合项现在支持 topControls、centerControls、bottomControls 和 errorOverlay 的专用内容槽位。您可以添加自己的可组合项,也可以使用 PlayerDefaults 中发布的现成默认值:

Player(
  player = player,
  topControls = { PlayerDefaults.TopControls(player) },
  centerControls = { PlayerDefaults.CenterControls(player) },
  bottomControls = { PlayerDefaults.BottomControls(player) },
)

Player 可组合项还集成了 FocusRequester 支持,可在 Android TV、可折叠设备和桌面环境中实现无缝的方向键和键盘导航。

player_video.png
具有自定义控件的可组合播放器示例

手势和播放速度控制

PlaybackSpeedState 现在提供快进/慢动作 API。demo-compose app通过长按手势快进播放和点按两次进行跳转来展示这一点。结合 1.10 中引入的 ProgressSlider,Compose 播放器界面现在开箱即用,可提供丰富的轻触和手势互动。

使用 PlayerPool 预加载短视频

对于具有滑动窗口媒体 Feed(例如竖屏视频)的应用,如何高效管理多个 ExoPlayer 实例是一个常见挑战。Media3 1.11 引入了 PlayerPool(在 common-ktx中)和 rememberPooledPlayer(在 ui-compose中),用于自动处理播放器回收和预加载。

demo-compose 中新增的 ShortFormPlayerScreen 演示了这一功能:一个垂直分页的 Feed,其中播放器会随着用户滚动而汇集、预加载和无缝回收。

MiniController

media3-ui-compose-material3 中新增了 MiniController 可组合项,可提供紧凑的播放栏,其中显示当前内容的标题、音乐人、封面和进度,以及播放/暂停控件。与 media3-ui-compose-material3 中的所有默认可组合项一样,MiniController 支持 Material3 动态配色集成,使其能够自动适应用户的壁纸主题。这非常适合持久性底部动作条或迷你播放器功能,例如在用户浏览内容或处于活跃的投射会话期间。

mini_player.png
Media3 MiniController 显示专辑封面、媒体元数据和基本控件

扩展了元数据和错误的状态容器

我们向 media3-ui-compose 添加了几个新的响应式状态容器:

  • rememberCurrentMediaItemState - 观察当前播放内容的元数据
  • rememberPlaylistState - 观察完整播放列表和活跃索引
  • rememberErrorState - 跟踪播放错误,在 Material3 中具有匹配的 ErrorText 可组合项和默认 ErrorOverlay

我们将在后续版本中继续添加新功能和更多自定义选项。请通过项目问题跟踪器分享您的想法。

现代化的 Cast 集成

Media3 1.11 更新了 Cast 扩展程序,增加了程序化配置选项,并支持操作系统级路由。

CastParams 和 SystemUI 输出切换器

现在,您可以使用 CastParams 配置 Cast 扩展程序:

val castParams = CastParams.Builder()
  .setShowSystemOutputSwitcherOnCastButtonClick(true)
  .build()


Cast.getSingletonInstance(context).initialize(castParams)

设置 setShowSystemOutputSwitcherOnCastIconClick(true) 会将 MediaRouteButton 配置为在受支持的平台版本上打开 Android 的原生 SystemUI 输出切换器,从而提供统一的输出选择器体验。

Compose 中的响应式 MediaRouteButton 状态

使用 Jetpack Compose 的应用现在可以轻松添加媒体路由按钮(也称为“投放”按钮),该按钮会自动观察对话框状态并相应地进行更新。与 Media3 的 CastPlayer 搭配使用时,无需其他逻辑!

@Composable
fun TopAppBarWithCast() {
  Row {
    Text(text = "App Title")
    MediaRouteButton()
  }
}
cast_button_2.png
应用中的 Media3 媒体路线按钮,用于启动默认输出切换器对话框

核心播放和会话增强功能

Eclipsa Video - HAGC 动态 HDR 元数据 (API 37+)

Eclipsa Video 承诺在各种设备上提供更一致的 HDR 体验,具有一致的基准 HDR 白色,并可根据屏幕和周围环境自适应调整余量,确保在所有设备上都能保留创作意图。

ExoPlayer 现在支持播放渐进式媒体(MP4、Matroska)所需的 HAGC (ST 2094-50) 定时元数据。在搭载 API 37 及更高版本的设备上,播放器会自动将 HAGC 元数据轨道与关联的视频轨道合并,并将元数据带外传递给解码器。在旧款设备上,ExoPlayer 会无缝回退到提供标准 HDR 播放体验,而无需进行调整。  

eclipsa.png
插图:展示 Eclipsa Video HDR 的优势,例如更一致的色彩对比度

新的 Ktor HTTP 客户端扩展程序

新的 media3-datasource-ktor 扩展模块提供由 Ktor HTTP 堆栈支持的 KtorDataSource。这为现有的 Cronet 和 OkHttp 数据源模块提供了一种 Kotlin 优先、协程友好的替代方案。

异步 MediaSession 连接

MediaSession.Callback 现在包含 onConnectAsync(),可让您异步处理控制器连接尝试,例如在接受连接之前验证授权。您可以返回一个带有 Futures.immediateFuture(ConnectionResult) 的即时 Future,以实现与现有 onConnect 相同的行为。 

override fun onConnectAsync(
  session: MediaSession,
  controller: MediaSession.ControllerInfo
): ListenableFuture<MediaSession.ConnectionResult> {
  return authenticateControllerAsync(controller)
}

更安全的 MediaSession 默认设置

对于未在 MediaSession.Callback 中替换 onConnect 或 onConnectAsync 的应用,该库现在默认采用更安全的配置。具体而言,默认情况下,会话数据不再与不受信任的控制器共享,这意味着除非您明确实现这些回调方法来授权连接,否则缺少通知访问权限的第三方应用或非系统应用将无法访问会话数据。

新的多路复用器实现和容器解析

OggMuxer 和 WavMuxer

我们添加了两个新的专用多路复用器:OggMuxer,用于将 OPUS 和 VORBIS 流多路复用到标准 .ogg 文件中;WavMuxer,用于生成未压缩和浮点 PCM .wav 音频文件。

容器解析和轨道引用

  • MP4 轨道引用 (tref):Mp4Muxer.addTrackReference 允许将依赖元数据或辅助轨道链接到主视频流。
  • 章节提取:MP4 文件(.m4a、.m4b)中的 QuickTime 和 Nero 章节以及 Matroska 章节现在会提取为 Chapter 元数据条目,用于有声读物和播客导航。

如果您有任何疑问或功能请求,或者要报告任何 bug,请使用问题跟踪器。我们期待您的加入!

继续阅读