Android MediaPlayer 基础简介

一、MediaPlayer 核心概念与定位

Android MediaPlayer 是 Android SDK 提供的核心多媒体播放框架，用于处理音频、视频文件的解码与播放。其设计遵循”轻量级、可扩展”原则，支持本地文件（SD卡/Assets）、网络流媒体（HTTP/RTSP）及内容提供者（Content Provider）等多种数据源。作为系统级组件，MediaPlayer 封装了底层多媒体引擎（如Stagefright/MediaCodec），开发者无需直接操作硬件即可实现跨设备兼容的播放功能。

1.1 架构解析

MediaPlayer 采用”状态机”设计模式，其生命周期包含以下关键状态：

Idle：初始状态，通过create()或reset()进入
Initialized：完成数据源设置后的状态
Prepared：调用prepare()或prepareAsync()后进入，可安全启动播放
Started：调用start()后进入，实际播放状态
Paused/Stopped：通过pause()/stop()切换
PlaybackCompleted：播放结束自动触发
Error：发生错误时进入

状态转换需严格遵循时序，例如从Idle直接调用start()会抛出IllegalStateException。

二、基础使用流程

2.1 典型使用步骤

// 1. 创建MediaPlayer实例
MediaPlayer mediaPlayer = new MediaPlayer();
// 2. 设置数据源（以网络流为例）
try {
    mediaPlayer.setDataSource("https://example.com/audio.mp3");
} catch (IOException e) {
    e.printStackTrace();
}
// 3. 异步准备（推荐）
mediaPlayer.prepareAsync();
mediaPlayer.setOnPreparedListener(new MediaPlayer.OnPreparedListener() {
    @Override
    public void onPrepared(MediaPlayer mp) {
        mp.start(); // 准备完成后自动播放
    }
});
// 4. 设置监听器
mediaPlayer.setOnCompletionListener(mp -> {
    // 播放完成回调
});
mediaPlayer.setOnErrorListener((mp, what, extra) -> {
    // 错误处理
    return true;
});

2.2 关键方法详解

setDataSource()：支持三种重载形式

setDataSource(String path) // 文件路径或网络URL
setDataSource(FileDescriptor fd) // 文件描述符
setDataSource(Context context, Uri uri) // 通过URI指定

prepare() vs prepareAsync()：同步准备会阻塞UI线程，大文件必须使用异步方式
seekTo(int msec)：精确跳转到指定位置（毫秒），需在Prepared状态调用

三、高级功能实现

3.1 播放控制增强

// 循环播放设置
mediaPlayer.setLooping(true);
// 音量控制（0.0-1.0）
mediaPlayer.setVolume(0.8f, 0.8f);
// 播放速度控制（API 23+）
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
    PlaybackParams params = new PlaybackParams();
    params.setSpeed(1.5f); // 1.5倍速
    mediaPlayer.setPlaybackParams(params);
}

3.2 缓冲策略优化

对于网络流媒体，建议：

设置缓冲大小（setBufferingParams()）
监听缓冲进度（OnBufferingUpdateListener）
实现预加载机制

mediaPlayer.setBufferingUpdateListener((mp, percent) -> {
    Log.d("Buffer", "Buffered: " + percent + "%");
});

四、常见问题解决方案

4.1 状态异常处理

问题：调用start()时抛出IllegalStateException
原因：未完成prepare流程或已释放资源
解决方案：

try {
    if (mediaPlayer != null && 
        (mediaPlayer.isPlaying() || mediaPlayer.isInPreparedState())) {
        mediaPlayer.start();
    }
} catch (IllegalStateException e) {
    // 重新初始化播放器
    initMediaPlayer();
}

4.2 内存泄漏防范

在Activity/Fragment的onDestroy()中：

if (mediaPlayer != null) {
    mediaPlayer.stop();
    mediaPlayer.release();
    mediaPlayer = null;
}

使用WeakReference持有MediaPlayer引用

4.3 格式兼容性问题

推荐编码格式：

音频：MP3、AAC、OGG、WAV
视频：H.264 AVC、MPEG-4 SP、VP8

检测支持格式：

MediaCodecList codecList = new MediaCodecList(MediaCodecList.ALL_CODECS);
MediaCodecInfo[] codecInfos = codecList.getCodecInfos();
// 遍历检查支持的MIME类型

五、性能优化建议

硬件解码优先：通过setHardwareAccelerated(true)启用（需设备支持）
线程管理：将prepare操作放在子线程执行
资源复用：对于重复播放场景，保持MediaPlayer实例而非频繁创建销毁
电量优化：在屏幕关闭时暂停播放（监听ACTION_SCREEN_OFF广播）

六、替代方案对比

特性	MediaPlayer	ExoPlayer	SoundPool
复杂度	低	高	中
格式支持	有限	全面	仅限短音频
缓冲控制	基础	精细	无
适用场景	简单播放	流媒体/自适应码率	游戏音效

选择建议：

简单本地播放：MediaPlayer
网络流媒体/复杂需求：ExoPlayer
短音效播放：SoundPool

七、最佳实践总结

生命周期管理：严格遵循Activity/Fragment生命周期回调
错误处理：实现完整的OnErrorListener处理链
状态监控：通过监听器跟踪播放状态变化
资源释放：在不再需要时立即调用release()
兼容性测试：覆盖不同Android版本和设备类型

通过系统掌握MediaPlayer的核心机制和优化技巧，开发者能够构建出稳定、高效的多媒体应用。对于更复杂的需求（如自适应码率、DRM保护等），建议进一步研究ExoPlayer等高级解决方案。

深入解析：Android MediaPlayer 基础与应用指南