本文详解如何使用 android mediaplayer 实现单音频循环播放，并扩展支持指定目录（如 download 文件夹）中所有 mp3 文件的遍历与自动循环播放，涵盖数据源设置、异步准备、状态管理及常见坑点。
在 Android 开发中，MediaPlayer 是处理本地或网络音频播放的核心类。若需实现单曲循环播放（如背景音乐、提示音），关键在于调用 setLooping(true) —— 该方法必须在 prepare() 或 prepareAsync() 完成后、start() 之前设置，否则无效。
✅ 基础循环播放（单文件）
MediaPlayer mediaPlayer = new MediaPlayer();
String audioPath = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS)
+ "/sample.mp3";
try {
mediaPlayer.reset(); // 推荐重置以确保干净状态
mediaPlayer.setDataSource(audioPath);
mediaPlayer.prepare(); // 同步准备（主线程慎用，大文件建议 prepareAsync）
mediaPlayer.setLooping(true); // ? 核心：启用循环
mediaPlayer.start();
} catch (IOException e) {
e.printStackTrace();
Toast.makeText(this, "播放准备失败", Toast.LENGTH_SHORT).show();
}⚠️ 注意事项：setLooping(true) 对网络流媒体同样有效，但需确保服务端支持范围请求（Range Requests）；若使用 prepareAsync()，务必在 OnPreparedListener 回调中调用 setLooping(true) 和 start()；reset() 可避免复用 MediaPlayer 实例时因状态残留导致的异常（如 IllegalStateException）。
? 扩展：遍历指定目录下所有 MP3 并顺序循环播放
若需自动扫描 Download 目录中的全部 .mp3 文件并实现“列表循环”（即播完最后一首后回到第一首），需自行管理播放队列：
private List<String> mp3Paths = new ArrayList<>();
private int currentIndex = 0;
private MediaPlayer mediaPlayer;
private void loadAndPlayAllMP3s() {
File downloadDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS);
if (!downloadDir.exists()) return;
File[] files = downloadDir.listFiles(file -> file.getName().toLowerCase().endsWith(".mp3"));
if (files == null || files.length == 0) return;
mp3Paths.clear();
for (File file : files) {
mp3Paths.add(file.getAbsolutePath());
}
if (!mp3Paths.isEmpty()) {
playCurrentTrack();
}
}
private void playCurrentTrack() {
if (mediaPlayer == null) {
mediaPlayer = new MediaPlayer();
mediaPlayer.setOnCompletionListener(mp -> {
currentIndex = (currentIndex + 1) % mp3Paths.size(); // 循环索引
playCurrentTrack(); // 播放下一首
});
}
try {
mediaPlayer.reset();
mediaPlayer.setDataSource(mp3Paths.get(currentIndex));
mediaPlayer.prepare();
mediaPlayer.start();
} catch (Exception e) {
e.printStackTrace();
Toast.makeText(this, "播放失败：" + e.getMessage(), Toast.LENGTH_SHORT).show();
}
}? 最佳实践总结
- 权限声明：Android 10+ 需在 AndroidManifest.xml 中添加 <uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />（目标 SDK ≥ 33）；旧版本使用 READ_EXTERNAL_STORAGE。
- 线程安全：MediaPlayer 方法非线程安全，所有调用应在同一线程（通常为主线程）执行。
- 资源释放：Activity 销毁时务必调用 mediaPlayer.release() 并置空引用，防止内存泄漏。
- 用户体验：建议配合 SeekBar 实时更新进度，并监听 OnInfoListener 处理缓冲等事件。
通过合理组合 setLooping(true) 与自定义播放队列逻辑，即可灵活实现从单曲无缝循环到多曲智能轮播的完整音频播放体验。
