注意事项

• 确保已经阅读过ReadMe并了解本软件的定位
• 确保你的新需求/想法合理合法，且不是因为无解决方案的众口难调导致的个例问题

需求描述
请详细描述一下需求场景，以及可能导致的问题；以及你预期的解决方案或效果

替代方案
如果无法实现，请描述一下预期的替代方案或最低期望

其他信息
是否能提供一些其他的帮助，包括但不限于代码、UI、测试 ... 如果有的话，辛苦描述一下，感谢~

非常感谢大神的musicfree，如果能够搜索喜马拉雅等听书资源 和 spotify 则万分大喜。

请问能加入歌曲自定义排序功能吗

1、希望增加个一个其他app歌单导入的功能
2、希望增加一个云盘备份歌单的功能
3、希望适配ipad之类的大屏设备
4、希望适配一下华为手机负一屏那个音乐软件识别的问题，现在在华为手机负一屏上不能识别咱们的播放软件

我将该app安装到我的华为pad上，发现样式完全乱套了，插件导入也不能使用，组件ui超出屏幕显示宽度等问题，不知道能不能兼容一下

可以改一下“tests”文件夹的名字吗？谷歌加载不了这插件因为根目录带下划线
抱歉，我还以为这是pc端的插件，打扰了

试用一下

作为一个移动端的本地播放器，希望支持 o · 有损界的冉冉新星 · 全能的瑞士军刀 · 省流助手与存储救星 · pus 格式。（.m4a 容器内的 xHE-AAC 都能播放，没理由不支持 opus 呀）

v0.0.1-alpha.12 现状是不能被扫描到，本地的也不能指定它来播放。

尝试了Q&A中的方法 始终为空。 还有就是QQ音乐现在的歌单似乎无法复制链接

1. 歌词界面请不要息屏
2. 希望增加桌面浮窗歌词显示

作者有考虑设计一个登录接口吗，考虑可能会有vip音乐需求的人（比如我

您好，请问可以和安卓的全面屏手势做一下适配吗，每次打开软件，界面最底下有小白条，看着很难受，谢谢

如果在设置里将 ‘使用移动网络播放’功能关闭，然后选择播放下载的本地音乐，一旦手机有别的消息弹出，音乐会终止播放，不会自动播放，点继续播放会提示无法播放，要重新换一首本地音乐重新播放才能继续听歌。

为什么无法下载了，上一个版本可以下载，这一个版本无法下载

注意事项

• 确保已经阅读过ReadMe并了解本软件的定位
• 确保你的新需求/想法合理合法，且不是因为无解决方案的众口难调导致的个例问题

需求描述
在win11的安卓子系统下使用，APP分辨率不能自适应。希望能自适应下分辨率。可以参考头条APP

Musicfree：

今日头条：

在鸿蒙下拉的控制中心中，音频控制中心无法显示并控制音乐

注意事项

• 确保该bug可能是软件的本身问题，不是由于插件导致（如搜索结果不全，无法导入等都属于插件问题）；如果是插件问题请去对应第三方插件仓库提issue。
• 确保已经搜索过issue区，并阅读过QA

问题描述
Mac 桌面版，打开桌面歌词后，歌词翻滚时历史歌词与现歌词会产生重合

详细的复现步骤
打开桌面歌词，播放歌曲

预期行为
歌词正常显示

截图

其他信息:

• OS: Mac OS M1
• 版本号 13.3.1 (22E261)

如题，能不能在插件中增加推荐歌单功能，有什么不知道听啥只想去推荐歌单里面听。但是没有推荐歌单

注意事项

• 确保已经阅读过ReadMe并了解本软件的定位
• 确保你的新需求/想法合理合法，且不是因为无解决方案的众口难调导致的个例问题

需求描述
请详细描述一下需求场景，以及可能导致的问题；以及你预期的解决方案或效果

替代方案
如果无法实现，请描述一下预期的替代方案或最低期望

其他信息
是否能提供一些其他的帮助，包括但不限于代码、UI、测试 ... 如果有的话，辛苦描述一下，感谢~

如题，车有点老旧，找了很多开源播放器都没有适配4.4的，这里求一个适配

希望可以加上这么个功能保存个人下载的或者，个人歌单
尤其个人歌单同步，这样就算有版本改动或者软件新装也不受影响。辛苦作者了

注意事项

• [v] 确保已经阅读过ReadMe并了解本软件的定位
• [v] 确保你的新需求/想法合理合法，且不是因为无解决方案的众口难调导致的个例问题

需求描述
音乐软件的专辑页面和艺人热曲首页逻辑上也是一个歌单，而且是事实上常常被用户拿来直接循环的常用“歌单”。
但由于专辑和艺人页面的接口完全不同于技术意义上的歌单，所以目前插件没有支持

替代方案
目前想要实现相同效果唯有进入第一方软件然后批量制作和目标专辑/艺人hot50完全一样的dummy歌单，很不方便，也很麻烦。因为享用MF来作为集中了的歌单维护中心的话，再去各大app创建站位歌单其实比较折腾。

其他信息
album的接口我试着根据直觉改了一下，包括post和get的差别，url的差别，正则的差别，但始终无法成功。
我看了一下NeteaseNodeAPI那个项目，似乎album:POST接口的协议（至少返回体结构）可能和playlist:GET完全不同。本想着自己解决但是抱着app真的很难调试这些js，想着还是你们这边有完善的调试环境，所以先以issue ticket的形式爆出了。
一些其他类似的app也是偶有这个功能的，即比如识别专辑链接为一个逻辑歌单。确实并不是任何app都有支持，估计兼容协议并不是那么轻松吧。Just a thought。

希望能添加按文件夹显示的功能，本地文件已经把歌曲按照喜欢的分好类别在各个文件夹，扫描添加后可以按文件夹来听，谢谢

注意事项

• 确保已经阅读过ReadMe并了解本软件的定位
• 确保你的新需求/想法合理合法，且不是因为无解决方案的众口难调导致的个例问题

需求描述
请详细描述一下需求场景，以及可能导致的问题；以及你预期的解决方案或效果

替代方案
如果无法实现，请描述一下预期的替代方案或最低期望

其他信息
是否能提供一些其他的帮助，包括但不限于代码、UI、测试 ... 如果有的话，辛苦描述一下，感谢~

是不是苹果不让做

弄一个 Telegram 的群组呗，这样更保险。

增加导入酷狗歌单的支持

如题所述。
除了听音乐外，日常听小说和电台也很多，正常语速太慢了，希望能有倍速功能，感谢~

只有导入本地音乐选择文件夹时可以临时受权，失去焦点就会消失。也无法主动受权给APP。

注意事项

• 确保你的新需求/想法合理合法，且不是因为无解决方案的众口难调导致的个例问题
• 确保已经阅读过ReadMe并了解本软件的定位

需求描述
希望可以按歌曲、专辑、歌手等不同形式进行分类，使用不同的tab进行不同类别的分页，下面按字典顺序排列相应的歌曲，右侧如果能带有一个可按字母定位的索引会更方便一些

其他信息
示例ui如图所示：

如图所示，左侧的歌曲编号显示部分不完整，可能是适配问题。

这是我手机的参数：

祝好！

UP有新的插件URL吗，B站的介绍视频刚才被下架了

对于有nas，并且有些资源的使用者来说，这个功能还是不错的，比较期待加入
主要有两个方向：

1. smb或webdav在线播放（可以本地简历歌单，然后文件从nas读取）
2. 从nas把音乐复制到本地，当然这是次选方案，因为有些音乐的体积也不小，大多数场景，需要听高品质的时候，多数都是在家或者有wifi的地方，也就是上一条

宽屏模式显示有问题，页面无法滑动

我的歌单点击+号后

最近不知道怎么，一点下载就显示下载完成，然后对应的目录里面没有歌曲。

B站插件什么都搜索不出来，而其他平台的插件则工作正常

本地音乐不是在各大音乐应用下载的

我没有找到settings.graddle里用到的文件在哪

先谢谢作者提供的好软件。两个建议或问题：
指定下载文件夹后，被指定的和原来data文件夹里都下不了，显示下载完成实际没有下载。
保存的歌单应该能导出备份，以供导入。我为了下载问题清楚app数据，只能一个个重新找回来。

添加到播放列表，收藏到歌单只能挨个添加，有点麻烦

在家时需要推送给音响播放，希望能增加dlna、airplay、raat等协议支持局域网内推送播放

建议：能不能在歌单收藏那里加一个排序，正向排序和逆向排序，这样就能从最近的或者很久以前的开始听。

Music Free ios 开发问题记录

开发环境

按[email protected]官网搭建ios开发环境

我这边的开发环境：

• 代码库版本：2022.10.30 v0.0.1-alpha.7
• react-native-cli: 2.0.1
• react-native: 0.69.6
• yarn: 1.22.19
• ruby: 2.7.5
• cocoapods: 1.11.3
• node: 16.17.0
• xcode: 14

开始

yarn install
cd ios && pod install
npx react-native start

# simulator 是你ios的模拟器版本
npx react-native run-ios --simulator='iPhone 14 Pro'

样式问题

1. textAlignVertical: 'center'只支持安卓，不支持ios，需要用lineHeight替代
2. 运行到模拟器的时候，可能会出现icon找不到，参考react-native-vector-icons

ios卡片切换背景

由于ios默认卡片动画，在切换下一个card的过程中会显示前一个card，使得滑动看起来很奇怪

解决思路：

1. 每个路由页面里面添加背景色或图片
2. 使用react-navigation/native，自定义你想要的切换动画

播放问题

问题及解决方案：

1. 在src/core/musicQueue.ts 399行

   await TrackPlayer.add([track, getFakeNextTrack()]);
   // getFakeNextTrack 方法返回值
   if (track) {
       return produce(track, _ => {
           _.url = '';
       });
   } else {
       return { url: ''};
   }

• 调用TrackPlayer.add方法，ios版本url必须有值，不能为空，所以播放失败，可以使用

  if (!!LocalMusicSheet.isLocalMusic(track) && !track.url) {
      // 本地音乐url 处理
      return produce(track, _ => {
           _.url = _?.$?.localPath || '';
          // 自动下一首歌标记
          _.nextPalySign = 1;
      });
  }
  // 其他音频url
  return produce(track, _ => {
      _.nextPalySign = 1;
  });
  // 104行的事件里面判断改成
  !(await TrackPlayer.getTrack(evt.nextTrack))?.nextPalySign

2. ios后台播放需要自己开启支持react-native-track-player

文件权限

• 由于react-native-documente-picker选择的外部文件，只能在当前app的生命周期使用，重新打开的时候没有

• 引用 UIDocumentPickerViewController apple开发文档 里面的话在 iOS13 中，用户可以使用. 文档选择器返回目录的安全范围 URL，允许您的应用访问其容器外的内容。在这种情况下，URL 允许您的应用程序递归地访问目录及其所有内容，包括访问您将来添加到目录中的任何新项目。你的应用甚至可以为这个 URL 保存一个书签，让它在下次启动时访问该目录。

解决思路：

1. 因为自己使用（就是懒），我是把需要导入的音乐文件放到app文件夹内就可以访问
2. 添加书签方案
3. 虽然文件看不到，但是react-native-track-player可以播放，可以从媒体路径这方面下手
4. 等@maotoumao 开发，哈哈~~~

后续

后续可以跟着@maotoumao 大佬主版本开发，完~

批量操作太重要了。比如批量删除

很多源的歌曲都会有mv可以播放，不知大佬是否能增加播放mv的功能。

注意事项

• 确保已经阅读过ReadMe并了解本软件的定位
• 确保你的新需求/想法合理合法，且不是因为无解决方案的众口难调导致的个例问题

需求描述
请详细描述一下需求场景，以及可能导致的问题；以及你预期的解决方案或效果

替代方案
如果无法实现，请描述一下预期的替代方案或最低期望

其他信息
是否能提供一些其他的帮助，包括但不限于代码、UI、测试 ... 如果有的话，辛苦描述一下，感谢~

下载清单能不能保留下载过的歌曲，而不仅仅显示下载中的歌曲，不然下载了什么歌曲都不知道，而且也难找

报错

有可能通过插件功能实现网易云盘功能吗，我看网易云api里有这个
不过大多数第三方都没做这个功能就是了

希望能够读取内嵌的音乐标签。

注意事项

• 确保已经阅读过ReadMe并了解本软件的定位
• 确保你的新需求/想法合理合法，且不是因为无解决方案的众口难调导致的个例问题

需求描述
希望像网易云等软件一样可以将歌曲设为铃声

替代方案
如果无法实现，请描述一下预期的替代方案或最低期望

其他信息
示例ui如下：