本地音乐播放器。C++17 / Win32 原生单进程,常驻后台约 78–86 MB 工作集 / 1 个进程(上一版 WebView2 是 455 MB / 7 个进程)。单文件不到 500 KB,无可执行依赖。
上一版用 WebView2 做界面,界面改起来舒服,但内存实测:
| 工作集 | 私有提交 | 进程数 | |
|---|---|---|---|
| WebView2 版 | 455 MB | 230 MB | 7(含 Chromium 的 browser / gpu / renderer) |
| 原生版(初版) | 73 MB | 46 MB | 1 |
| 原生版(现在) | 78–86 MB | 52–57 MB | 1 |
口径说明:工作集包含系统 DLL 的共享映射,任务管理器「内存」列显示的是私有工作集, 同一时刻可能只有 30 多 MB。三个口径都不矛盾,但别混着比。 连续切 40 首后稳定在 86 MB 左右(10 首 +4.4 MB,20 首 +1.3 MB,30 首 +0.6 MB,40 首持平), 之后播放/暂停反复切换零增长,不是泄漏。
Chromium 的基线摆在那,把 --enable-low-end-device-mode、--disable-gpu 全试过,只省 10%,
GPU 进程 134 MB 还关不掉。所以把 Chromium 整个拿掉。
文件 ──IMFSourceReader──▶ float32 PCM ──▶ 环形缓冲(2s) ──IAudioRenderClient──▶ 输出端点
(Media Foundation 解码+重采样) │
└──▶ 单声道抽样 ──FFT──▶ 频谱柱
- 解码:Media Foundation。系统自带,mp3 / aac(m4a) / flac / wav / wma 都能解, 重采样交给 MF 的 Audio Resampler。解码输出优先要 float32(解码器不给才退 16 位整数), ring 内部统一按 float 存,不再走 16 位量化。
- 输出:WASAPI,事件驱动,20 ms 缓冲。共享模式用设备混音格式;独占模式按源采样率协商。 解码线程和渲染线程用一条 2 秒的环形缓冲隔开。
- 设备生命周期:跟进程一样长。切歌只换
IMFSourceReader,不重建IAudioClient; 设备没有被拔掉、默认端点没变,就一直复用。渲染线程发现GetCurrentPadding失败时 不会静默退出,而是置一个标志让 UI 重建链路,回到原来的位置和播放状态。 - 界面:Direct2D + DirectWrite 全自绘,没有任何控件库。
- 线程模型:进程是 MTA(WASAPI 的 COM 对象要跨线程用)。但 Windows 的文件夹选择框 依赖 STA,在 MTA 里调用会直接卡死且不弹窗,所以选择器跑在一个临时的 STA 线程上, 结果通过 tick 回收到 UI 线程。
- 频谱:对解码出来的 PCM 做 2048 点 FFT(汉宁窗),对数分频成 52 柱, 再做 88 分位自动增益 + 快起慢落包络——参数和上一版 WebAudio 对齐,观感一致。
- 本地曲库:递归扫盘,自解析 ID3v2/v1 与 FLAC 标签(标题、歌手、专辑、时长、内嵌封面)
- 输出设备可选:控制行点设备名,浮层里选「跟随系统默认 / 耳机 / 扬声器 / HDMI」, 选择写进配置;选中的设备被拔掉会自动退回默认并提示
- 独占模式:
E键在共享 / 独占之间切换。独占绕过 Windows 混音器,代价是这期间 别的程序没有声音;设备不支持时静默回退共享(默认关闭,详见下面「音质」) - 频谱可视化:跟音乐实时跳动,暂停时自然落下
- 迷你模式:点最小化不是缩进任务栏,而是变成桌面右下角置顶小条,频谱照旧,可拖动,小窗里也有一条音量滑条;任务栏图标会一直保留,点它能把小条叫回前台
- 顺序 / 单曲 / 随机,进度拖动,音量,记住上次播放(记住的是文件路径,删歌后不会串到别的曲子)
- 曲库可删可恢复:移除误加的目录、移除单曲、单条或全部恢复,都只改曲库和配置,不删磁盘文件
- 深色标题栏(DWM 原生),跟随系统 DPI 缩放
音频链路里真正会损失的地方只有两处:解码输出被压成 16 位,以及系统的重采样。
- 第一处已经改掉:解码优先要 float32,设备混音格式是 float32 时整条链路不做量化。
- 第二处取决于设备和模式。共享模式下 Windows 会把所有程序的声音混成设备格式, 44.1 kHz 的源在 48 kHz 的设备上会被重采样一次;独占模式让 MF 直接按设备支持的 采样率输出,绕过混音器。
但要诚实:对 16 bit / 44.1 kHz 的 MP3 和普通 FLAC,两种模式基本听不出差别。
只有 24/96 以上的高解析文件 + 独立 DAC,独占才有实际意义。所以它默认关闭,用 E 手动切。
| 键 | 作用 |
|---|---|
Space |
播放 / 暂停 |
← → |
快退 / 快进 5 秒 |
↑ ↓ |
音量(主界面、迷你窗都可用;小窗里也能直接拖音量条) |
M |
迷你模式 / 还原 |
E |
共享 / 独占模式切换(立刻重开当前曲目,保持位置) |
Esc |
从迷你模式还原;关掉设备浮层 |
PgUp PgDn |
上一首 / 下一首 |
双击 dist/Pulse.exe。首次启动扫「音乐」文件夹,空的就点右上角添加文件夹。
也可以直接把文件夹拖到 exe 上,等价于「添加文件夹」;路径会写进配置,下次启动自动带上。
- 移除整个目录:点列表头的管理文件夹 → 点该目录右侧的 ×。目录会从配置里删掉并立即重新扫盘,下次启动不会再自动加回来;想加回来就再点一次「添加文件夹」。
- 移除某一首:在曲库里把鼠标移到那一行,点右端出现的 ×。路径会记进配置的
exclude=,重新扫描、重启都不会回来。 - 恢复:管理面板里每条移除记录右侧有恢复,右上角还有全部恢复 N 首;移错的目录用「添加文件夹」加回即可。
以上操作只影响曲库和配置,不会删除磁盘上的音频文件。配置在 %LOCALAPPDATA%\Pulse\config.txt,
也可以直接手动删掉对应的 folder= / exclude= 行(改完重启生效)。
移除当前正在播的那首会停下来、选中相邻一首但不自动播放。
python build.py编译器用 MinGW-w64(g++ 16.2.0 UCRT),脚本按顺序找 toolchain/mingw64/bin/、
D:/WorkSpace/bilidownload/toolchain/mingw64/bin/。链接 d2d1 dwrite windowscodecs mfplat mfreadwrite mfuuid dwmapi shlwapi,全部是 Windows 自带组件。
src/
main.cpp 窗口、消息循环、键盘、迷你模式、配置
audio.h 设备枚举 / MF 解码 + WASAPI 渲染 + 环形缓冲 + 设备失效恢复
spectrum.h FFT、对数分频、自动增益
ui.h Direct2D 绘制、命中测试、封面解码
tags.h ID3v2/v1、FLAC 标签与封面偏移、时长估算
library.h 扫目录建曲库
util.h 编码转换、路径、时间
tools/drive.py 开发用:启动 + 点击 + 截图(ctypes,无第三方 GUI 库)
docs/ 截图
- ape / dsd 不支持:Windows 自带解码器没有它们,扫盘时直接跳过。要支持得自己链 FFmpeg。
- 独占默认关闭:设备不支持协商的格式时会回退共享(界面上会提示);独占期间其他程序没有声音。
- 不记播放位置:只记曲目路径,下次启动从 0 开始。
- 没有全局媒体键 / SMTC:得先切回窗口才能按空格。
- 曲库列表里的时长对 VBR mp3 是按首帧码率估算的,播放一次后会换成 MF 的真实时长。
- 只做本地文件,不碰在线音源。
MIT。播放的音乐版权归各自权利人所有,本许可不涵盖音乐内容。

