如何实时掌握罗技无线鼠标电量:LGSTrayBattery 系统托盘电量监控完整指南

原创2026-11-15 10:23:50953 阅读
文章标签:桌面应用硬件开发

如何实时掌握罗技无线鼠标电量:LGSTrayBattery 系统托盘电量监控完整指南

LGSTrayBattery 是一款开源的 Windows 系统托盘电量监控工具,帮助你在任务栏实时掌握罗技无线鼠标的电量。它以轻量级托盘应用的形式常驻运行,图标与提示框实时显示电池百分比、电压和充电状态,并内置 HTTP API 方便脚本读取电量数据。本指南将带你快速了解它的核心功能、数据源配置与常用参数,几分钟即可上手。🔋

一、核心功能一览:托盘图标 + 实时电量

安装运行后,LGSTrayBattery 会在系统托盘显示一个电池图标:

  • 实时电量提示:鼠标悬停即可查看设备名称、电量百分比和电压(若设备支持)
  • 响应式图标:图标会随设备类型(鼠标、键盘、耳机)、系统浅色/深色主题、充电状态自动切换
  • 多设备模式:右键托盘图标可选择同时监控多台设备,每台设备拥有独立图标
  • 数字显示模式:可将图标切换为直接显示电量百分比的数字样式(此时不显示充电状态)
  • 开机自启:右键菜单中可一键设置开机自动运行

右键菜单还支持重新检测设备(Rediscover)与退出应用等操作,日常使用基本无需打开任何窗口。相关界面实现见 LGSTrayUI/NotifyIconViewModel.cs。

二、两种电量数据来源:G Hub 与 Native HID

从 v3.0 开始,LGSTrayBattery 提供两条电量数据链路,可分别启用或关闭:

数据源 说明 电量字段 电压字段 mileage
GHub(Logitech G Hub 的 WebSocket) 需要安装 Logitech G Hub ✅ ❌ ✅
Native HID(内置 hidapi 协议解析) 无需第三方软件,支持热插拔 ✅ ✅(取决于设备) ❌
  • GHub 使用罗技 G Hub 专为设备定制的电量查找表,百分比通常更贴近官方口径
  • Native HID 基于 3.7V 锂电池的平均放电曲线估算,因此两者读数可能略有差异,属正常现象
  • 若某设备(如 G533 耳机)通过 Native 未被识别,可切换回 GHub 数据源试试

对应实现分别位于 LGSTrayCore/Managers/GHubManager.cs 与 LGSTrayCore/Managers/LGSTrayHIDManager.cs。

三、内置 HTTP API:用脚本轻松读取鼠标电量

这是 LGSTrayBattery 的一个亮点功能:默认开启一个本地 HTTP 服务,监听 localhost:12321,方便你用脚本、看板程序获取电量。

  • 访问 http://localhost:12321/(或 /devices):查看当前所有设备列表
  • 访问 http://localhost:12321/device/{设备ID或名称}:返回该设备的 XML 数据,包含 battery_percent、battery_voltage、charging、last_update 等字段

LGSTrayBattery 系统托盘电量监控 HTTP API 设备列表页面截图

页面底部还显示当前 LGSTray 版本号。路由实现见 LGSTrayCore/HttpServer/HttpController.cs,XML 字段生成逻辑见 LGSTrayCore/LogiDevice.cs。

💡 提示:dev 开头的设备 ID 来自 GHub 数据源,纯数字 ID 来自 Native HID,两者的可用字段略有不同。

四、appsettings.toml 配置文件详解

所有配置集中在托盘程序目录下的 LGSTrayUI/appsettings.toml 中(TOML 语法,字符串需加双引号)。若配置格式错误,启动时会弹窗询问是否重置为默认值。

配置项 默认值 说明
[UI] enableRichToolTips true 是否显示富文本提示框
[HTTPServer] enabled / addr / port true / localhost / 12321 HTTP 开关、绑定地址与端口;有管理员权限时可设为 0.0.0.0 供外部访问
[GHub] enabled true 是否启用 G Hub 数据源
[Native] enabled true 是否启用 Native HID 数据源
[Native] retryTime 10 设备查询失败(通常是设备休眠)后的重试间隔(秒)
[Native] pollPeriod 600 成功查询后下次轮询间隔(秒),建议保持较高值,避免干扰设备省电休眠
[Native] disabledDevices [] 按名称片段排除问题设备,如 ["G403"]

配置结构定义可参考 LGSTrayPrimitives/AppSettings.cs。

五、已知问题与设备兼容性

来自 readme.md 的官方说明,使用前值得了解:

  • 电量百分比差异:Native HID 与 GHub 的计算方式不同(平均曲线 vs 设备查找表),两者读数不一致属正常
  • 有线模式 G403:有线连接时可能一次请求触发多次电量轮询
  • G533 等耳机:Native 协议可能识别不到,建议改用 GHub 数据源
  • 已确认兼容:G403 Wireless、MX Anywhere 2(社区反馈的其他型号欢迎补充测试)

六、获取与运行

LGSTrayBattery 基于 .NET 8 / WPF 开发,仅适用于 Windows。发布打包脚本 publish.py 支持两种构建配置:

  • Framedep:依赖已安装的 .NET 运行时,体积更小
  • Standalone:独立发布,目标机器无需安装运行时

日常使用只需解压发行包、双击运行即可,所有行为均可通过托盘右键菜单与 appsettings.toml 调整,无需复杂部署。🖱️

总结

LGSTrayBattery 用最简洁的方式解决了罗技无线设备电量不透明的问题:托盘实时图标 + 双数据源 + 本地 HTTP API。无论是只想看一眼鼠标还有多少电,还是想把电量接入自己的自动化脚本,它都能以极低的资源占用满足需求。

登录后查看全文
LGSTrayBattery