Now Playing 检测不到歌曲？5 大音频设备与平台切换排查技巧

Now Playing（now-playing-service）是一款全能的「正在播放」歌曲展示工具，支持检测 20+ 款音乐软件的歌曲信息，并适配 OBS 等直播软件。但不少新手会遇到"检测不到正在播放的歌曲"的困扰。本文结合源码中的检测原理，分享5 大排查技巧：音频设备怎么选、音乐平台怎么切、SMTC 是什么，帮你快速定位问题所在。

Now Playing 的检测链路大致如下图所示：C# 程序GetMusicStatus.exe通过窗口标题或SMTC两种方案读取音乐软件的播放状态与歌曲信息，再由 Spring Boot 主程序封装成查询结果输出。理解了这条链路，排查问题就有了方向。

技巧一：确认「音乐平台」选对了，这是最常见的原因

Now Playing 默认检测的是网易云音乐（netease），如果你实际听歌用的是 QQ 音乐、Spotify 或 PotPlayer，那自然什么都检测不到。

• 在「设置 → 常规」中切换音乐平台，可选项包括：国内平台（网易云音乐、QQ音乐、酷狗音乐、酷我音乐、汽水音乐、全民K歌）、国外平台（Spotify、Apple Music、YouTube Music）、点歌机（咩播、花花直播助手、BQ 点歌姬等）、本地播放器（PotPlayer、Foobar2000、AIMP 等）、其它（浏览器、洛雪音乐、MusicFree、Cider、YesPlayMusic）。
• 修改保存后，主程序会自动重启检测进程并应用新平台，无需手动重启软件。相关逻辑见 AudioService.java 中对配置变更事件的监听处理。
• 程序内部以--platform参数传给 C# 检测端，完整的平台映射表在 Program.cs 中可以查到。

💡经验：平台选错时症状很典型——软件明明在播放，Now Playing 却一直是"未检测到歌曲"。先换对平台，能解决一半的问题。

技巧二：选对「音频输出设备」，多设备用户必看

这是第二个高频坑。检测进程通过音频会话（Audio Session）定位音乐进程并读取其实时音量，因此它只能"看到"输出到所选音频设备上的声音。

常见翻车场景：

• 你的默认输出设备是耳机，但音乐软件被单独配置到了扬声器/声卡输出（网易云音乐「设置 → 播放 → 输出设备」就是典型入口，如下图）；
• 使用了虚拟音频设备（如虚拟声卡、直播采集卡）转发音乐，而 Now Playing 仍在监听系统默认设备。

解决方法：

1. 进入 Now Playing「设置 → 常规」的音频设备下拉框，选择音乐软件实际输出声音的设备；
2. 不确定选哪个？Now Playing 内置了音频设备识别功能：它会遍历所有活动输出设备，找出"正在出声的音乐进程所在设备"并直接返回设备 ID，识别逻辑见 DeviceDetect/Program.cs；
3. 设备列表通过 AudioController.java 暴露的/api/audio/devices接口获取，第一项固定为"主声音驱动程序"（即系统默认设备）。

⚠️ 注意：若将--device-id指定为固定设备后，你换了耳机，检测会立刻失效——此时应改回default（默认设备模式），检测程序会自动跟随系统默认输出设备的变化，无需手动调整。

技巧三：理解 SMTC 与窗口标题，选对识别方式

检测歌曲信息有两条技术路线，由「优先使用 SMTC」开关控制：

什么时候需要动这个开关？

• Spotify、QQ 音乐等部分软件在不打开 Windows 媒体控制面板时，SMTC 播放状态不会刷新，程序已用"检测实时音量"兜底判断播放/暂停（见 SpotifyMusicSMTC.cs 中的注释说明），一般无需干预；
• 浏览器播放（如网页版网易云、YouTube 网页版）时，SMTC 状态是实时刷新的，建议保持开启；
• 若某平台在 SMTC 模式下总是"检测到歌名但状态不刷新"，可以尝试关闭 SMTC 改用窗口标题方案对比验证。

各平台的 SMTC 实现位于 MusicServices/SMTC/ 目录，每个文件对应一个平台，便于排查特定平台的问题。

技巧四：开启「备选音乐平台」，双平台用户自动切换

习惯在"桌面音乐软件 + 网页版"之间来回切的用户，可以启用备选音乐平台：

• 主程序每 5 秒检查一次首选平台进程是否存活（由 CheckMusicProcess 完成，平台与进程名的映射规则见 Helper.cs）；
• 一旦首选平台关闭，自动切换到备选平台继续检测，两者都配置在 SettingsGeneral.java 中对应的platform与fallbackPlatform字段；
• 切换是全自动的，无需手动操作，日志中会输出"开始识别备选音乐平台"提示。

这是"检测不到歌曲"的一个隐形原因：你以为在检测 A 平台，实际上 A 平台的进程早就退出了，而备选功能没有开启。

技巧五：用 GetMusicStatus.exe 独立运行，做终极验证

当上述方法都无法定位时，直接运行底层检测程序，看它到底"听到了"什么：

cd Assets\AudioService GetMusicStatus.exe --platform netease --smtc true --poll-interval 100

命令行参数一览（定义见 Program.cs 顶部注释）：

• 如果独立运行能正常输出状态（Playing/Paused）和歌名，说明检测端没问题，问题出在参数配置（设备或平台）；
• 如果输出一直是None，配合DeviceVolumeTest.exe调试程序（可通过系统 API/api/system/runDeviceVolumeTest触发）查看各设备上音乐进程的真实音量，即可锁定设备选错的场景。

排查小结

遇到"检测不到正在播放的歌曲"时，建议按以下顺序依次检查：

1. 平台：音乐平台是否与实际听歌软件一致？
2. 设备：音乐软件的实际输出设备是否与 Now Playing 所选音频设备一致？
3. 方式：SMTC 与窗口标题两种识别方式是否匹配当前软件？
4. 切换：双平台用户是否启用了备选音乐平台自动切换？
5. 验证：用GetMusicStatus.exe独立运行做终极排查。

绝大多数检测失败问题，都可以通过「平台 + 设备」这两项配置的调整迎刃而解。