MediaPlayer下载完整文件而非流式播放：Flask后端HTTP音频流适配问题

核心原因 #

• 当前使用同步prepare()方法，该方法会阻塞直到MediaPlayer拉取到足够播放的数据（极端场景下会拉取完整文件）才返回，表现为全量下载完成后才开始播放
• 原生MediaPlayer仅在确认服务端支持字节范围请求时，才会主动发送带Range头的分片请求获取206响应，实现边下边播；若服务端配置不符合要求，MediaPlayer会默认全量拉取资源，返回200状态码
• 无格式后缀的请求路径会导致部分版本的MediaPlayer无法正确识别资源类型，主动禁用分片请求逻辑

修复步骤 #

1. 替换同步准备为异步准备 #

将代码中的同步prepare()替换为异步prepareAsync()，在OnPreparedListener回调中触发播放，避免阻塞等待全量资源：

String url = "http://localhost:5000/song";
MediaPlayer mediaPlayer = new MediaPlayer();
mediaPlayer.setAudioAttributes(
    new AudioAttributes.Builder()
        .setContentType(AudioAttributes.CONTENT_TYPE_MUSIC)
        .setUsage(AudioAttributes.USAGE_MEDIA)
        .build()
);
// 注册准备完成监听器，准备完成后自动播放
mediaPlayer.setOnPreparedListener(mp -> mp.start());
mediaPlayer.setDataSource(url);
// 替换原来的同步prepare()
mediaPlayer.prepareAsync();

2. 校验服务端响应配置 #

确保服务端返回的音频资源响应头包含以下字段：

• Accept-Ranges: bytes：明确告知客户端支持字节范围请求
• Content-Length：返回音频文件的总大小，不能使用Transfer-Encoding: chunked无固定长度的响应格式
• Content-Type：返回和音频格式匹配的MIME类型，比如wav对应audio/wav、m4a对应audio/mp4

3. 适配请求路径格式 #

可尝试给请求地址增加对应音频格式的后缀，例如修改为http://localhost:5000/song.wav，服务端做对应路径适配即可，可解决多数低版本系统MediaPlayer的识别问题。

兼容优化方案 #

如果调整后仍存在多版本兼容问题，可改用Jetpack官方推出的ExoPlayer，其对HTTP流式播放的支持更完善，默认自带分片请求逻辑，适配性远优于原生MediaPlayer。

内容的提问来源于stack exchange，提问作者TruthShield