React Native从外部存储获取音乐文件的实现方案求助

一、推荐可用的第三方库 #

• react-native-media-metadata-retriever：轻量稳定，支持读取本地音频文件的标题、艺术家、专辑等元数据，适配React Native新版本，安装命令：

  npm install react-native-media-metadata-retriever --save
  # RN 0.60+自动链接，iOS需额外执行
  cd ios && pod install && cd ..
  

• react-native-fs：适合需要底层文件操作的场景，可遍历外部存储的指定目录，搭配元数据解析工具使用，安装命令：

  npm install react-native-fs --save
  

二、手动实现（无第三方库基础方案） #

针对Android平台，可通过原生模块调用MediaStore API获取音乐文件：

1. 在AndroidManifest.xml添加权限：

   <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
   <!-- Android 13+ 需补充媒体权限 -->
   <uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />
   

2. 创建原生Module，编写查询MediaStore的代码，将结果转为JSON返回给RN端：

   // Android原生代码片段示例
   Cursor cursor = getContentResolver().query(
       MediaStore.Audio.Media.EXTERNAL_CONTENT_URI,
       new String[]{MediaStore.Audio.Media.TITLE, MediaStore.Audio.Media.ARTIST, MediaStore.Audio.Media.DATA},
       null,
       null,
       MediaStore.Audio.Media.TITLE + " ASC"
   );
   // 解析cursor数据为JSON数组后返回RN
   

3. 在RN端调用原生Module，解析返回数据并渲染音乐列表。

三、解决react-native-get-music-files安装错误的常见方法 #

1. 核对版本兼容性：该库可能不支持你当前的RN版本，查看库文档确认支持范围，尝试安装指定版本：

   npm install react-native-get-music-files@指定版本号 --save
   

2. 清理缓存后重装：

   npm cache clean --force
   rm -rf node_modules package-lock.json
   npm install
   

3. Android手动链接：若自动链接失败，手动修改settings.gradle和build.gradle添加依赖（步骤参考库安装文档）。
4. 检查SDK版本：确保本地Android SDK版本符合库的要求，更新对应SDK后重试。

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