如何在 Android 中实现 MediaPlayer 循环播放音频

本文详解如何使用 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 文件并实现“列表循环”（即播完最后一首后回到第一首），需自行管理播放队列：

android rtsp流媒体播放介绍 中文WORD版

本文档主要讲述的是android rtsp流媒体播放介绍；实时流协议（RTSP）是应用级协议，控制实时数据的发送。RTSP提供了一个可扩展框架，使实时数据，如音频与视频，的受控、点播成为可能。数据源包括现场数据与存储在剪辑中数据。该协议目的在于控制多个数据发送连接，为选择发送通道，如UDP、组播UDP与TCP，提供途径，并为选择基于RTP上发送机制提供方法。希望本文档会给有需要的朋友带来帮助；感兴趣的朋友可以过来看看

下载

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) 与自定义播放队列逻辑，即可灵活实现从单曲无缝循环到多曲智能轮播的完整音频播放体验。