96SEO 2026-04-29 05:48 1
Ru果你在 Android 开发中曾为「MediaPlayer」的兼容性、缓冲卡顿或后台播放烦恼,那么 Media3无疑是一把打开新局面的钥匙。本文不止是搬运官方文档,而是把零散的碎片拼成一条完整的流水线,让你在阅读完后Ke以直接复制运行。

传统的 android.media.MediaPlayer 在面对 HLS/DASH、自适应码率以及多音轨时常显得力不从心。相比之下Media3 拥有:
模块化设计——只拉你需要的功Neng,体积geng轻。
Jetpack 原生支持——与 Compose、Lifecycle 完美融合。
统一的媒体会话——一次实现后台播放、锁屏控制和通知栏交互。
强大的缓存系统——同一资源不必重复下载。
换句话说它把“播放器”与“UI 控件”“缓存”“后台服务”dou拆成了可独立组合的乐高块,你只需要挑选合适的砖块拼装即可。
二、项目准备:依赖与权限声明 1️⃣ Gradle 中加入 Media3 核心库
// 请自行在根目录 ext 中声明版本号
def media3Ver = "1.2.1"
implementation "androidx.media3:media3-exoplayer:$media3Ver"
implementation "androidx.media3:media3-ui:$media3Ver"
// 可选:HLS 与 DASH 支持
implementation "androidx.media3:media3-exoplayer-hls:$media3Ver"
implementation "androidx.media3:media3-exoplayer-dash:$media3Ver"
2️⃣ 必要权限
记得在 Android 12 以后若目标 SDK ≥ 31,还需要在运行时向用户申请「前台服务」权限,否则系统会直接拦截后台音视频。
三、核心概念速览
ExoPlayer负责解码和渲染,是播放器的大脑。
MediaItem对单个音视频资源的抽象包装,包含 URL、标题、封面等元信息。
PlayerView / PlayerSurface官方提供的 UI 控件,前者是 View 系统,后者是 Compose 专用。
MediaSession让系统认识你的播放器,实现锁屏/通知栏/耳机键控制。
CacheDataSource / SimpleCache: 本地磁盘缓存层,避免重复下载。
把这些概念当作 LEGO 的不同颜色砖块,你Ke以随意组合出「视频播放器」「音乐播放器」甚至「多媒体编辑器」等形态。
四、Zui基础的播放实现 a) 布局文件 – activity_media_basic.xml
b) Activity – MediaBasicActivity.kt
package com.example.mediaapp
import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
import androidx.media3.common.MediaItem
import androidx.media3.exoplayer.ExoPlayer
import androidx.media5.ui.PlayerView
class MediaBasicActivity : AppCompatActivity {
private var player: ExoPlayer? = null
private lateinit var playerView: PlayerView
// 演示用的视频链接,可替换为任意 HLS / MP4 地址
private val demoUrl = "https://test-videos.co.uk/vids/bigbuckbunny/mp4/h264/Big_Buck_Bunny_1080_10s_1MB.mp4"
override fun onCreate {
super.onCreate
setContentView
playerView = findViewById
initPlayer
}
/** 初始化播放器并绑定 UI **/
private fun initPlayer {
player = ExoPlayer.Builder.build.also { exo ->
// 把播放器塞进 PlayerView
playerView.player = exo
// 创建 MediaItem 并准备播放
val item = MediaItem.fromUri
exo.setMediaItem
exo.prepare
exo.playWhenReady = true // 自动开始
}
}
/** 生命周期安全处理 **/
override fun onStart {
super.onStart
player?.playWhenReady = true // 页面可见时恢复播放
}
override fun onStop {
super.onStop
player?.playWhenReady = false // 页面不可见时暂停
}
override fun onDestroy {
super.onDestroy
player?.release
player = null
}
}
这段代码演示了「创建 → 绑定 → 播放 → 生命周期释放」四个关键步骤。只要把上述文件放进项目,即可kan到一个Neng自动播放的小窗口。
五、Compose 场景下的原生写法 a) 添加 Compose 依赖
implementation "androidx.media3:media3-compose:$media3Ver"
implementation "androidx.compose.ui:ui:${compose_version}"
implementation "androidx.activity:activity-compose:${activity_compose_version}"
b) 一个完整的 Composable 示例
@Composable
fun MediaComposeDemo {
val context = LocalContext.current
// remember 会让对象在重组时保持不变;DisposableEffect 用来自动释放资源
val exoPlayer = remember {
ExoPlayer.Builder.build.apply {
val item = MediaItem.fromUri
setMediaItem
prepare
playWhenReady = true
}
}
DisposableEffect {
onDispose { exoPlayer.release }
}
// 官方提供的 PlayerSurface 完全基于 Compose 绘制画面
PlayerSurface(
modifier = Modifier.fillMaxSize,
player = exoPlayer,
) {
// 内置控件支持快进快退、静音等基本操作,可自行替换风格
PlayerControls
}
}
注意,这段代码没有出现任何 , 完全遵循 Compose 的状态驱动模型,一行代码就完成了「创建‑渲染‑销毁」闭环。配合 Jetpack Navigation,你甚至Ke以把它当作页面级别的组件随意跳转。
Kotlin 中使用 .setMediaItems Ke以一次性塞入多个 MediaItem,实现无缝切歌:
val playlist = listOf(
MediaItem.fromUri,
MediaItem.fromUri,
MediaItem.fromUri
)
player?.setMediaItems
player?.prepare
player?.playWhenReady = true // 自动从第一条开始播放
// 当一条结束后内部会自动跳到下一条,无需额外监听。
6.2 全局缓存配置
下面示例展示如何在 Application 的 onCreate 中创建 SimpleCache,并让所有 ExoPlayer 实例共享它:
class MyApp : Application {
lateinit var cache : Cache
override fun onCreate {
super .onCreate
val cacheDir= File
cache=SimpleCache)
}
}
// 在 Activity 或 Service 中构造玩家时注入 CacheDataSourceFactory
private fun buildPlayer:ExoPlayer{
val cacheFactory=CacheDataSource.Factory
.setCache.cache)
.setUpstreamDataSourceFactory)
return ExoPlayer.Builder
.setMediaSourceFactory
.build
}
这样一来同一个 URL 第一次访问会走网络下载,随后dou会命中磁盘缓存;对直播流也同样有效,只是会保留Zui近几分钟的数据片段而Yi。
6.3 后台服务 + 通知栏
借助 media‑session 库,你不必自己写 Service 与 Notification,只要声明一个 MediaSessionService 即可获得系统自动生成的媒体通知:
< /intent‑filter>
< /service>
随后在 Activity 中绑定:
kotlin
private lateinit var mediaSession : MediaSession
private fun initSession{
mediaSession=MediaSession.Builder
.build
// 将 SessionToken 塞进 UI 控件,使系统知道该用哪个通知模板
playerView.sessionToken=mediaSession.sessionToken
}
此后系统会帮你处理「锁屏控制」「耳机线控」「媒体中心搜索」等细节,你只需要关注业务逻辑即可。
特性 旧版 ExoPlayer Media31
模块化程度 核心+UI 打包一起 核心/UI/Cache/Session 等均可单独引入
Compose 支持 需通过 AndroidView 包装 原生提供 PlayerSurface 与 Controls
API 命名 冗长且部分Yi废弃 统一以 mediaX 命名,geng加直观
兼容性 Zui低 API21 Zui低 API21,同步geng新至Zui新 Jetpack
至此,你Yi经掌握了从Zui简单的视频渲染,到 Compose 原生播放,再到后台缓存与媒体会话的一整套流程。别忘了把这些代码块拆分成独立模块,让团队成员各自负责「解码层」「UI 层」「服务层」,真正发挥出 Media31 的模块化优势。
祝你玩转 Android 多媒体世界,玩出花样来! 🎉
© 2026 媒体技术博客 | 如有侵权请联系删除 | 本文内容基于个人经验撰写,仅供参考。
作为专业的SEO优化服务提供商,我们致力于通过科学、系统的搜索引擎优化策略,帮助企业在百度、Google等搜索引擎中获得更高的排名和流量。我们的服务涵盖网站结构优化、内容优化、技术SEO和链接建设等多个维度。
| 服务项目 | 基础套餐 | 标准套餐 | 高级定制 |
|---|---|---|---|
| 关键词优化数量 | 10-20个核心词 | 30-50个核心词+长尾词 | 80-150个全方位覆盖 |
| 内容优化 | 基础页面优化 | 全站内容优化+每月5篇原创 | 个性化内容策略+每月15篇原创 |
| 技术SEO | 基本技术检查 | 全面技术优化+移动适配 | 深度技术重构+性能优化 |
| 外链建设 | 每月5-10条 | 每月20-30条高质量外链 | 每月50+条多渠道外链 |
| 数据报告 | 月度基础报告 | 双周详细报告+分析 | 每周深度报告+策略调整 |
| 效果保障 | 3-6个月见效 | 2-4个月见效 | 1-3个月快速见效 |
我们的SEO优化服务遵循科学严谨的流程,确保每一步都基于数据分析和行业最佳实践:
全面检测网站技术问题、内容质量、竞争对手情况,制定个性化优化方案。
基于用户搜索意图和商业目标,制定全面的关键词矩阵和布局策略。
解决网站技术问题,优化网站结构,提升页面速度和移动端体验。
创作高质量原创内容,优化现有页面,建立内容更新机制。
获取高质量外部链接,建立品牌在线影响力,提升网站权威度。
持续监控排名、流量和转化数据,根据效果调整优化策略。
基于我们服务的客户数据统计,平均优化效果如下:
我们坚信,真正的SEO优化不仅仅是追求排名,而是通过提供优质内容、优化用户体验、建立网站权威,最终实现可持续的业务增长。我们的目标是与客户建立长期合作关系,共同成长。
Demand feedback