企业官网建设流程全解析

MusicFree 插件化无广告音乐播放器：3 步装好音源，搞定免广告听歌

【免费下载链接】MusicFree插件化、定制化、无广告的免费音乐播放器项目地址: https://gitcode.com/GitHub_Trending/mu/MusicFree

MusicFree 是一款插件化音乐播放器：本体只是播放壳子，无广告，搜索与音源全部由你安装的插件提供。全文按功能模块拆解，各章可独立阅读，最短路径放在最前。

最短可用路径：从装包到第一首播放

下载 APK 并授予基础权限

• 打开发布页，下载对应系统的 APK 并安装
• 仅支持 Android 与 Harmony OS，下载前先确认机型
• 首次启动授予文件读写权限，供下载与备份使用
• 其他渠道的收费版、破解版均为假冒，见到直接举报

不授权也能听歌，只是用不了下载和歌单备份。

安装第一个音源插件

• 侧边栏进"插件管理"，点"从本地安装插件"选 .js 文件
• 或点"从网络安装插件"，粘贴 .js 或 .json 地址确认
• 打开搜索页输入歌名，点单曲结果完成首次播放

克隆仓库本地跑通

要改代码就先克隆到本地：

git clone https://gitcode.com/GitHub_Trending/mu/MusicFree

核心播放逻辑在 trackPlayer，插件调度在 pluginManager，改动前先看这两个目录。

插件管理：音源的增、换、更新

从本地 .js 安装

• 在插件管理页点"从本地安装插件"
• 选择手机里的 .js 文件，等待安装成功

原理：插件是符合协议的 JS 文件，缓存分页交给主体。

如果安装失败就换一份可靠来源的插件文件，来路不明的不要装。

订阅插件地址并批量更新

• 点"从网络安装插件"，粘贴插件地址确认
• 页面右上角选"更新订阅"，插件集体刷新
• 订阅的 .json 描述文件可一次带出整组插件

原理：订阅只是插件地址清单，批量刷新省事。

如果地址打不开就先查网络，仍不行就换一个稳定来源。

设置音源重定向

• 对失效插件打开选项，选"音源重定向"
• 指向另一个可用插件后保存

原理：播放取的是地址，地址由目标插件生成。

如果两个插件都不可用就切低一档音质重试，部分平台低音质可用性更高。

搜索与入库：把歌找到并存进歌单

四类结果里播放与收藏

• 打开搜索页，输入歌名
• 在单曲、专辑、作者、歌单四类结果里选择
• 点单曲播放；长按选"加入歌单"收藏

如果搜不到结果，先确认已装插件支持该平台搜索。

导入别人的歌单

• 在插件管理里打开对应插件的选项
• 选"导入歌单"，粘贴歌单链接确认
• 导入后歌曲进入你的本地歌单

原理：导入只是把链接解析成列表存到本地。

如果导入报错，就检查链接是否完整、该插件是否支持这个平台。

歌词同步：词和歌对不上时的两种修法

设置歌词偏移

• 播放页切到歌词页，点"设置歌词偏移"
• 拖动滑块让高亮行对上当前句后保存
• 偏移只对当前这首歌生效

原理：偏移只是把歌词时间轴整体平移。

如果拖完仍对不上，多半是歌词内容本身就错了，转用下面的重新获取。

搜索歌词或关联歌词

• 歌词完全不对时用"搜索歌词"重新取一份
• 或用"歌词关联"把另一首同名歌的词引过来
• 关联后两首歌共用同一份歌词，支持链式关联

如果提示"暂无歌词"，说明当前插件没有歌词接口，就换带歌词能力的插件。

歌单内检索：长列表快速定位

打开歌单检索并过滤

• 歌单页点顶部搜索框，输入关键词
• 列表实时过滤，点匹配歌曲直接播放
• 想看实现可查 searchMusicList

如果没有过滤结果，就检查关键词拼写，或清空后换个词。

理解过滤规则

• 匹配歌名、歌手、专辑名，忽略大小写
• 本地匹配即时出结果，不等网络

原理：本地字符串匹配，和插件速度无关。

如果列表很长输入卡顿，就改用更精确的关键词缩小范围。

进阶与个性化：按需微调即可

主题与背景：夜里切深色，亮处切浅色

入口：侧边栏"主题设置" → 改什么：深浅模式、上传一张背景图 → 改完效果：播放页背景即时生效，不用重启。

定时关闭：让当前歌自然播完

入口：侧边栏"定时关闭" → 改什么：选一个时长 → 改完效果：倒计时结束后播完当前歌曲再退出，不在副歌中间切断；再点一次取消。

音质、缓存、备份：设一次就不用管

入口："基本设置" → 改什么：默认播放音质、下载并发数、是否允许移动网络播放，缓存大小查看与清理 → 改完效果：播放行为稳定，空间可随时释放。备份走侧边栏"备份与恢复"，存手机本地或 WebDAV（把本地文件同步到任意云端的协议，任何支持该协议的服务都能接），备份含歌单与播放记录，换机恢复即可。

问题速查

通用排查顺序：先权限、再网络、最后查音质和版本。

现在打开侧边栏的"插件管理"，装一个常用插件，搜一首歌验证播放与歌词高亮。

【免费下载链接】MusicFree插件化、定制化、无广告的免费音乐播放器项目地址: https://gitcode.com/GitHub_Trending/mu/MusicFree