---

在移动应用开发中，音频播放是一个常见需求。特别是在本地音乐播放场景中，开发者常常会遇到格式兼容性差、内存泄漏和播放卡顿等问题。本文将详细介绍如何使用 ExoPlayer 实现高效稳定的本地音乐播放功能。

1. 背景与痛点

在开发本地音乐播放器时，我们通常会遇到以下几个问题：

• 格式兼容性：不同设备对音频格式的支持程度不一，导致部分文件无法播放
• 内存管理：长时间播放时容易出现内存泄漏
• 播放流畅性：大文件或高码率音频容易出现卡顿
• 功能扩展性：难以实现高级功能如变速播放、音效处理等

2. 技术选型：ExoPlayer vs MediaPlayer

Android 提供了 MediaPlayer API，但 ExoPlayer 作为 Google 推出的开源播放器库，具有明显优势：

• 支持更多音频格式和协议
• 高度可定制化
• 更好的性能和稳定性
• 持续更新维护

对于本地音乐播放场景，ExoPlayer 是更优的选择。

3. 核心实现步骤

3.1 添加依赖

在 build.gradle 中添加 ExoPlayer 依赖：

implementation 'com.google.android.exoplayer:exoplayer:2.18.1'

3.2 初始化播放器

val player = ExoPlayer.Builder(context).build()

3.3 设置数据源

val dataSourceFactory = DefaultDataSource.Factory(context)
val mediaItem = MediaItem.fromUri(localFileUri)
player.setMediaItem(mediaItem)
player.prepare()

3.4 播放控制

player.play()  // 开始播放
player.pause() // 暂停
player.stop()  // 停止
player.seekTo(position) // 跳转到指定位置

4. 完整代码示例

class MusicPlayerActivity : AppCompatActivity() {
    private lateinit var player: ExoPlayer

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_player)

        // 初始化播放器
        player = ExoPlayer.Builder(this).build()
        audioPlayerView.player = player

        // 设置数据源
        val musicFile = File(getExternalFilesDir(null), "music.mp3")
        val mediaItem = MediaItem.fromUri(Uri.fromFile(musicFile))
        player.setMediaItem(mediaItem)
        player.prepare()
    }

    override fun onDestroy() {
        super.onDestroy()
        player.release() // 释放播放器资源
    }
}

5. 性能优化

5.1 缓冲策略

val loadControl = DefaultLoadControl.Builder()
    .setBufferDurationsMs(
        MIN_BUFFER_MS, // 最小缓冲时间
        MAX_BUFFER_MS, // 最大缓冲时间
        BUFFER_FOR_PLAYBACK_MS, // 开始播放时的缓冲时间
        BUFFER_FOR_PLAYBACK_AFTER_REBUFFER_MS // 重新缓冲后的缓冲时间
    ).build()

val player = ExoPlayer.Builder(context)
    .setLoadControl(loadControl)
    .build()

5.2 内存优化

• 及时释放不再使用的播放器实例
• 避免在短时间内创建多个播放器实例
• 使用弱引用持有播放器

5.3 功耗管理

• 在后台播放时使用前台服务
• 合理设置音频焦点
• 根据设备状态调整播放参数

6. 避坑指南

6.1 权限处理

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

6.2 文件路径解析

// 正确处理不同Android版本的文件路径
val uri = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
    MediaStore.Audio.Media.getContentUri(MediaStore.VOLUME_EXTERNAL)
} else {
    Uri.fromFile(File(Environment.getExternalStorageDirectory(), "Music"))
}

6.3 常见问题

• 播放器状态监听要全面
• 正确处理音频焦点变化
• 注意不同设备上的行为差异

7. 扩展功能

你可以尝试实现以下功能来增强播放器：

• 播放列表管理
• 音频可视化
• 均衡器设置
• 睡眠定时器

欢迎在评论区分享你的实现经验和成果！

通过本文的介绍，相信你已经掌握了使用 ExoPlayer 实现本地音乐播放的核心技术。在实际开发中，记得根据具体需求调整实现细节，并持续关注 ExoPlayer 的更新，以获得更好的播放体验。