灰色歌曲播放异常：音源切换与手动解析

症状

灰色歌曲点击播放后：

• 提示无法播放
• 播放进度条不动
• 播放的是错误歌曲（同名不同版本）

排查步骤

第一步：手动切换音源

这是最常用的解决方法：

1. 正在播放灰色歌曲时，找到音源选择入口
2. 依次尝试不同音源（酷我 / QQ / 酷狗 / 百度 / B站）
3. 找到能播放正确音频的那个音源

灰色解析是自动路由，但不一定每次都选到最好的音源。手动换一次可能就好。

第二步：网络问题

灰色解析需要从第三方音源获取音频流。检查：

• 当前网络是否能正常访问网易云（官方音乐能播放吗？）
• 网络速度（灰色音源 CDN 有时限速）
• 公司/校园网络是否屏蔽了某些域名
• 试试切换 WiFi / 手机热点

第三步：音源本身不可用

极端冷门歌曲可能在所有第三方音源上都搜不到。这种情况没有解决办法。可以：

• 换关键词在百度/谷歌搜搜看有没有公开播放源
• 等音源更新（第三方音源是动态的，冷门歌可能后续被收录）

第四步：版本问题

v5.1.0 重写了音源解析策略和播放逻辑。如果你用的是旧版，升级到 v5.1.0 或更新。

第五步：歌曲匹配错误

有时灰色解析搜到了同名但不同版本的音频（比如演唱会版 vs 录音室版、男唱 vs 女唱）。这种情况：

1. 手动换其他音源
2. 或等音源算法优化（AlgerMusicPlayer 的音源匹配在持续改进）

常见错误提示

终极方案

以上都不行时：

• 去 GitHub Issue 反馈（说明歌曲名+歌手+尝试过哪些音源）
• 或直接购买正版（这其实是最合规的方案）