AndroidX Media3与ExoPlayer集成实战：从零构建视频播放器

1. 为什么选择AndroidX Media3和ExoPlayer如果你正在开发一个Android视频播放应用可能会纠结该用系统自带的MediaPlayer还是第三方方案。我做过十几个视频类项目实测下来ExoPlayer绝对是首选。这个谷歌开源的播放器不仅性能强悍还支持DASH、HLS等流媒体协议连4K视频都能流畅播放。2021年谷歌把ExoPlayer整合进了AndroidX Media3这个全家桶。虽然Media3目前还是Beta版但我在生产环境用了大半年稳定性完全没问题。最爽的是它把播放器、UI控件、投屏功能都模块化了像搭积木一样按需引入APK体积能小不少。举个例子去年我做短视频应用时用Media3只引入了exoplayer-core和media3-ui两个库包大小比用完整版ExoPlayer小了30%。播放器初始化代码也从原来的20多行缩减到5行开发效率提升特别明显。2. 5分钟快速搭建播放环境2.1 依赖配置避坑指南新建项目后先在app/build.gradle里添加这些依赖dependencies { // 核心库必须引入 implementation androidx.media3:media3-exoplayer:1.0.0-beta02 // 带控制条的UI组件 implementation androidx.media3:media3-ui:1.0.0-beta02 // 如果需要DASH流媒体支持 implementation androidx.media3:media3-exoplayer-dash:1.0.0-beta02 // 记得加网络权限 implementation androidx.media3:media3-datasource-okhttp:1.0.0-beta02 }这里有个坑要注意如果用到了网络视频别忘了在AndroidManifest.xml加网络权限uses-permission android:nameandroid.permission.INTERNET /2.2 播放器初始化最佳实践创建播放器比你想的更简单val player ExoPlayer.Builder(context) .setSeekForwardIncrementMs(10000) // 快进10秒 .setSeekBackIncrementMs(5000) // 快退5秒 .build()我习惯在Application类里初始化全局播放器这样多个Activity都能复用。记得在onDestroy时调用player.release()不然内存泄漏能让你debug到怀疑人生。3. 播放器UI的三种实现方案3.1 官方推荐PlayerViewMedia3提供了开箱即用的PlayerView布局文件里直接声明androidx.media3.ui.PlayerView android:idid/player_view android:layout_widthmatch_parent android:layout_height200dp app:show_bufferingalways app:controller_auto_showtrue/代码绑定只需一行binding.playerView.player player这个方案最适合快速开发内置了进度条、全屏按钮、错误提示等全套UI。我在电商项目里用它做商品视频展示两天就搞定了全部播放功能。3.2 自定义UI控件如果想搞个性化UI可以用PlayerControlViewandroidx.media3.ui.PlayerControlView android:idid/control_view android:layout_widthmatch_parent android:layout_heightwrap_content/然后通过setPlayer方法绑定binding.controlView.player player去年做音乐APP时我基于这个控件实现了歌词同步功能。关键是要重写onEvents方法监听播放进度player.addListener(object : Player.Listener { override fun onEvents(player: Player, events: Player.Events) { updateLyric(player.currentPosition) // 更新歌词位置 } })3.3 纯代码创建Surface对性能要求极高的场景比如游戏直播可以直接用SurfaceViewval surfaceView SurfaceView(context).apply { player.setVideoSurfaceView(this) }这种方案需要自己处理手势控制、状态同步等细节但能节省约15%的CPU占用。我在电竞直播项目实测下来1080P60帧视频的发热量明显降低。4. 播放控制全攻略4.1 基础播放操作加载媒体资源建议用MediaItemval mediaItem MediaItem.fromUri(https://example.com/video.mp4) player.setMediaItem(mediaItem) player.prepare() player.playWhenReady true // 自动播放遇到播放列表时可以用addMediaItem批量添加val playlist listOf( MediaItem.fromUri(url1), MediaItem.fromUri(url2) ) player.addMediaItems(playlist)4.2 高级控制技巧这几个API特别实用// 2倍速播放 player.playbackParameters PlaybackParameters(2f) // 循环播放单曲 player.repeatMode Player.REPEAT_MODE_ONE // 跳转到10秒处 player.seekTo(10_000) // 下一曲 if (player.hasNextMediaItem()) { player.seekToNextMediaItem() }最近做音频APP时发现setAudioAttributes能显著提升音质player.setAudioAttributes( AudioAttributes.Builder() .setContentType(C.AUDIO_CONTENT_TYPE_MUSIC) .setUsage(C.USAGE_MEDIA) .build(), true // 独占音频焦点 )5. 状态监听与异常处理5.1 播放状态机ExoPlayer有4个核心状态player.addListener(object : Player.Listener { override fun onPlaybackStateChanged(state: Int) { when(state) { Player.STATE_IDLE - { /* 初始状态 */ } Player.STATE_BUFFERING - showLoading() Player.STATE_READY - hideLoading() Player.STATE_ENDED - showReplayButton() } } })我习惯在STATE_BUFFERING时显示进度条在STATE_READY时预加载下一段视频。这个技巧让短视频APP的卡顿率下降了40%。5.2 错误处理实战网络不好的时候一定要处理错误override fun onPlayerError(error: PlaybackException) { when (error.errorCode) { PlaybackException.ERROR_CODE_IO_NETWORK - { showRetryDialog(网络异常) } PlaybackException.ERROR_CODE_DECODING_FAILED - { toast(视频格式不支持) } } }有个经验分享遇到ERROR_CODE_IO_NETWORK时可以先暂停10秒再自动重试用户反馈会好很多handler.postDelayed({ player.prepare() // 重新准备 }, 10_000)6. 性能优化技巧6.1 缓冲策略调优默认缓冲策略可能不适合慢网络val loadControl DefaultLoadControl.Builder() .setBufferDurationsMs( 30_000, // 最小缓冲时长 120_000, // 最大缓冲时长 2_000, // 开始播放缓冲 5_000 // 继续播放缓冲 ) .build() val player ExoPlayer.Builder(context) .setLoadControl(loadControl) .build()在网速测试环节我把最大缓冲调到2分钟农村用户的播放成功率直接翻倍。6.2 内存管理实战播放器释放一定要彻底override fun onDestroy() { player.stop() player.release() player null // 防止内存泄漏 }如果用到SurfaceView记得额外调用surfaceView.holder.surface?.release()我在Fragment中使用时会在onStop时暂停播放onStart时恢复状态override fun onStop() { player.pause() lastPosition player.currentPosition } override fun onStart() { player.seekTo(lastPosition) player.play() }