Android保存MP3到外部存储后音乐播放器无法识别问题咨询

你遇到的音乐播放器无法识别下载的MP3文件，核心原因是媒体扫描广播的文件路径构造错误，还有几个潜在的兼容性问题，修复方案如下：

1. 核心错误：扫描路径构造错误 #

看DownloadVideoAsyn类的onPostExecute方法，手动拼接的Uri完全错误：

// 错误写法
Uri uri = Uri.parse("file://" + "/storage/emulated/0/FreeMusic/" + s);

变量s本身已经返回PATH + title + ".mp3"，而PATH就是/storage/emulated/0/FreeMusic/，拼接后路径会重复，变成file:///storage/emulated/0/FreeMusic//storage/emulated/0/FreeMusic/xxx.mp3，属于无效路径，媒体扫描器找不到正确的文件就不会入库，音乐播放器自然扫不到。

修复代码 #

直接用File生成Uri即可，避免手动拼接出错：

@Override
protected void onPostExecute(String s) {
    super.onPostExecute(s);
    if (s != null) {
        // 修正：直接从文件路径生成Uri
        File musicFile = new File(s);
        Uri uri = Uri.fromFile(musicFile);
        Intent scanFileIntent = new Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE, uri);
        mContext.sendBroadcast(scanFileIntent);
        callBack.downloadVideoFinish(s);
    } else {
        callBack.downloadVideoFail("Error");
    }
}

2. 兼容优化：用MediaScannerConnection代替广播 #

部分国产定制ROM对全局广播做了限制，ACTION_MEDIA_SCANNER_SCAN_FILE广播可能不生效，更稳妥的方案是用MediaScannerConnection主动通知媒体库：

// 替换原来的发广播逻辑
MediaScannerConnection.scanFile(mContext,
        new String[]{musicFile.getAbsolutePath()},
        new String[]{"audio/mp3"},
        null);

3. 高版本安卓适配（targetSdk>=29） #

如果你的应用适配了Android 10（API29）及以上版本，Environment.getExternalStorageDirectory()已经被废弃，默认开启的分区存储会导致你写入的文件其他应用（比如音乐播放器）没有访问权限，建议做如下适配：

• 下载的音乐文件存到公共音乐目录，通过MediaStoreAPI写入，不需要申请存储权限就能被其他应用识别
• 如果你暂时不想适配分区存储，可以临时在AndroidManifest.xml的application节点加android:requestLegacyExternalStorage="true"（仅在Android10上生效，Android11及以上还是需要适配分区存储）

4. 其他注意事项 #

• 文件名要过滤特殊字符：除了'之外，还要过滤文件名中不允许的/ \ : * ? " < > |等字符，避免文件创建失败或者媒体库识别异常
• 删文件时也要同步通知媒体库：现有删除逻辑只删了本地文件，没有删除媒体库中的对应记录，会导致音乐播放器出现无效条目，删除后也要调用上面的扫描逻辑通知媒体库更新

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