LXMusic 中文文档 下载 App

多音源并行——自动换源、手动切换与音质回退

为什么需要多个音源

音源脚本的生命周期不稳定。第三方平台接口变化、反爬升级、脚本作者停止维护,都可能导致单个音源突然失效。一次导入多个音源脚本是防止搜不到歌、放不出歌的最佳策略。

调度器如何工作

当你导入并启用了多个音源脚本,洛雪音乐内部有一个音源调度器,负责在合适的时机选择音源:

搜索阶段

搜索时,调度器会向所有已启用的音源发起搜索请求。各音源返回的结果会被合并到一个结果列表中展示。不同音源对同一首歌可能返回不同版本(比如不同平台的音源都有这首歌),你可以在搜索结果中选择其中一个版本。

播放阶段

点击播放某首歌时,调度器的逻辑是:

  1. 优先使用该歌曲来源的音源(比如你选了 A 音源返回的版本,就先用 A 音源取播放 URL)。
  2. 如果 A 音源取 URL 失败,自动尝试 B、C、D 音源——这就是「自动换源」。
  3. 所有音源都失败时,提示「换源失败,请尝试手动切换」。

换源是自动的

你不需要手动一个个试音源,调度器在后台完成所有切换。

手动切换音源

虽然换源是自动的,但有时你可能想强制指定用某个音源:

设置默认音源

在「音乐来源」设置中,可以将某个音源设为「默认搜索源」。之后搜索和播放会优先使用这个音源,失败时再自动换源。

临时手动切换

某些版本支持在播放详情页或歌曲列表的右键菜单中手动切换音源:

禁用某些音源

如果某个音源脚本虽然初始化成功但返回的数据质量差(比如经常返回无效 URL),可以在自定义源管理界面取消勾选它。被取消勾选的音源不会参与调度。

音质回退

音源脚本可能声明支持多个音质等级(128k / 320k / flac / flac24bit)。播放或下载时,洛雪音乐的音质回退逻辑是:

  1. 先尝试你设置的目标音质(比如 flac 无损)。
  2. 如果当前音源不支持该音质或获取失败,自动降低一级(比如从 flac 降到 320k)。
  3. 继续回退直到 128k 标准音质。
  4. 如果所有音质都失败,再触发音源切换。

常见问题

所有音源都提示换源失败

这不是洛雪音乐的问题,而是所有已启用的音源脚本都失效了。此时:

搜索结果很乱

导入多个音源后,搜索结果会混合显示不同源的歌曲。如果觉得混乱:

某个音源特别慢

可以在自定义源管理界面取消勾选这个音源,或者换用更快的脚本。音源的响应速度取决于脚本内部的请求逻辑和目标平台的接口速度。

最佳实践

相关阅读