自动切换失效播放源工作机制详解

为什么需要自动切换

国内音乐版权频繁变动，一首歌的播放源随时可能失效。传统做法是手动去各平台挨个搜，体验很差。Listen 1 在 V2.9.0 版本引入了自动切换播放源功能：

当一首歌的播放源不可用时，会自动搜索其他平台，获得可用的播放源。避免了用户手动搜索的麻烦。

工作机制

自动切换播放源的内部流程大致如下：

1. 用户点击播放某首歌
2. Listen 1 首先尝试从当前搜索来源的平台获取播放 URL
3. 如果返回 404、播放地址为空或实际播放失败
4. Listen 1 在后台同时向其他六大平台发起同一首歌的搜索请求
5. 拿到其他平台的搜索结果后，依次尝试每个平台的播放 URL
6. 找到第一个能正常播放的源，自动切换过去

整个过程对用户是透明的——只表现为播放延迟几秒后，歌曲自动开始播放。

什么时候不会触发自动切换

以下场景自动切换可能不工作：

• 歌名不精确匹配：不同平台可能对同一首歌有不同的命名（如「七里香 Live」vs「七里香」），自动匹配有失败几率
• 所有平台都下架：如果一首歌在全部七个平台都因版权原因下架，Listen 1 无法凭空生成播放源
• Bilibili 源的特殊性：Bilibili 的音频资源以视频形式存储，匹配逻辑与其他平台不同

Beta 版说明

自动切换功能在 V2.9.0 标记为 Beta，意味着可能在某些边缘场景下表现不稳定：

• 不同平台的播放地址解析规则会更新，需要持续适配
• 部分冷门歌曲的跨平台匹配逻辑可能需要优化
• 在网络环境较差时，后台并发搜索的延迟可能叠加

遇到自动切换失效时，可以按「常见问题排查」章节的指引手动处理。

手动切换源（备用方案）

如果自动切换没成功，你可以手动操作：

1. 在搜索框再次输入歌曲名
2. 逐个点击不同平台标签，看哪个平台还有该曲目的可播放版本
3. 点击该版本的「播放」按钮即可
4. 也可以将多个平台版本都加入播放队列，挨个尝试