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、可折叠设备和桌面环境中实现无缝的方向键和键盘导航。
手势和播放速度控制
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 动态配色集成,使其能够自动适应用户的壁纸主题。这非常适合持久性底部动作条或迷你播放器功能,例如在用户浏览内容或处于活跃的投射会话期间。
扩展了元数据和错误的状态容器
我们向 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() } }
核心播放和会话增强功能
Eclipsa Video - HAGC 动态 HDR 元数据 (API 37+)
Eclipsa Video 承诺在各种设备上提供更一致的 HDR 体验,具有一致的基准 HDR 白色,并可根据屏幕和周围环境自适应调整余量,确保在所有设备上都能保留创作意图。
ExoPlayer 现在支持播放渐进式媒体(MP4、Matroska)所需的 HAGC (ST 2094-50) 定时元数据。在搭载 API 37 及更高版本的设备上,播放器会自动将 HAGC 元数据轨道与关联的视频轨道合并,并将元数据带外传递给解码器。在旧款设备上,ExoPlayer 会无缝回退到提供标准 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,请使用问题跟踪器。我们期待您的加入!
-
HowTo作为 Android 应用和库开发者,我们都追求同一个目标:打造性能出色、用户体验流畅的应用。其中很大一部分工作涉及 Android 的应用优化工具 R8。R8 会移除未使用的代码,并对剩余代码进行优化和混淆处理,从而提升应用性能。
Breana Tate • 阅读用时:6 分钟 -
HowTo欢迎回到“构建智能 Android 应用”博文系列。在本系列中,您将学习如何将一个基本的 Android 应用转变为个性化、智能化的智能体体验。在上一篇博文中,您了解了如何使用 AppFunctions 连接到智能系统。
Jolanda Verhoef • 阅读用时:9 分钟 -
HowTo欢迎回到“构建智能 Android 应用”博文系列。在本系列中,我们将把一个基本的 Android 应用转变为个性化、智能化的智能体体验。
Thomas Ezan, Jolanda Verhoef, Caren Chang • 阅读用时:8 分钟
每周通过电子邮件接收最新的 Android 开发洞见。