【免费下载链接】now-playing-service一款全能的「正在播放」歌曲展示工具。支持检测 20 款音乐软件的歌曲信息内置精美歌曲组件、歌词组件、播放器提供 API 接口。适配 OBS 等直播软件以及日常桌面使用。项目地址https://gitcode.com/gh_mirrors/no/now-playing-service点击查看免费下载Now Playingnow-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 仍在监听系统默认设备。解决方法进入 Now Playing「设置 → 常规」的音频设备下拉框选择音乐软件实际输出声音的设备不确定选哪个Now Playing 内置了音频设备识别功能它会遍历所有活动输出设备找出正在出声的音乐进程所在设备并直接返回设备 ID识别逻辑见 DeviceDetect/Program.cs设备列表通过 AudioController.java 暴露的/api/audio/devices接口获取第一项固定为主声音驱动程序即系统默认设备。⚠️ 注意若将--device-id指定为固定设备后你换了耳机检测会立刻失效——此时应改回default默认设备模式检测程序会自动跟随系统默认输出设备的变化无需手动调整。技巧三理解 SMTC 与窗口标题选对识别方式检测歌曲信息有两条技术路线由「优先使用 SMTC」开关控制方式原理适用情况SMTC默认开启通过 Windows 媒体会话 API 读取歌名、歌手、封面、进度Spotify、QQ音乐、酷狗、浏览器网页播放器等支持 MediaSession 的软件信息最完整窗口标题读取音乐软件主窗口的标题文本解析老旧/不规范的软件网易云、全民K歌还支持通过 UI Automation 实时读取进度条什么时候需要动这个开关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 顶部注释参数含义默认值--device-id仅检测指定音频设备default默认设备--platform期望检测的音乐平台netease--smtc是否优先使用 SMTCtrue--poll-interval轮询间隔ms建议 100~1000100如果独立运行能正常输出状态Playing/Paused和歌名说明检测端没问题问题出在参数配置设备或平台如果输出一直是None配合DeviceVolumeTest.exe调试程序可通过系统 API/api/system/runDeviceVolumeTest触发查看各设备上音乐进程的真实音量即可锁定设备选错的场景。排查小结遇到检测不到正在播放的歌曲时建议按以下顺序依次检查平台音乐平台是否与实际听歌软件一致设备音乐软件的实际输出设备是否与 Now Playing 所选音频设备一致方式SMTC 与窗口标题两种识别方式是否匹配当前软件切换双平台用户是否启用了备选音乐平台自动切换验证用GetMusicStatus.exe独立运行做终极排查。绝大多数检测失败问题都可以通过「平台 设备」这两项配置的调整迎刃而解。赞分享【免费下载链接】now-playing-service一款全能的「正在播放」歌曲展示工具。支持检测 20 款音乐软件的歌曲信息内置精美歌曲组件、歌词组件、播放器提供 API 接口。适配 OBS 等直播软件以及日常桌面使用。项目地址https://gitcode.com/gh_mirrors/no/now-playing-service点击查看免费下载相关推荐Now Playing WebSocket 实时推送实战歌曲信息与歌词如何做到秒级同步到前端Now Playing WebSocket 实时推送实战歌曲信息与歌词如何做到秒级同步到前端 now playing service下称 Now PlayiArea51音频设备切换API检测与选择方法Area51音频设备切换API检测与选择方法 在游戏开发中音频设备的动态切换是提升玩家体验的关键功能。Area51引擎的音频管理系统提供了完整的设备检测与选ncspot音频输出切换多设备管理技巧ncspot音频输出切换多设备管理技巧 ? 为什么需要多设备管理 你是否曾遇到过这些场景 戴着蓝牙耳机却发现音乐从电脑扬声器播放 外接显示器后音频设备列表音频CLI创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考