1. 项目概述Android Media3后台视频播放实现在移动应用开发中后台播放功能是提升用户体验的关键特性。想象一下这样的场景用户正在观看教学视频时突然需要回复消息如果应用不具备后台播放能力视频就会中断。这正是Android Media3库要解决的核心问题——让媒体内容在应用退到后台时仍能持续播放。Media3作为Jetpack组件库的一部分专门为Android媒体应用提供标准化解决方案。相比传统MediaPlayer API它具备三大核心优势完整的生命周期管理自动处理Activity销毁后的播放延续系统级集成无缝对接Android媒体控件和通知中心跨设备支持适配Android Auto、Wear OS等平台2. 技术架构解析2.1 MediaSessionService的核心作用MediaSessionService是后台播放的中枢神经系统。与常规Service不同它专门设计用于媒体播放场景主要承担以下职责播放器托管维护ExoPlayer实例的生命周期会话管理处理来自各端的控制请求物理按键、通知栏控件等状态同步保持UI与控制器的状态一致性典型架构如下图所示[UI层] ←→ [MediaController] ←→ [MediaSessionService] ↑ ↑ [系统媒体控件] [ExoPlayer实例]2.2 关键组件交互流程初始化阶段Activity创建MediaController实例Service启动并创建MediaSession两者通过Binder建立连接播放控制阶段UI操作 → MediaController → MediaSession → Player系统事件如耳机拔出→ MediaSession → Player状态同步阶段Player状态变更 → MediaSession → 所有连接的MediaController3. 实现步骤详解3.1 基础服务搭建首先创建继承MediaSessionService的PlaybackServiceclass VideoPlaybackService : MediaSessionService() { private var mediaSession: MediaSession? null override fun onCreate() { super.onCreate() // 配置ExoPlayer实例 val player ExoPlayer.Builder(this) .setHandleAudioBecomingNoisy(true) // 自动处理音频中断 .build() // 构建媒体会话 mediaSession MediaSession.Builder(this, player) .setSessionCallback(MySessionCallback()) .build() } override fun onDestroy() { mediaSession?.player?.release() mediaSession?.release() super.onDestroy() } override fun onGetSession(controllerInfo: MediaSession.ControllerInfo) mediaSession }3.2 AndroidManifest配置必须声明必要的权限和服务uses-permission android:nameandroid.permission.FOREGROUND_SERVICE/ uses-permission android:nameandroid.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK/ service android:name.VideoPlaybackService android:foregroundServiceTypemediaPlayback android:exportedtrue intent-filter action android:nameandroidx.media3.session.MediaSessionService/ /intent-filter /service3.3 播放器界面控制在Activity中建立控制器连接class PlayerActivity : AppCompatActivity() { private var controller: MediaController? null override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) val sessionToken MediaSessionToken(this, ComponentName(this, VideoPlaybackService::class.java)) MediaController.Builder(this, sessionToken) .buildAsync() .addListener({ future - controller future.get() // 绑定UI控件 bindPlayerControls() }, ContextCompat.getMainExecutor(this)) } private fun bindPlayerControls() { controller?.apply { playButton.setOnClickListener { play() } pauseButton.setOnClickListener { pause() } // 更多控制绑定... } } }4. 高级功能实现4.1 通知栏定制通过MediaMetadata提供丰富的通知内容val videoItem MediaItem.Builder() .setMediaId(video_001) .setUri(videoUri) .setMediaMetadata( MediaMetadata.Builder() .setTitle(Android开发教程) .setArtist(Google开发者) .setArtworkUri(artworkUri) .setExtras(Bundle().apply { putLong(MediaConstants.EXTRAS_KEY_DURATION, durationMs) }) .build() ) .build() controller?.setMediaItem(videoItem)4.2 播放状态恢复实现onPlaybackResumption支持断点续播override fun onPlaybackResumption( session: MediaSession, controller: MediaSession.ControllerInfo, isForPlayback: Boolean ): ListenableFutureMediaItemsWithStartPosition { val future SettableFuture.createMediaItemsWithStartPosition() CoroutineScope(Dispatchers.IO).launch { val lastPosition preferences.getLong(last_position, 0L) val items database.getLastPlaylist() future.set(MediaItemsWithStartPosition(items, lastPosition, 0)) } return future }5. 实战问题排查5.1 常见问题解决方案问题现象可能原因解决方案通知栏不显示未设置MediaMetadata确保每个MediaItem都包含完整的元数据后台播放被终止电源优化限制在设置中豁免应用的电池优化音频焦点丢失未正确处理焦点变化实现AudioFocusHandler画中画模式异常未配置PIP参数在Activity添加pipConfig5.2 性能优化建议内存管理ExoPlayer.Builder(this) .setRenderersFactory(DefaultRenderersFactory(this) .setEnableDecoderFallback(true)) // 启用解码器回退 .setLoadControl(DefaultLoadControl.Builder() .setBackBuffer(15000, true) // 设置回放缓冲 .build())网络优化val dataSourceFactory DefaultDataSource.Factory(this, OkHttpDataSource.Factory(OkHttpClient.Builder() .connectTimeout(15, TimeUnit.SECONDS) .build()) )电量控制使用CachedDataSource处理重复播放根据网络类型调整码率AdaptiveTrackSelection6. 兼容性处理6.1 旧版系统适配对于需要支持Android 8.0以下的设备if (Build.VERSION.SDK_INT Build.VERSION_CODES.O) { startService(Intent(this, VideoPlaybackService::class.java)) } else { startForegroundService(Intent(this, VideoPlaybackService::class.java)) }6.2 多控制器管理区分不同来源的控制请求class MySessionCallback : MediaSession.Callback { override fun onConnect( session: MediaSession, controller: MediaSession.ControllerInfo ): ConnectionResult { return when { session.isAutoCompanionController(controller) - { // 车载设备特殊处理 AcceptedResultBuilder(session, controller) .setAvailablePlayerCommands(carCommands) .build() } else - super.onConnect(session, controller) } } }在实际项目中我们发现后台播放最关键的三个要素是稳定的服务生命周期管理、完善的媒体元数据系统以及灵活的音视频焦点处理。特别是在处理视频内容时需要额外注意Surface的生命周期同步问题——当Activity进入后台时要及时释放Surface资源但保持音频继续播放这需要精确控制Player的renderer设置。