插件说明与常见问题

什么是插件

MusicFreeAndroid 本身不内置任何音源，所有搜索、播放、歌单、歌词、推荐能力都由第三方编写的插件提供。播放器只是一个容器与沙箱。

如何获取插件

⚠️ 本项目不提供也不维护任何官方插件源。请从你信任的渠道自行获取，并自行承担风险。

获取插件后，两种安装方式：

  1. 本地文件：将 .js 文件保存到设备，在「设置 → 插件管理 → 安装」选择文件
  2. 订阅 URL：在「插件管理 → 订阅」粘贴 URL，订阅源更新时可一键拉取所有插件最新版

沙箱与权限

  • 插件运行在 QuickJS 沙箱内，不是 V8 / JavaScriptCore
  • 沙箱可访问：网络请求（HTTP/HTTPS）、require() 注入的工具（cheerio / crypto-js / dayjs / axios / qs / he / big-integer）
  • 沙箱不能访问：本地文件系统、设备信息、其他应用数据

免责声明

本项目仅提供播放器与插件运行容器，不对第三方插件的功能、合法性、安全性、内容质量负责。请确认所用插件来源合规。

常见问题与故障排查

装不上怎么办？

  • 检查「未知来源应用安装」是否开启（系统设置 → 应用 → 你用的浏览器/文件管理器 → 安装未知应用）
  • 检查下载的 APK 是否对应你的设备 ABI（参考 下载页）
  • 旧版本残留：先卸载老版本再装新版本

启动闪退？

  • 反馈渠道：GitHub Issues
  • 反馈时请附：设备型号、Android 版本、应用版本、复现步骤
  • 日志：「设置 → 关于 → 导出日志」（默认保留最近 7 天）

插件不生效？

  • 在「设置 → 插件管理」确认插件已启用（开关绿色）
  • 检查插件作者公告，某些服务可能被服务方限流或调整接口
  • 同一搜索词在不同插件下结果差异是正常的

后台播放被系统杀掉？

  • 「系统设置 → 电池 → 应用启动管理 / 后台耗电」中将本应用加入白名单
  • 部分厂商 ROM（如小米、华为、OPPO）需要手动允许「自启动」「关联启动」「后台运行」
  • 锁屏后通知栏播放卡片消失通常是被系统清理

歌词不准 / 不显示？

  • 「全屏播放器 → 歌词面板 → 长按 → 关联其他来源」可手动绑定其他插件的歌词
  • 「歌词偏移」可微调时间轴（按毫秒）
  • 部分插件不返回歌词，属于该插件能力问题

找不到某些功能？

  • 「下载管理」「自定义主题」目前仍在补齐中
  • 完整路线图见 特性页

我可以贡献代码 / 翻译 / 反馈 BUG 吗？

可以，详见 贡献页。