[插件发布] 智能音量控制器

hbybyyang

Ulanzi 团队你们好，

我为 Ulanzi Deck 开发了一款开源的实用插件，名为**"智能音量控制器 (Smart Volume)"**，希望能申请将其发布到 Ulanzi 插件商店中。



## 插件功能 (What it does)

许多用户在使用电脑时，经常遇到多任务并行的场景（比如边打游戏边在后台听歌，或者边看视频边语音）。当想要单独调节某个特定软件的音量时，传统的"切出当前窗口 -> 打开系统音量合成器 -> 鼠标寻找并拖拽滑块 -> 再切回工作/游戏"流程非常繁琐且极其打断沉浸感。 本插件旨在解决这一痛点——用户可以在完全不切换当前窗口焦点、不中断手头工作的前提下，直接通过 Ulanzi Deck 的物理旋钮，实现各种场景下音量的精准独立调节：

全局控制：常规左右旋转，调节系统全局主音量。
前台追随：按下并旋转，智能识别当前屏幕前台激活的应用，并仅对该应用进行音量调节（非常适合打游戏时盲操）。
后台控制 (OSD 列表模式)：
- 双击旋钮，呼出包含所有发声进程的OSD 屏幕悬浮列表。
- 在列表中，旋转可上下滚动。
- 此时单击旋钮可锁定选中的应用（金色高亮），然后直接通过常规旋转来控制该应用音量。
- 3 秒无操作或再次双击将自动退出并隐藏 OSD 列表。

## 工作原理 (How it works)

核心动作：将音量控制与旋钮操作（旋转、按下旋转、双击、单击）深度绑定。
原生驱动：底层由 C# 编写，完全原生接管 Windows CoreAudio API，纯净无依赖，无需调用任何第三方体积臃肿的 EXE 工具。
本地命名管道 (Named Pipe) IPC：插件 Node.js 后台与 C# 渲染前端之间采用 Windows 命名管道极速通信，达到零轮询开销与毫无卡顿的顺滑瞬时响应。
生命周期绑定：OSD 渲染程序 volume-osd.exe 会在插件启动时静默拉起并预热，随 Ulanzi Studio 关闭而自动安全销毁。

## 运行要求 (Requirements)

- 操作系统：仅支持 Windows（底层深度依赖 Windows CoreAudio 接口与 WPF 框架）。
- 客户端：Ulanzi Studio。

## 相关链接 (Links)

- 源码仓库：https://github.com/lsby/ulanzi-deck-smart-volume
- 提审链接：https://ugc.ulanzistudio.com/con ... &title=Smart+Volume

麻烦团队帮忙审核一下这次的提交，如果插件在代码规范、交互设计或功能实现上有任何需要调整或改进的地方，请随时告诉我，我会尽快配合修改。

非常感谢！

Ulanzi

@hbybyyang  您好

我们又见面了！

距离您发布第一款“网页视频控制器”插件还不久，这么快又迎来了您的第二款作品——Smart Volume（智能音量控制）。作为国内第三位、也是目前持续产出速度最快的插件开发者。

您的插件路线非常清晰——解决创作者在工作流中真实遇到的痛点。如果说第一款插件帮助用户“看得更顺畅”，那么这一款就是帮助用户“听得更舒服”。

后续上架官方市场，硬件测试支持，我们会按流程尽快安排，再次感谢您对社区的贡献！

祝开发愉快！

——Ulanzi Studio 团队

Robinsv8

这个插件的音量控制，是否可以支持只绑定一个特定App，专门只调节它的音量啊 ？不管它在前台，还是后台，旋钮只会控制这个App的播放音量。

hbybyyang

Robinsv8 发表于 2026-7-9 16:41
这个插件的音量控制，是否可以支持只绑定一个特定App，专门只调节它的音量啊 ？不管它在前台，还是后台，旋 ...

可以的 我已经发布了1.0.1版本, 增加了默认应用的控制.
在列表页面(双击旋钮时出现), 定位到想设置的应用上, 再次双击, 则可设置该应用为默认应用.
等列表页面消失后, 直接旋转旋钮, 会调整默认应用的音量.
如果想还原, 只需要将系统音量设置为默认应用即可.