Now Playing 如何识别你正在听的歌?窗口标题 + SMTC 双检测机制深度解析

原创2026-10-24 10:51:332,146 阅读

Now Playing 如何识别你正在听的歌?窗口标题 + SMTC 双检测机制深度解析

Now Playing 是一款面向直播与桌面的「正在播放」歌曲展示工具,支持检测网易云音乐、QQ 音乐、Spotify 等 20+ 款音乐软件的歌曲信息。它究竟如何实时识别你正在听哪首歌、歌曲是播放还是暂停?答案正是它内置的窗口标题检测与 SMTC(System Media Transport Controls) 双检测机制。下面带你从源码层面拆解这套识别原理。

Now Playing 正在播放歌曲识别工具项目横幅

总览:一个 C# 程序 + 一个 Java 后端

整个识别链路分工非常清晰,核心检测工作由一个独立的 C# 程序 GetMusicStatus.exe 完成,Java 后端(Spring Boot)负责调度与结果分发:

音乐软件 ──> 窗口标题 / SMTC(二选一方案)
              │
              ▼
      GetMusicStatus.exe(C# 检测程序,每 100ms 轮询)
              │  输出:播放状态 + 歌名 - 歌手
              ▼
      AudioService(Java 后端,逐行解析)
              │
              ▼
   调用平台搜索 API 补全封面歌词 / 封装成 /query 接口 ──> OBS 等直播软件

Now Playing 歌曲识别执行流程图:GetMusicStatus 通过窗口标题或 SMTC 检测音乐软件

Java 侧由 AudioService.java 负责启动 C# 子进程,并用一个常驻线程逐行读取它的标准输出;一旦收到 Playing、Paused 或歌曲标题变化,就会立即发布事件通知前端刷新。检测程序本身则定义在 Program.cs 中,它为每个平台注册了一个独立的 MusicService 实现(共 20+ 个平台),轮询间隔默认 100ms,状态变化时立即输出,否则每秒输出一次心跳。

接下来分别深入这两种检测方式。

方案一:窗口标题检测——从窗口标题里"读"出歌名

对大多数音乐软件来说,主窗口的标题栏天然就是"歌名 - 歌手",例如 Lush - Four Tet。窗口标题检测正是利用这一点。

第一步:找到正在出声的进程。 程序通过 Windows 核心音频 API(CSCore 库)枚举当前音频设备上的所有音频会话,按进程名前缀匹配目标软件,比如 QQMusic、cloudmusic、Spotify。之所以从"音频会话"入手而不是直接找进程,是因为同一设备可能有多个软件在出声,而它只关心"正在播放声音"的那个。

第二步:读取窗口标题。 拿到进程后,WindowDetector.cs 通过 Windows API EnumWindows + GetWindowText(user32.dll)读取窗口标题,并且使用 Unicode 接口避免中文编码乱码。

第三步:判断播放还是暂停。 这是最巧妙的地方——程序读取该进程音频会话的音量峰值(AudioMeterInformation.PeakValue):音量大于 0 说明歌曲在出声,判定为 Playing;音量归零则判定为 Paused。无需监听任何事件,一次采样即可。

窗口标题检测的三大"坑"与对策,以 QQMusicService.cs 为例:

场景 问题 对策
软件最小化到托盘 主窗口标题变空 遍历该进程的所有窗口,取第一个包含 - 的标题
开启桌面歌词/精简模式 主窗口标题不再是歌曲信息 同上,全窗口遍历兜底
Spotify 暂停时 标题变为 "Spotify Free" 把上次有效标题写入缓存文件,暂停期间读缓存

第三点详见 SpotifyMusicService.cs:当标题包含 - 就写入 spotify_title.cache,否则从缓存还原,保证暂停瞬间歌名不丢失。

网易云音乐还有一项独门绝技:通过 UI Automation 读取主窗口进度文本(MM:SS / MM:SS),因此能实时捕捉到拖动进度条的动作,详见 NeteaseMusicHelper.cs 与 NeteaseMusicService.cs。它还在进度读取上做了"1.5 秒短暂失联抑制"——拖动进度条时音频会话可能瞬时断开,若最近 1.5 秒内有过有效输出就继续沿用旧结果,避免把瞬时抖动放大成"切歌"事件。

方案二:SMTC——Windows 原生的歌曲信息通道

SMTC(System Media Transport Controls)是 Windows 10/11 的媒体会话接口:音乐软件播放时会主动向系统上报歌名、歌手、封面、播放状态和进度(你按 Win + Ctrl + M 打开的媒体控制面板用的就是它)。Now Playing 通过 WindowsMediaController 库订阅所有媒体会话,从中"截获"目标软件上报的信息。

以 QQMusicSMTC.cs 为例,SMTC 检测分三步:

  1. 监听会话开关:注册 OnAnySessionOpened / OnAnySessionClosed 事件,当会话 ID 包含 QQMusic、qqmusic 或 QQ音乐 关键字时,锁定为该软件的会话;软件关闭时自动置空。
  2. 直接读取歌曲属性:通过 TryGetMediaPropertiesAsync 拿到结构化数据——Title(歌名)、Artist(歌手),不再依赖标题字符串解析,天然规避了"歌名里带 - 会被截断"的问题。
  3. 补齐播放状态与封面:部分软件(如 QQ 音乐)不打开媒体控制面板时 SMTC 状态不刷新,因此播放/暂停仍回退到音量峰值判断;而封面由播放器异步上报,切歌瞬间可能拿到旧图,所以程序在检测到歌名变化后会后台重新拉取校验封面(ThumbnailHelper.UpdateThumbnailAsync),确认更新后才保存。

MusicServices/SMTC/ 目录下共有 14 个 SMTC 实现,覆盖 QQ 音乐、酷狗、Spotify、Apple Music、YouTube Music、浏览器及各类本地播放器。其中 BrowserSMTC.cs 值得一提:网页播放器会把浏览器的 MediaSession 桥接到 Windows SMTC,因此用 Now Playing 检测网页音乐同样精准,且能直接拿到精确进度。

为什么默认优先 SMTC? 启动参数 --smtc 默认为 true(见 Program.cs 中的平台映射表):支持 SMTC 的平台会优先创建 SMTC 版本的服务,关闭该开关后才回退到窗口标题检测。SMTC 提供的信息更结构化、更稳定,这也是它成为首选的原因。

独立运行示例:亲眼看看检测输出

GetMusicStatus.exe 可以脱离主程序单独运行,快速验证检测效果。在命令行执行:

GetMusicStatus.exe --platform netease

输出格式固定为两行一组:第一行是播放状态(Playing / Paused / None),第二行是 歌名 - 歌手:

GetMusicStatus.exe 独立运行输出示例:展示正在播放歌曲识别结果

常用参数(源码注释见 Program.cs):

参数 默认值 说明
--platform netease 要检测的音乐平台(如 qq、spotify)
--smtc true 是否优先使用 SMTC 识别
--device-id default 仅检测指定音频设备,默认检测默认设备
--poll-interval 100 轮询间隔(ms),建议 100~1000

针对支持进度同步的平台(如网易云音乐),还会额外输出一行 Progress:currentSec|totalSec;读取失败时自动回退为两行输出,保证兼容性。

检测结果如何流向直播软件

C# 程序输出的歌曲信息被 Java 后端接管后,NowPlayingService.java 会做两件事:

  1. 补全信息:调用网易云、QQ 音乐等平台的搜索 API,用识别出的歌名 + 歌手反查封面、歌词等完整数据;
  2. 封装接口:把结果封装成 GET /api/query 等 REST 接口,内置服务器本地部署,OBS 的浏览器源加载对应 URL 即可实时显示歌曲卡片、滚动歌词。

同时 Java 侧每 5 秒用 CheckMusicProcess.exe 检查首选平台是否仍在运行;若开启了备选平台(fallbackPlatform),主软件关闭时会自动切换检测目标,无需手动干预。

Now Playing API 接口调试台:/api/query 接口实时返回识别到的歌曲信息

双机制小结:各自的优势与分工

维度 窗口标题检测 SMTC 检测
信息来源 窗口标题栏字符串 系统媒体会话(结构化数据)
歌曲解析 依赖 歌名 - 歌手 格式 直接取 Title / Artist 字段
额外信息 无(歌名歌手靠标题) 封面缩略图、部分平台进度
播放/暂停 音量峰值判断 优先 SMTC 状态,兜底音量峰值
适用面 几乎所有桌面软件 需软件主动上报媒体会话
稳定性 受窗口标题格式影响 受软件实现影响(状态可能不刷新)

两种机制互为备份:SMTC 优先,拿不到会话或信息异常时自动回退窗口标题。再加上音量峰值判定、1.5 秒失联抑制、进度文本 UIA 读取等细节打磨,Now Playing 才能在 100ms 级轮询下做到切歌即时响应、暂停精准捕捉——这就是它"歌随声动,词随曲行"的底层支撑。

如果你想深入某款平台的适配细节,可以逛逛 MusicServices/ 目录下每个平台的独立实现;而 GetMusicStatus.exe 的命令行参数与输出协议,则是二次开发时最值得关注的契约。

登录后查看全文
now-playing-service