Android MediaSession与MediaBrowserService实现后台音乐播放与通知控制-平芜编程栈

最近在开发一个音乐播放器项目时，遇到了一个非常典型的需求：如何让一首歌在播放时，即使切换到其他页面或应用，也能继续播放，并且用户可以通过系统通知栏或锁屏界面进行控制。这个需求的核心就是实现“后台播放”与“媒体通知”。在 Android 开发中，MediaSession和MediaBrowserService是实现这一功能的标准架构。本文将带你从零开始，完整实现一个支持后台播放和媒体通知的音乐播放器，涵盖从服务创建、会话管理到通知栏交互的全流程，并提供可直接运行的代码示例。

1. 背景与核心概念：为什么需要 MediaSession？

在移动应用场景中，音频播放是一个常见功能。但简单的MediaPlayer或ExoPlayer实例通常与Activity的生命周期绑定，一旦应用退到后台，播放就会停止，这显然无法满足音乐、播客等应用的需求。

MediaSession 框架是 Android 5.0 (API 21) 引入的一套标准化媒体播放控制框架。它解决了几个关键问题：

后台播放：通过Service（通常是MediaBrowserService）来托管播放逻辑，使播放不受 UI 生命周期影响。
统一控制接口：它将播放器的状态（播放/暂停、当前曲目、进度等）和控制命令（播放、暂停、切歌等）抽象成一个会话 (MediaSession)。系统或其他应用（如蓝牙设备、智能手表、Android Auto）可以通过标准的MediaController与这个会话交互，而无需了解播放器内部实现。
系统 UI 集成：最重要的表现就是锁屏界面和通知栏的媒体控件。系统通过MediaSession获取播放状态并生成可交互的通知。

简单来说，MediaSession是你的播放器（如 ExoPlayer）与系统及其他控制方之间的“翻译官”和“经纪人”。

2. 环境准备与版本说明

本文将基于以下环境进行演示，但核心逻辑适用于大多数支持MediaSession的 Android 版本。

操作系统: Android 8.0 (API 26) 及以上（为了使用MediaSession和NotificationChannel的最佳实践）。
开发语言: Kotlin
最小 SDK:minSdkVersion 21(Android 5.0)，这是MediaSession的起始版本。
目标 SDK:targetSdkVersion 34(Android 14)
主要依赖:
- AndroidX Media3: Google 官方推荐的现代媒体播放库，它集成了ExoPlayer并提供了对MediaSession的顶级支持。我们将使用它来简化开发。
- AndroidX Core & AppCompat: 用于基础 UI 和通知。
IDE: Android Studio

项目依赖 (app/build.gradle.kts或app/build.gradle):

// 在 dependencies 块中添加 dependencies { implementation("androidx.core:core-ktx:1.12.0") implementation("androidx.appcompat:appcompat:1.6.1") // Media3 核心库 implementation("androidx.media3:media3-exoplayer:1.2.1") implementation("androidx.media3:media3-exoplayer-dash:1.2.1") // 如果需要 DASH 流 implementation("androidx.media3:media3-ui:1.2.1") // 播放器 UI 控件 implementation("androidx.media3:media3-session:1.2.1") // MediaSession 支持 implementation("androidx.media3:media3-common:1.2.1") }

示例项目结构预览：

app/ ├── src/main/ │ ├── java/com.example.musicplayer/ │ │ ├── MainActivity.kt # 主界面，包含 MediaController │ │ ├── PlayerService.kt # 继承 MediaBrowserService，托管播放逻辑 │ │ ├── MusicPlayer.kt # 封装 ExoPlayer 的核心播放器类 │ │ ├── MusicItem.kt # 音乐数据模型 │ │ └── NotificationHelper.kt # 创建媒体通知的工具类 │ └── res/ │ └── ... # 布局、图标等资源

3. 核心组件与原理拆解

在动手编码前，我们需要理解几个核心组件的关系：

MediaBrowserService: 这是一个特殊的Service，它允许外部组件（如Activity）通过MediaBrowser连接到它，并获取一个MediaController来控制播放。我们的播放逻辑就运行在这个服务中。
MediaSession: 在MediaBrowserService中创建。它代表一个播放会话，维护播放状态（PlaybackState）和元数据（MediaMetadata），并处理来自MediaController的控制命令。
ExoPlayer (通过 Media3): 实际的音频/视频播放引擎。MediaSession会将接收到的命令（如PLAY）转发给ExoPlayer执行，同时监听ExoPlayer的状态变化来更新MediaSession。
MediaController: 在Activity或Fragment中创建。它连接到MediaBrowserService的MediaSession，是 UI 层控制播放和监听状态变化的桥梁。
MediaNotification: 由系统根据MediaSession的状态自动生成，或由我们自定义。它为用户提供了在应用外控制播放的界面。

数据流简化视图：

UI (Activity) --(MediaController)--> MediaSession (在Service内) --(命令)--> ExoPlayer <--(状态回调)-- 系统通知栏 <--(状态/元数据)--> MediaSession

4. 完整实战：构建音乐播放器

4.1 创建数据模型与播放列表

首先，定义一个简单的音乐数据模型。

// MusicItem.kt package com.example.musicplayer import android.net.Uri import androidx.media3.common.MediaItem import androidx.media3.common.MediaMetadata data class MusicItem( val id: String, val title: String, val artist: String, val album: String, val durationMs: Long, // 时长，毫秒 val mediaUri: Uri, // 音频文件URI，可以是本地或网络 val artUri: Uri? = null // 专辑封面URI ) { // 转换为 Media3 的 MediaItem，便于 ExoPlayer 使用 fun toMediaItem(): MediaItem { return MediaItem.Builder() .setMediaId(id) .setUri(mediaUri) .setMediaMetadata( MediaMetadata.Builder() .setTitle(title) .setArtist(artist) .setAlbumTitle(album) .setArtworkUri(artUri) .build() ) .build() } } // 创建一个简单的播放列表 object MusicPlaylist { val songs = listOf( MusicItem( id = "song_1", title = "I Can't Stop Me", artist = "TWICE", album = "Eyes Wide Open", durationMs = 210000, // 3分30秒 mediaUri = Uri.parse("asset:///song1.mp3"), // 示例：假设音频在 assets 文件夹 artUri = Uri.parse("https://example.com/cover1.jpg") ), MusicItem( id = "song_2", title = "Feel Special", artist = "TWICE", album = "Feel Special", durationMs = 195000, mediaUri = Uri.parse("https://example.com/audio/song2.mp3"), artUri = Uri.parse("https://example.com/cover2.jpg") ) // ... 可以添加更多歌曲 ) }

4.2 实现核心播放器类 (MusicPlayer)

这个类封装ExoPlayer，并负责将其状态同步到MediaSession。

// MusicPlayer.kt package com.example.musicplayer import android.content.Context import android.support.v4.media.session.MediaSessionCompat import android.support.v4.media.session.PlaybackStateCompat import androidx.media3.common.C import androidx.media3.common.MediaItem import androidx.media3.common.Player import androidx.media3.exoplayer.ExoPlayer import androidx.media3.session.MediaSession import androidx.media3.session.MediaSessionService import com.google.common.util.concurrent.MoreExecutors class MusicPlayer(context: Context) { // ExoPlayer 实例 val exoPlayer: ExoPlayer = ExoPlayer.Builder(context).build() // Media3 的 MediaSession (需要与 MediaSessionService 配合) private var mediaSession: MediaSession? = null // 当前播放列表 private var currentPlaylist: List<MusicItem> = emptyList() private var currentIndex: Int = 0 init { setupPlayerListeners() } private fun setupPlayerListeners() { // 监听播放器状态变化，并同步到 MediaSession exoPlayer.addListener(object : Player.Listener { override fun onPlaybackStateChanged(playbackState: Int) { mediaSession?.let { session -> // 将 ExoPlayer 状态映射到 MediaSession 的 PlaybackState val state = when (playbackState) { Player.STATE_IDLE -> PlaybackStateCompat.STATE_STOPPED Player.STATE_BUFFERING -> PlaybackStateCompat.STATE_BUFFERING Player.STATE_READY -> { if (exoPlayer.isPlaying) PlaybackStateCompat.STATE_PLAYING else PlaybackStateCompat.STATE_PAUSED } Player.STATE_ENDED -> PlaybackStateCompat.STATE_STOPPED else -> PlaybackStateCompat.STATE_NONE } // 更新会话的播放状态（这里简化，实际 Media3 的 MediaSession 会自动处理很多） // 更佳实践是使用 MediaSession.Callback 来关联 } } override fun onMediaItemTransition(mediaItem: MediaItem?, reason: Int) { // 歌曲切换时，更新 MediaSession 的元数据 updateSessionMetadata() } }) } fun setMediaSession(session: MediaSession) { this.mediaSession = session // 将 ExoPlayer 与 MediaSession 关联 session.setPlayer(exoPlayer) } fun preparePlaylist(playlist: List<MusicItem>) { currentPlaylist = playlist val mediaItems = playlist.map { it.toMediaItem() } exoPlayer.setMediaItems(mediaItems) exoPlayer.prepare() updateSessionMetadata() } fun play() { exoPlayer.play() } fun pause() { exoPlayer.pause() } fun playNext() { if (currentPlaylist.isNotEmpty() && currentIndex < currentPlaylist.size - 1) { currentIndex++ exoPlayer.seekToDefaultPosition(currentIndex) } else { exoPlayer.seekToNextMediaItem() } } fun playPrevious() { // 简单实现：回到上一首开头 if (exoPlayer.currentPosition > 3000) { // 如果播放超过3秒，则回到当前歌曲开头 exoPlayer.seekTo(0) } else { exoPlayer.seekToPreviousMediaItem() } } fun seekTo(positionMs: Long) { exoPlayer.seekTo(positionMs) } private fun updateSessionMetadata() { // 更新 MediaSession 的元数据（如当前播放的歌曲信息） // Media3 的 MediaSession 会自动从关联的 Player 中获取，通常无需手动更新 // 这里仅作示意，如果需要自定义逻辑可以在这里处理 val currentItem = exoPlayer.currentMediaItem // ... 可以基于 currentItem 更新自定义的 MediaSessionCompat 元数据 } fun release() { exoPlayer.release() mediaSession?.release() mediaSession = null } }

4.3 实现后台播放服务 (PlayerService)

这是核心，一个MediaSessionService的子类。

// PlayerService.kt package com.example.musicplayer import android.app.Notification import android.app.NotificationChannel import android.app.NotificationManager import android.content.Intent import android.os.Build import android.os.IBinder import androidx.core.app.NotificationCompat import androidx.media3.session.MediaSession import androidx.media3.session.MediaSessionService import com.google.common.util.concurrent.MoreExecutors class PlayerService : MediaSessionService() { private lateinit var musicPlayer: MusicPlayer private lateinit var mediaSession: MediaSession companion object { const val NOTIFICATION_CHANNEL_ID = "music_player_channel" const val NOTIFICATION_ID = 101 } override fun onCreate() { super.onCreate() createNotificationChannel() initializePlayerAndSession() } private fun createNotificationChannel() { if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) { val channel = NotificationChannel( NOTIFICATION_CHANNEL_ID, "音乐播放", NotificationManager.IMPORTANCE_LOW // LOW 级别，不会发出声音，但会显示在通知栏 ).apply { description = "用于控制后台音乐播放" setShowBadge(false) } val manager = getSystemService(NotificationManager::class.java) manager.createNotificationChannel(channel) } } private fun initializePlayerAndSession() { musicPlayer = MusicPlayer(applicationContext) // 创建 MediaSession，关联播放器 mediaSession = MediaSession.Builder(this, musicPlayer.exoPlayer) .setCallback(MediaSessionCallback()) .build() // 将 MediaSession 设置给 MusicPlayer，用于状态同步（如果需要） musicPlayer.setMediaSession(mediaSession) // 准备播放列表 musicPlayer.preparePlaylist(MusicPlaylist.songs) } // 必须重写此方法，返回当前的 MediaSession override fun onGetSession(controllerInfo: MediaSession.ControllerInfo): MediaSession? { return mediaSession } // 当服务启动时调用，我们需要在此处将服务设置为前台服务，以防止被系统回收 override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int { // 创建并显示前台通知 val notification = buildNotification() startForeground(NOTIFICATION_ID, notification) return START_STICKY // 服务被终止后尝试重启 } private fun buildNotification(): Notification { // 这是一个简单示例，Media3 提供了 MediaNotification.Provider 来自动生成通知 // 这里为了演示原理，手动构建一个基础通知 return NotificationCompat.Builder(this, NOTIFICATION_CHANNEL_ID) .setContentTitle("音乐播放器") .setContentText("正在后台播放音乐") .setSmallIcon(android.R.drawable.ic_media_play) // 替换为你的应用图标 .setPriority(NotificationCompat.PRIORITY_LOW) .setVisibility(NotificationCompat.VISIBILITY_PUBLIC) // 锁屏可见 .setOngoing(true) // 持续通知 // 注意：真正的媒体通知控件（播放/暂停按钮）需要 MediaStyle 或 Media3 的 MediaNotification // 这里仅作示意，完整实现见下文“通知栏优化”部分 .build() } override fun onDestroy() { super.onDestroy() musicPlayer.release() mediaSession.release() } // MediaSession 的回调，用于处理来自控制器（如通知栏按钮）的命令 inner class MediaSessionCallback : MediaSession.Callback { // 可以在这里覆盖命令处理逻辑，例如自定义“喜欢”按钮的行为 // 默认情况下，命令会直接传递给关联的 Player (ExoPlayer) } }

别忘了在AndroidManifest.xml中声明服务和权限：

<!-- AndroidManifest.xml --> <manifest ...> <uses-permission android:name="android.permission.FOREGROUND_SERVICE" /> <uses-permission android:name="android.permission.WAKE_LOCK" /> <!-- 如果需要播放网络音频，还需要 INTERNET 权限 --> <application ...> <activity ...> <!-- 你的主 Activity --> </activity> <!-- 声明 MediaSessionService --> <service android:name=".PlayerService" android:exported="false"> <intent-filter> <action android:name="androidx.media3.session.MediaSessionService" /> </intent-filter> </service> </application> </manifest>

4.4 实现主界面与控制逻辑 (MainActivity)

Activity通过MediaController连接到后台服务。

// MainActivity.kt package com.example.musicplayer import android.content.ComponentName import android.os.Bundle import android.support.v4.media.MediaBrowserCompat import android.support.v4.media.session.MediaControllerCompat import android.widget.Button import android.widget.SeekBar import android.widget.TextView import androidx.appcompat.app.AppCompatActivity import androidx.lifecycle.lifecycleScope import kotlinx.coroutines.delay import kotlinx.coroutines.launch class MainActivity : AppCompatActivity() { private lateinit var mediaBrowser: MediaBrowserCompat private var mediaController: MediaControllerCompat? = null private lateinit var btnPlayPause: Button private lateinit var btnNext: Button private lateinit var btnPrev: Button private lateinit var seekBar: SeekBar private lateinit var tvTitle: TextView private lateinit var tvArtist: TextView private val connectionCallback = object : MediaBrowserCompat.ConnectionCallback() { override fun onConnected() { // 连接成功，获取 MediaSession 的 Token 并创建 MediaController mediaBrowser.sessionToken.also { token -> mediaController = MediaControllerCompat(this@MainActivity, token).apply { // 将 Activity 的 MediaController 设置为全局，便于系统访问 MediaControllerCompat.setMediaController(this@MainActivity, this) } setupControllerCallback() updateUIFromController() } } override fun onConnectionSuspended() { // 连接暂时断开，应尝试重连 } override fun onConnectionFailed() { // 连接失败 } } override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) initViews() // 连接到 MediaBrowserService mediaBrowser = MediaBrowserCompat( this, ComponentName(this, PlayerService::class.java), connectionCallback, null // 可选：Bundle 参数 ) } override fun onStart() { super.onStart() mediaBrowser.connect() } override fun onStop() { super.onStop() // 断开连接，但播放服务仍在后台运行 MediaControllerCompat.getMediaController(this)?.unregisterCallback(controllerCallback) mediaBrowser.disconnect() } private fun initViews() { btnPlayPause = findViewById(R.id.btn_play_pause) btnNext = findViewById(R.id.btn_next) btnPrev = findViewById(R.id.btn_prev) seekBar = findViewById(R.id.seek_bar) tvTitle = findViewById(R.id.tv_title) tvArtist = findViewById(R.id.tv_artist) btnPlayPause.setOnClickListener { val controller = mediaController val playbackState = controller?.playbackState if (playbackState?.state == PlaybackStateCompat.STATE_PLAYING) { controller.transportControls.pause() } else { controller?.transportControls?.play() } } btnNext.setOnClickListener { mediaController?.transportControls?.skipToNext() } btnPrev.setOnClickListener { mediaController?.transportControls?.skipToPrevious() } seekBar.setOnSeekBarChangeListener(object : SeekBar.OnSeekBarChangeListener { override fun onProgressChanged(seekBar: SeekBar?, progress: Int, fromUser: Boolean) { if (fromUser) { mediaController?.transportControls?.seekTo(progress.toLong()) } } override fun onStartTrackingTouch(seekBar: SeekBar?) {} override fun onStopTrackingTouch(seekBar: SeekBar?) {} }) } private fun setupControllerCallback() { mediaController?.registerCallback(controllerCallback) // 启动一个协程来更新进度条 lifecycleScope.launch { while (true) { delay(1000) // 每秒更新一次 updateProgress() } } } private fun updateProgress() { mediaController?.let { controller -> val position = controller.playbackState?.position ?: 0L val duration = controller.metadata?.getLong(MediaMetadataCompat.METADATA_KEY_DURATION) ?: 0L runOnUiThread { if (duration > 0) { seekBar.max = duration.toInt() seekBar.progress = position.toInt() } } } } private fun updateUIFromController() { mediaController?.let { controller -> val metadata = controller.metadata val playbackState = controller.playbackState runOnUiThread { tvTitle.text = metadata?.getString(MediaMetadataCompat.METADATA_KEY_TITLE) ?: "未知标题" tvArtist.text = metadata?.getString(MediaMetadataCompat.METADATA_KEY_ARTIST) ?: "未知艺术家" // 更新播放/暂停按钮图标 val isPlaying = playbackState?.state == PlaybackStateCompat.STATE_PLAYING btnPlayPause.text = if (isPlaying) "暂停" else "播放" } } } private val controllerCallback = object : MediaControllerCompat.Callback() { override fun onMetadataChanged(metadata: android.support.v4.media.MediaMetadataCompat?) { updateUIFromController() } override fun onPlaybackStateChanged(state: PlaybackStateCompat?) { updateUIFromController() } // 会话被销毁（如服务停止） override fun onSessionDestroyed() { // 处理会话结束 } } }

4.5 运行与验证

启动应用：运行应用，主界面应显示播放控件。
点击播放：点击播放按钮，音乐应开始播放。此时即使按 Home 键退出应用，音乐也应继续。
查看通知栏：下拉通知栏，应该能看到一个带有“音乐播放器”标题的通知。注意：我们当前构建的通知还没有媒体控制按钮，下一步优化。
锁屏控制：锁屏后，在锁屏界面上应该能看到播放信息（取决于手机系统和版本）。
进程清理测试：在开发者选项中打开“不保留活动”或手动划掉应用，音乐播放应该继续，因为服务是前台服务。

5. 优化：实现功能完整的媒体通知

系统提供的MediaStyle通知可以自动从MediaSession获取信息并生成带控制按钮的通知。在PlayerService中，我们可以使用 Media3 库提供的MediaNotification.Provider来简化这一过程。

首先，更新PlayerService的buildNotification方法，或者更佳实践是使用 Media3 的MediaSessionService内置的通知管理。

使用 Media3 的默认通知提供器：

修改PlayerService的onCreate和buildNotification逻辑。实际上，MediaSessionService已经内置了与MediaSession关联的通知管理。我们需要做的是配置一个MediaNotification.Provider。

一个更完整的实现方式是自定义一个MediaNotification.Provider，但为了快速上手，我们可以使用默认的MediaNotification.Provider并启动前台服务。

// 在 PlayerService 中更新 import androidx.media3.session.DefaultMediaNotificationProvider import androidx.media3.session.MediaNotification class PlayerService : MediaSessionService() { // ... 其他代码不变 ... private lateinit var mediaNotification: MediaNotification override fun onCreate() { super.onCreate() createNotificationChannel() initializePlayerAndSession() initializeMediaNotification() } private fun initializeMediaNotification() { // 1. 创建一个 MediaNotification.Provider val notificationProvider = DefaultMediaNotificationProvider.Builder(this).build() // 2. 从 MediaSession 构建 MediaNotification mediaNotification = notificationProvider.createNotification( mediaSession, MediaNotification.Provider.DEFAULT_NOTIFICATION_ID // 通常使用一个常量ID ) } override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int { // 使用 MediaNotification 的 notification 作为前台通知 startForeground( mediaNotification.notificationId, mediaNotification.notification ) return START_STICKY } // 当 MediaSession 回调要求更新通知时调用 override fun onUpdateNotification(session: MediaSession, startInForegroundRequired: Boolean) { if (startInForegroundRequired) { // 如果需要前台服务，则更新通知 val updatedNotification = mediaNotification.notification // Media3 内部会更新通知内容，我们只需要重新调用 startForeground // 注意：这里需要根据 Media3 版本调整，高版本可能自动处理 // 一种简单方式是重新创建 MediaNotification initializeMediaNotification() startForeground(mediaNotification.notificationId, mediaNotification.notification) } else { // 如果不需要前台，则更新通知即可 notificationManager.notify(mediaNotification.notificationId, mediaNotification.notification) } } // ... onDestroy 等其他方法 ... }

关键点：DefaultMediaNotificationProvider会根据MediaSession的播放状态和元数据，自动生成一个符合 Android 设计规范的媒体通知，包含专辑图、歌曲名、艺术家、播放/暂停、上一首/下一首按钮，并且这些按钮的控制命令会自动发送到你的MediaSession。

6. 常见问题与排查思路

在实现后台播放和媒体通知时，开发者常会遇到以下问题：

问题现象	可能原因	排查步骤与解决方案
应用退到后台后播放立即停止	1. 播放器在`Activity`中创建，生命周期绑定。 2.`Service`未正确设置为前台服务，被系统回收。	1. 确保播放逻辑在`Service`（如`MediaBrowserService`）中。 2. 在`Service`的`onStartCommand`中调用`startForeground`并提供一个持续的通知。
通知栏没有显示或没有控制按钮	1. 未创建通知渠道（Android 8.0+）。 2. 通知未使用`MediaStyle`或未与`MediaSession`关联。 3. 通知的`priority`或`visibility`设置不正确。	1. 在`Service`启动时创建`NotificationChannel`。 2. 使用`Media3`的`DefaultMediaNotificationProvider`或`androidx.media.app.NotificationCompat.MediaStyle`来构建通知。 3. 确保通知设置了`setVisibility(NotificationCompat.VISIBILITY_PUBLIC)`。
锁屏界面不显示播放控件	1. 手机系统或锁屏设置禁用了媒体控件。 2. 通知的可见性未设置为`VISIBILITY_PUBLIC`。 3.`MediaSession`的`PlaybackState`和`Metadata`未正确更新。	1. 检查系统设置。 2. 确认通知构建时调用了`setVisibility(NotificationCompat.VISIBILITY_PUBLIC)`。 3. 确保`MediaSession.setCallback`已设置，并且播放器状态变化时通过`MediaSessionCompat.Callback`更新了`setPlaybackState`和`setMetadata`。
点击通知栏按钮无反应	1.`PendingIntent`未正确关联到`MediaSession`。 2.`MediaSession.Callback`未正确实现或未处理相应动作。	1. 如果使用`MediaStyle`，确保在`setMediaSession`方法中传入了`MediaSessionCompat.Token`。 2. 检查`MediaSession.Callback`的`onPlay`,`onPause`等方法是否被调用，并正确转发给了播放器。
连接 Service 失败	1.`AndroidManifest.xml`中未正确声明`Service`或`intent-filter`。 2.`MediaBrowser`连接的`ComponentName`不正确。	1. 检查`AndroidManifest.xml`，确保`Service`声明中包含`<action android:name="androidx.media3.session.MediaSessionService" />`。 2. 确认`ComponentName`的参数是`PlayerService::class.java`。
播放网络音频失败	1. 未申请`INTERNET`权限。 2. 网络链接问题或音频链接失效。 3.`ExoPlayer`未添加相应的数据源扩展（如`media3-exoplayer-hls`用于 HLS 流）。	1. 在`AndroidManifest.xml`中添加`<uses-permission android:name="android.permission.INTERNET" />`。 2. 检查音频 URL 是否有效。 3. 根据音频格式添加对应的`media3-exoplayer-*`依赖。

7. 最佳实践与工程建议

实现一个健壮的后台音乐播放器，除了核心功能，还需要考虑以下工程化细节：

生命周期管理：
- 服务启动策略：考虑使用startService还是bindService。通常音乐播放器采用“启动并绑定”模式，确保没有 UI 绑定时服务也能运行。
- 进程死亡恢复：在onStartCommand中返回START_STICKY，使服务被系统杀死后能重启。重启后应尝试恢复之前的播放状态（播放位置、播放列表等），这需要将状态持久化到SharedPreferences或数据库中。
音频焦点管理：
- 当其他应用（如电话、导航）需要播放声音时，你的应用应该暂停播放。使用AudioManager.requestAudioFocus来获取音频焦点，并在OnAudioFocusChangeListener中根据焦点变化调整播放行为（如短暂失去焦点时降低音量，永久失去焦点时暂停）。
耳机和蓝牙控制：
- MediaSession框架已经很好地支持了蓝牙设备的多媒体按键。确保你的MediaSession.Callback正确响应ACTION_PLAY,ACTION_PAUSE,ACTION_SKIP_TO_NEXT,ACTION_SKIP_TO_PREVIOUS等标准命令。
- 监听耳机插拔事件，拔掉耳机时自动暂停播放。
通知栏优化：
- 自定义通知布局：如果默认样式不满足需求，可以自定义通知布局，但务必通过MediaSession来更新播放状态，保证系统控件的一致性。
- 添加自定义动作：可以在通知上添加“喜欢”、“收藏”等自定义按钮，通过在构建通知时添加PendingIntent来实现，并在BroadcastReceiver或Service中处理。
错误处理与重试：
- ExoPlayer提供了丰富的监听器（Player.Listener），要监听onPlayerError事件，并根据错误类型（如网络错误、解码错误）给用户友好的提示或自动重试。
电量优化：
- 使用WakeLock时要谨慎，只在播放时持有，暂停或停止时释放。
- 考虑使用WorkManager或JobScheduler来管理非即时性的任务，如下载播放列表。
测试：
- 后台播放测试：反复切换应用、锁屏、清理后台进程，验证播放是否持续。
- 通知栏测试：验证所有按钮功能是否正常。
- 音频焦点测试：播放音乐时，接打电话或启动其他音乐应用，检查行为是否符合预期。
- 设备兼容性测试：在不同品牌、不同 Android 版本的设备上测试，特别是通知栏和锁屏控件的显示。