Skip to content
ParkerlimpsPublic

About

羽量级RAM占用的播放器——为常驻后台设计的本地音乐播放器 · 原生单进程 75 MB 内存,C++17 / Direct2D / WASAPI 全自绘

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

6 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Pulse

本地音乐播放器。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。播放的音乐版权归各自权利人所有,本许可不涵盖音乐内容。

About

羽量级RAM占用的播放器——为常驻后台设计的本地音乐播放器 · 原生单进程 75 MB 内存,C++17 / Direct2D / WASAPI 全自绘

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages