本文详细介绍在 android 中使用 mediaplayer 实现音频循环播放的完整方法，包括设置数据源、异步准备、启用循环模式及批量处理本地 mp3 文件的实用技巧，并附关键代码示例与注意事项。
在 Android 开发中，MediaPlayer 是播放音频的核心组件。若需实现单曲循环（如背景音乐、提示音），关键在于正确配置数据源后启用循环模式，而非依赖手动重复调用 start()。以下为专业、健壮的实现方案。
✅ 基础循环播放（单文件）
首先确保已正确初始化 MediaPlayer 并设置有效路径（支持本地文件 URI 或网络 URL）：
MediaPlayer mediaPlayer = new MediaPlayer();
String audioPath = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS)
+ "/example.mp3"; // 示例：下载目录下的 MP3
try {
mediaPlayer.reset(); // 推荐在复用时调用，确保状态干净
mediaPlayer.setDataSource(audioPath);
mediaPlayer.prepare(); // 同步准备（适合小文件）；大文件建议用 prepareAsync() + OnPreparedListener
mediaPlayer.setLooping(true); // ? 核心：启用循环播放
mediaPlayer.start();
} catch (IOException e) {
Log.e("MediaPlayer", "Failed to set data source", e);
}⚠️ 注意：setLooping(true) 必须在 prepare()（或 prepareAsync() 完成后）之后、start() 之前调用，否则可能无效；且仅对单个媒体源生效。
? 批量读取指定目录下的所有 MP3 文件并循环播放
若需遍历下载目录（如 Downloads/）中所有 .mp3 文件并依次循环播放，推荐结合 File API 与 MediaMetadataRetriever 获取元信息，并使用队列管理：
private void loadAndPlayMp3FromDirectory() {
File downloadDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS);
File[] mp3Files = downloadDir.listFiles(file -> file.getName().toLowerCase().endsWith(".mp3"));
if (mp3Files == null || mp3Files.length == 0) {
Toast.makeText(this, "未找到 MP3 文件", Toast.LENGTH_SHORT).show();
return;
}
// 示例：播放第一个 MP3 并循环
String firstMp3Path = mp3Files[0].getAbsolutePath();
try {
mediaPlayer.reset();
mediaPlayer.setDataSource(firstMp3Path);
mediaPlayer.prepare();
mediaPlayer.setLooping(true);
mediaPlayer.start();
// 可选：显示总时长
textTotalDuration.setText(milliSecondsToTimer(mediaPlayer.getDuration()));
} catch (Exception e) {
Log.e("MediaPlayer", "加载失败", e);
}
}
// 工具方法：毫秒转 MM:SS 格式
private String milliSecondsToTimer(long milliseconds) {
int seconds = (int) (milliseconds / 1000);
int minutes = seconds / 60;
seconds = seconds % 60;
return String.format("%02d:%02d", minutes, seconds);
}?️ 关键注意事项与最佳实践
-
权限声明：读取外部存储需在 AndroidManifest.xml 中声明：
Android 10+ 建议使用 Scoped Storage 或 MediaStore API 替代直接文件路径访问。
android rtsp流媒体播放介绍 中文WORD版下载本文档主要讲述的是android rtsp流媒体播放介绍；实时流协议（RTSP）是应用级协议，控制实时数据的发送。RTSP提供了一个可扩展框架，使实时数据，如音频与视频，的受控、点播成为可能。数据源包括现场数据与存储在剪辑中数据。该协议目的在于控制多个数据发送连接，为选择发送通道，如UDP、组播UDP与TCP，提供途径，并为选择基于RTP上发送机制提供方法。希望本文档会给有需要的朋友带来帮助；感兴趣的朋友可以过来看看
-
生命周期管理：务必在 Activity.onDestroy() 或 Fragment.onDetach() 中释放资源：
if (mediaPlayer != null) { mediaPlayer.release(); mediaPlayer = null; } -
异步准备更安全：对较大音频文件，优先使用 prepareAsync() 配合监听器，避免主线程阻塞：
mediaPlayer.setOnPreparedListener(mp -> { mp.setLooping(true); mp.start(); }); mediaPlayer.prepareAsync(); 错误处理不可省略：setDataSource() 和 prepare() 均抛出受检异常，必须捕获并妥善处理，否则导致崩溃。
掌握 setLooping(true) 这一轻量级接口，配合规范的资源管理与路径处理逻辑，即可高效实现稳定、可维护的循环音频播放功能。
