洛雪音乐配置说明

洛雪音乐本身不内置任何音乐源，软件通过自定义源功能来获取音乐数据。本教程将介绍音乐源机制和自定义源的使用方法。

音乐源机制

洛雪音乐采用可扩展的音乐源架构，软件本身不包含任何音乐源。用户可以通过自定义源功能导入自己编写的或从其他渠道获取的音乐源脚本。

每个音乐源脚本需要声明以下信息：

• 源名称：在软件中显示的名称，如「酷我音乐」等
• 支持的音质：如 128k、320k、flac、flac24bit
• 支持的操作：获取音乐 URL、获取歌词、获取封面等

如何导入自定义源

1. 打开洛雪音乐，进入「设置」页面。
2. 找到「音乐来源」或「自定义源」相关设置项。
3. 点击「添加」或「导入」按钮，选择你准备好的音乐源脚本文件（.js 格式）。
4. 导入成功后，软件会显示该源的名称和支持的音质信息。
5. 在搜索或播放时，软件会自动使用已导入的音乐源获取数据。

自定义源脚本基础

自定义源脚本使用 JavaScript 编写，文件需使用 UTF-8 编码格式，支持 ES6+ 语法。脚本通过事件收发方式与应用交互。

脚本文件开头必须包含以下注释信息：

/**
 * @name 测试音乐源
 * @description 我只是一个测试音乐源
 * @version 1.0.0
 * @author xxx
 * @homepage http://xxx
 */

脚本核心结构包括：

• 初始化事件：脚本加载完成后发送 inited 事件，声明支持的源和音质
• 请求处理：注册 request 事件，处理应用发起的音乐 URL、歌词、封面等请求
• HTTP 请求：使用 globalThis.lx.request 方法发送网络请求，不受跨域限制

可用音质说明

自定义源可以声明支持以下音质：

• 128k：标准音质
• 320k：高品音质
• flac：无损音质
• flac24bit：Hi-Res 无损音质

换源功能

当某个音乐源无法获取某首歌曲时，软件会自动尝试使用其他已导入的音乐源获取，这就是「换源」功能。如果所有源都无法获取，会提示「换源失败」。

遇到换源失败时，可以尝试：

• 检查音乐源脚本是否正常工作
• 尝试手动切换到其他音乐源
• 确认网络连接正常