MusicFree 插件安装与使用指南
MusicFree 插件安装与使用指南
近未來.一、准备工作：安装 MusicFree 应用
如果您尚未安装 MusicFree 应用，请先从官方发布页面下载并安装：
https://github.com/maotoumao/MusicFree/releases
二、安装插件的核心步骤
请参照下图，并按以下步骤操作进入插件安装界面：
图示：插件安装主要步骤 (1-4)
- 打开 MusicFree 应用，点击界面左上角的菜单按钮（三条横线）。
- 在弹出的侧边栏中，找到并点击【插件管理】。
- 进入“插件管理”页面后，点击界面右下角的加号（+）按钮。
- 此时会弹出“安装插件”选项，您可以根据需要选择安装方式。
三、选择插件安装方式
您可以选择以下任意一种方式来安装插件：
方式一：通过网络安装
- 在“安装插件”菜单中，选择【从网络安装插件】。
- 在弹出的输入框中，输入插件的 URL 地址。注意：插件链接通常以
.json或.js结尾。 - 点击确认即可安装。
💡官方示例插件
如果要使用示例插件，输入下面链接：
https://gitee.com/maotoumao/MusicFreePlugins/raw/master/plugins.json
💡音乐服插件
如果要使用音乐服插件，输入下面链接：
https://gitee.com/Rrance/WP/raw/master/未响.js 【未响】
https://gitee.com/Rrance/WP/raw/master/爱坤.js 【ikun】
https://gitee.com/Rrance/WP/raw/master/鹅皇.js 【鹅皇】
https://gitee.com/Rrance/WP/raw/master/南瓜_emby.js 【南瓜音乐】
https://gitee.com/Rrance/WP/raw/master/音海拾贝.js 【音海拾贝】
方式二：通过本地文件安装
- 在“安装插件”菜单中，选择【从本地安装插件】。
- 应用会打开文件管理器，请浏览并选择您已下载到手机上的插件文件（通常是
.json或.js文件）。 - 选择文件后即可完成安装。
方式三：添加订阅
订阅地址和从网络安装插件的地址完全相同。
当添加订阅地址后，可以点击【更新订阅】更新订阅源提供的所有插件。
四、音乐服插件功能概览
音乐服插件的核心功能是连接到 Navidrome 音乐服务器，让您可以在 MusicFree 中将其作为一个音源使用。主要功能包括：
搜索与播放：搜索您 Navidrome 库中的歌曲、专辑和播放列表（显示为“在线歌单”），并直接播放音乐。
浏览内容：查看专辑详情（包含歌曲列表）和播放列表详情。
特殊浏览：在“推荐歌单”板块，可以快速访问“所有歌曲”和您在 Navidrome 上创建的以及公开的“在线歌单”。在“榜单”板块，可以快速访问 Navidrome 上的“最近添加”、“最近播放”以及“最多播放”列表。
歌词与封面：尝试获取歌曲的歌词和封面图（部分依赖外部接口https://lrc.xms.mx）。
歌单导入：支持从网易云音乐导入歌单，并在您的 Navidrome 服务器上进行智能匹配和创建。
五、音乐服插件配置
音乐服插件安装后需要进行额外配置才能正常工作：
- 回到【插件管理】页面，找到您刚刚安装的音乐服插件。
- 点击插件下方的【用户变量】按钮。
- 根据弹出的对话框提示，准确填写您的 Navidrome 服务器地址 (URL)、用户名和密码。
- 点击确认保存配置。
六、网易云歌单导入
音乐服插件成功安装并配置后，您可以用它来搜索音乐或导入在线歌单。导入网易云歌单的流程如下：
请参照下图并按以下步骤操作：
图示：网易云歌单主要导入步骤 (1-3)
- 返回到 MusicFree 应用的主界面。
- 点击“**+”号旁边的导入歌单**按钮。
- 在弹出的“导入歌单”对话框中，选择需要导入的音乐服，例如图示【南瓜音乐】。
- 在输入框中，粘贴您的网易云歌单分享链接或纯数字 ID。
- 点击【确认】开始导入。
导入机制说明：
- 插件首先从网易云获取歌单内的歌曲信息（歌名、歌手、专辑、时长、封面等）。
- 尝试在 Navidrome 服务器上搜索并匹配这些歌曲。
- 对于成功匹配到的 Navidrome 歌曲，插件会在 MusicFree 本地创建一个包含这些歌曲的新列表。同时，尝试在 Navidrome 服务器上创建一个与网易云歌单同名的歌单，如果 Navidrome 上已存在同名歌单，将删除重建。
- 未能在 Navidrome 中匹配到的歌曲将被忽略。
六、重要提示
登录保活 (Keep-Alive)：为了维持与 Navidrome 服务器的连接（尤其是在执行搜索或导入等可能耗时的操作时），插件会在您执行浏览推荐歌单（例如点击“在线歌单”或“所有歌曲”）或执行网易云歌单导入操作时，自动尝试进行登录状态保活。如果您长时间未使用插件并遇到连接问题（如无法搜索或加载内容），尝试执行上述操作之一可能有助于恢复连接。
外部依赖：歌词功能和部分封面图片的获取依赖于外部在线服务 (lrc.xms.mx)，该服务的可用性会直接影响这些功能的正常使用。
NCM 导入匹配：网易云歌单的导入效果取决于 Navidrome 库中是否存在与网易云歌曲信息足够匹配的歌曲。如果库中缺少相应歌曲，或者歌曲元数据差异较大，则可能无法成功匹配并导入。
服务器歌单创建：网易云歌单导入功能会在 Navidrome 服务器上创建新的播放列表。如果 Navidrome 上已存在同名歌单，将删除重建。可能部分音乐服不允许创建播放列表，请知晓。
现在您已经了解了如何在 MusicFree 安卓版中安装和使用插件了！
➖➖➖➖➖➖➖➖➖➖➖➖➖➖➖➖➖➖➖➖➖➖➖➖➖➖➖➖➖➖➖➖➖➖➖➖➖➖➖➖➖➖➖➖
