点歌功能搜不到音乐资源 —— 音源和格式问题
常见原因
一、歌名/歌手名不准
最常见。试试换个搜法：
| 你发的 | 换成 |
|---|---|
| 点歌 晴天 | 点歌 周杰伦 晴天 |
| 点歌 江南 | 点歌 林俊杰 江南 |
| 点歌 七里香 | 加上歌手名 |
加歌手名搜索命中率高很多。
二、词库绑定的音源没有这首歌
不同音乐类词库绑定不同的音源（网易云/QQ 音乐/第三方等）。某首歌在某个平台没版权或下架了，那个音源就搜不到。
修法：
- 换另一个音乐词库（绑定不同音源的）
- 或在词库设置里换音源
三、触发词格式不对
有些词库要求特定的点歌格式：
| 词库要求 | 你可能发的 | 问题 |
|---|---|---|
| 「点歌 周杰伦-晴天」 | 「点歌周杰伦晴天」 | 缺了分隔符 |
| 「播放 XX」 | 「点歌 XX」 | 触发词根本不是"点歌"而是"播放" |
| 「/play XX」 | 「点歌 XX」 | 带斜杠的命令你没加 |
进词库详情页看清楚它的实际触发词和格式要求。
四、音源接口限流
部分第三方音源有调用频率限制。短期内太多点歌请求会被限流，返回空结果。
修法：设冷却时间（词库高级设置 → 同一群 30 秒内点歌只响应一次）。
五、网络问题
手机当前网络访问不到音源服务器。切 Wi-Fi/移动数据、检查代理。
排查顺序
- 先加歌手名试试
- 看词库的触发词格式对不对
- 换个音乐词库（不同音源的）
- 看日志（见 日志）里音乐类触发的详细错误原因