[插件发布] 设备电量 Device Battery｜在 Ulanzi 按键上显示无线设备电量
大家好，我开发了一款适用于 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 版本
[*]设备连接方式
[*]插件日志
[*]属性面板截图
[*]按键显示截图
也欢迎拥有罗技无线鼠标、键盘或耳机的用户关注后续测试版本，并反馈不同型号的兼容情况。感谢大家的测试和支持。
页:
[1]