[插件发布] 设备电量 Device Battery｜在 Ulanzi 按键上显示无线设备电量

logic_lc

大家好，我开发了一款适用于 Ulanzi Studio 的 Windows 插件：

设备电量 / Device Battery

这款插件用于在 Ulanzi 设备按键上显示无线外设的电池电量和充电状态。

项目主要面向 Razer 雷蛇与 Logitech 罗技无线设备。目前首个公开版本已经完成 Razer Synapse 4 的适配和人工测试，Logitech G HUB 支持正在开发和实机验证中，将在后续版本开放。

当前已人工验证设备：

Razer Basilisk V3 Pro 35K

当前功能

• 显示雷蛇无线设备当前电量
• 显示正在充电状态
• 动态电池图形
• 可显示或隐藏电量百分比
• 可显示或隐藏设备名称
• 可设置刷新周期
• 设备离线时显示明确状态
• 每个按键独立保存设备和显示设置
• 完全本地运行
• 不需要联网
• 不上传设备信息
  

雷蛇设备支持

当前版本通过读取 Razer Synapse 4 的本地设备状态，获取雷蛇无线设备的电量和充电状态。

插件不会直接控制设备，也不会修改雷云文件。只要设备能够在 Razer Synapse 4 中正常显示电量，插件就有机会识别并显示。

目前已经完成实机验证：

Razer Basilisk V3 Pro 35K

其他支持 Razer Synapse 4 的无线设备也可能正常工作，但由于暂未逐一进行实机测试，欢迎大家反馈具体型号的使用结果。

罗技设备支持

插件已经为 Logitech G HUB 设备预留了支持架构。

后续版本计划实现：

• 识别 Logitech G HUB 中的无线设备
• 显示罗技鼠标、键盘和耳机电量
• 显示充电状态
• 支持 LIGHTSPEED 等无线设备
• 在 G HUB 数据不可用时研究 HID++ 后备读取方案
• 对不同罗技设备进行实机兼容性验证
  

由于当前还没有合适的罗技测试设备，首个公开版本暂不将罗技功能标记为正式可用。

Banner 和插件介绍中出现 Logitech 标识，代表插件的后续支持方向，不代表当前版本已经完成所有罗技设备适配。

使用要求

当前雷蛇功能需要：

• Windows 10 或更高版本
• Ulanzi Studio
• Razer Synapse 4
• 雷云中能够正常看到目标设备和电量
• Razer Synapse 4 保持正常运行
  

后续罗技功能预计需要：

• Logitech G HUB
• 被 G HUB 正常识别的无线罗技设备
  

使用方法

• 安装并打开 Razer Synapse 4。
• 确认雷云中能够看到设备及其电量。
• 在 Ulanzi Studio 中安装“设备电量”插件。
• 将“雷蛇设备电量”动作拖到按键上。
• 打开属性面板，点击“刷新设备”。
• 选择需要显示的设备。
• 设置是否显示设备名称、电量百分比和刷新周期。
  

选择设备后，按键会自动显示当前状态。

设备正在充电时，会显示充电标志；设备从雷云当前状态中消失时，会显示“已离线”。

隐私说明

本插件完全在电脑本地运行。

插件不会：

• 修改 Razer Synapse 或 Logitech G HUB 文件
• 上传设备名称
• 上传设备序列号
• 上传电量信息
• 连接第三方云服务
• 收集用户隐私信息
  

雷蛇功能只读取 Razer Synapse 4 在本地生成的设备状态。

后续罗技功能也将坚持本地读取原则。

当前版本限制

当前版本主要完成并验证了 Razer Synapse 4 支持。

需要注意：

• 目前只对 Razer Basilisk V3 Pro 35K 完成了实机测试
• 其他雷蛇设备可能因 Synapse 版本或设备状态格式不同而存在差异
• Razer Synapse 4 未运行时，插件可能无法获取设备电量
• Logitech G HUB 支持仍在开发和实机验证中
• Xbox 控制器支持仍在开发中
• 其他品牌只计划支持 Windows 系统本身能够显示电量的蓝牙设备
• 暂不支持其他品牌的私有 2.4 GHz 无线接收器协议
  

后续开发计划

后续版本计划加入：

• Logitech G HUB 设备电量
• Logitech HID++ 后备支持
• 更多雷蛇设备适配
• Xbox 控制器电量
• Windows 蓝牙设备电量
• 简体中文、繁体中文、英语、日语和德语
• 更多按键显示样式
• 更完善的设备状态和错误提示
  

下载

当前版本：0.1.0

问题反馈

反馈问题时，请尽量提供：

• Windows 版本
• Ulanzi Studio 版本
• 设备品牌和型号
• Razer Synapse 或 Logitech G HUB 版本
• 设备连接方式
• 插件日志
• 属性面板截图
• 按键显示截图
  

也欢迎拥有罗技无线鼠标、键盘或耳机的用户关注后续测试版本，并反馈不同型号的兼容情况。

感谢大家的测试和支持。