AndroidMediaPlayer循环播放设置方法

本文深入讲解了在 Android 中利用 MediaPlayer 实现音频循环播放的完整方案，既涵盖单文件基础循环（关键在于 prepare 后、start 前调用 setLooping(true)）的正确写法与常见陷阱，也扩展出自动扫描 Download 目录所有 MP3 并顺序循环播放的实用逻辑；同时强调权限适配（尤其 Android 10+）、线程安全、资源释放和用户体验优化等生产级最佳实践，帮助开发者避开 IllegalStateException、缓冲异常、内存泄漏等高频问题，轻松构建稳定、灵活、用户友好的音频播放功能。

本文详解如何使用 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 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 中添加 （目标 SDK ≥ 33）；旧版本使用 READ_EXTERNAL_STORAGE。
• 线程安全：MediaPlayer 方法非线程安全，所有调用应在同一线程（通常为主线程）执行。
• 资源释放：Activity 销毁时务必调用 mediaPlayer.release() 并置空引用，防止内存泄漏。
• 用户体验：建议配合 SeekBar 实时更新进度，并监听 OnInfoListener 处理缓冲等事件。

通过合理组合 setLooping(true) 与自定义播放队列逻辑，即可灵活实现从单曲无缝循环到多曲智能轮播的完整音频播放体验。

以上就是《AndroidMediaPlayer循环播放设置方法》的详细内容，更多关于的资料请关注golang学习网公众号！