MusicFree 新手指南免费插件化音乐播放器6 步打通一首歌的播放【免费下载链接】MusicFree插件化、定制化、无广告的免费音乐播放器项目地址: https://gitcode.com/GitHub_Trending/mu/MusicFreeMusicFree 是一款免费、无广告的插件化音乐播放器支持 Android 与 Harmony OS走了一条不寻常的路子应用本身不内置任何歌曲搜索、播放全部靠插件完成。你可以把 MusicFree 理解成一台唱机——机器只负责转唱片歌都在唱片上唱片在机器外面。插件就是这些唱片装上一张就能播对应平台的歌换掉它音源就换了。本文按真实使用路径走 6 步从装好空壳到跟着歌词一起唱。先认识这台空壳MusicFree 不自带歌这节回答装完之后的第一个疑问为什么打开什么歌都搜不到壳是唱机插件是唱片MusicFree 只负责播这件事播放控制、歌单、歌词、下载、缓存。搜索结果、歌曲链接、歌词内容这些货全部由插件提供。插件本质上是符合固定协议的 JS 文件插件开发者只写输入输出分页、缓存由播放器统一处理。这也是它出厂不带音源的原因是设计不是遗漏。另外如果在别的渠道看到收费版破解版都是假的。这个项目基于 AGPL 3.0 开源且一直免费部分应用市场里同名同 Logo 的 MusicFree 是套用名称的广告软件遇到直接举报。从发布页下载 APK授权文件读写到仓库的发布页下载对应版本的 APK 安装。首次启动会申请文件读写权限主要用于下载歌曲和备份歌单不同意也能听歌只是用不了下载和备份。侧边栏有权限管理入口随时可以回头补权限。想改代码克隆仓库本地运行如果你打算二次开发先克隆到本地熟悉结构git clone https://gitcode.com/GitHub_Trending/mu/MusicFree核心播放逻辑在 src/core/trackPlayer/插件调度在 src/core/pluginManager/。动手改功能前先看这两个目录不容易跑偏。装第一个音源插件两个入口各一次点击这节解决有了壳怎么开始能搜到歌。安装入口在侧边栏的插件设置装好至少一个插件之前搜索页不会有任何结果。从本地 .js 文件直接装点插件设置页的从本地安装插件选中手机里的 .js 文件等成功提示。支持多选一次装几个。如果提示插件无法解析说明文件本身坏了或根本不是插件文件换一个可靠来源。粘贴地址一键安装订阅后自动更新点从网络安装插件粘贴插件的 .js 文件地址或 .json 描述文件地址确认即可地址可以粘贴多条。更推荐订阅一个插件集合地址之后在插件页菜单点更新订阅所有插件会一次性刷到最新版。如果出现插件安装失败先看提示里的具体原因地址打不开就检查网络解析报错就换一个可靠的插件来源。来路不明的插件别装花 10 秒验证比长期提心吊胆划算。装好后开关、排序、一键卸载插件列表里每个插件都有一个开关控制它是否出现在搜索结果、榜单和推荐歌单里——关掉不等于删除只是让它让位。页面菜单里的排序决定各插件结果在搜索页的先后顺序卸载全部适合想清零重来时弹窗确认后再动手。把搜索页用熟四类结果、导入歌单、歌单内检索装好插件后进搜索页输入歌名链路就通了。这节讲三个最常用的操作。结果分单曲、专辑、作者、歌单四类点单曲直接播放点击单曲后的行为播放还是替换当前列表可以在基本设置里配。点专辑、作者进详情页可以整张播放或批量加入歌单点歌单直接进它的歌曲列表。把别人的歌单导入到本地歌单首页新建歌单旁边有导入歌单按钮点一下应用会自动寻找具备导入歌单能力的插件把歌单链接粘贴进去、确认歌曲就进了你的本地歌单。如果没弹出导入浮层说明已装插件都不支持这个功能装一个支持的就有了。长按加入歌单长歌单用歌单内检索定位长按搜索结果选加入歌单可以顺手新建。歌单长到几十首后翻找很费劲点歌单页顶部搜索框输入关键词列表会按歌名、歌手、专辑实时过滤点一下直接播放。这套歌单内检索的实现可以看 src/pages/searchMusicList/。让歌词跟上唱偏移、搜索与关联进播放页切到歌词页歌词会随进度高亮滚动。一旦对不上用下面三个工具处理。歌词慢几拍调偏移点歌词区的设置歌词偏移拖动滑块让高亮行对上当前句保存即可。偏移只对当前这首歌生效适合就这一首不准的情况。歌词错了搜索歌词或关联歌词内容完全不对时点歌词区的搜索图标搜索歌词重新找一份或者把另一首同名歌曲的歌词关联过来两首歌共用同一份。关联还能串成链A 关联 B、B 关联 C三首歌都会显示 C 的歌词。顺手的还有歌词区的字号调节按钮以及翻译切换当前歌有翻译时才生效。出现暂无歌词怎么办说明当前插件不提供歌词接口换装有歌词能力的插件再重新搜这首歌。为夜晚和弱网配置深色模式、定时关闭、音质这节的功能都服务于特定时刻睡前、通勤、存储告急。深色模式与自定义背景侧边栏主题设置里切换深色 / 浅色也能上传一张背景图铺在播放页改动即时生效不用重启。嫌手动麻烦可以选跟随系统深色设置。定时关闭播完当前歌再退出 侧边栏点定时关闭设一个时长。倒计时结束后播放器会播完当前这首歌再退出不会在副歌中间切断想提前结束再点一次取消。侧边栏这一项上会实时显示倒计时不用进弹窗就知道还剩多久。默认音质与移动网络播放基本设置里指定默认播放音质低 / 标准 / 高 / 超高并决定是否允许移动网络播放——常坐地铁的话关掉允许移动网络播放能避免流量悄悄跑掉。下载并发1 / 3 / 5 / 7和下载路径也在这里设下载的歌会存到你指定的目录。存储告急先看三类缓存 基本设置页有音乐、歌词、图片三类缓存各自显示占用量点清理即可释放。清理只动缓存不会碰你下载好的本地音乐和歌单数据。音源失效或数据丢了重定向、自动换源与备份最后一节留给不对劲的日子。每种症状都有对应的开关按顺序试即可。播不动的歌多半是音源问题第一步到插件管理把失效的插件指向另一个可用插件音源重定向后续请求会自动走替补。第二步基本设置里打开播放失败时自动换源插件拿不到链接时会自动尝试其他源的同名歌曲。第三步切低一档音质重试部分平台低音质可用性更高。如果出现启动后播放进度丢失该问题在 v0.6.1 已修复侧边栏检查更新升级即可。换机前把歌单和插件数据备份出来所有数据都存在本地应用不收集任何个人信息——这也意味着换机不备份就没了。侧边栏备份与恢复支持存到手机本地生成一个 backup.json 文件或 WebDAV一种把文件同步到云端的协议任何 WebDAV 服务都能用备份文件包含歌单和播放记录新手机恢复即可原样拿回。如果备份失败先确认已授予文件读写权限再检查 WebDAV 地址是否带了 http 或 https 前缀。检查更新对照 changelog 确认修复你遇到的问题若已在 changelog.md 里列出侧边栏检查更新升级一下就解决了。现在就打开侧边栏进插件设置装一个你常用的音源插件再搜索一首歌播完确认歌词能高亮滚动——整条链路通了就可以正式开工了。【免费下载链接】MusicFree插件化、定制化、无广告的免费音乐播放器项目地址: https://gitcode.com/GitHub_Trending/mu/MusicFree创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考