LGSTrayBattery：无线罗技鼠标电池监控的终极解决方案

LGSTrayBattery：无线罗技鼠标电池监控的终极解决方案

【免费下载链接】LGSTrayBattery A tray app used to track battery levels of wireless Logitech mouse. 项目地址: https://gitcode.com/gh_mirrors/lg/LGSTrayBattery

你是否厌倦了不断猜测无线罗技鼠标的剩余电量？或者经常在关键时刻发现鼠标突然没电？LGSTrayBattery 正是为你量身定制的免费开源工具！这个托盘应用程序能够实时监控无线罗技鼠标的电池水平，通过系统托盘图标直观显示电量百分比，让你随时掌握设备状态。

为什么选择LGSTrayBattery？ 🚀

在众多电池监控工具中，LGSTrayBattery 凭借其独特优势脱颖而出：

双重数据源支持：同时支持原生HID接口和Logitech G Hub WebSocket两种方式获取电池信息，确保最大兼容性。

智能主题适配：自动适应系统明暗主题，图标和界面随系统主题实时变化，提供无缝的用户体验。

多设备管理：支持同时监控多个罗技设备，无论是鼠标、键盘还是耳机，都能在托盘中一目了然。

轻量级设计：作为托盘应用，资源占用极小，不影响系统性能，常驻后台默默工作。

快速安装指南 📦

方法一：预编译版本（推荐新手）

1. 访问项目发布页面，下载最新的 -standalone 版本
2. 解压到任意目录，无需安装.NET运行时
3. 双击 LGSTrayUI.exe 即可启动

方法二：源码编译（适合开发者）

git clone https://gitcode.com/gh_mirrors/lg/LGSTrayBattery
cd LGSTrayBattery
dotnet build

确保系统已安装.NET 8.0或更高版本。编译完成后，在 LGSTrayUI/bin/Debug/net8.0-windows 目录中找到可执行文件。

核心功能详解 🎯

1. 智能托盘图标系统

LGSTrayBattery 的托盘图标不仅仅是简单的电池图标，它具备以下智能特性：

• 设备类型识别：自动识别鼠标、键盘、耳机等不同设备类型，显示对应的图标
• 实时充电状态：充电时图标会变化，让你一眼就能看出设备是否在充电
• 数字百分比显示：支持数字模式，直接在图标上显示精确的电量百分比

同时监控多个设备时的托盘图标显示效果

2. 丰富的上下文菜单

右键点击托盘图标，你将看到详细的设备信息菜单：

• 所有已连接设备的电池百分比
• 电压信息（如果设备支持）
• 设备类型和名称
• 快速切换显示模式选项

3. HTTP服务器API

LGSTrayBattery 内置了一个轻量级HTTP服务器，默认在 localhost:12321 端口运行。这个功能特别适合：

• 远程监控：通过浏览器访问设备列表
• 自动化集成：其他程序可以通过API获取电池信息
• 数据可视化：将电池数据集成到仪表板中

通过浏览器访问本地服务器查看设备列表

访问 http://localhost:12321/ 即可查看所有可用设备，每个设备都有唯一的ID和名称。

4. 灵活的配置选项

配置文件 LGSTrayUI/appsettings.toml 让你可以完全定制应用行为：

[HTTPServer]
enabled = true
addr = "localhost"
port = 12321

[GHub]
enabled = true

[Native]
enabled = true

retryTime = 10
pollPeriod = 600

关键配置说明：

• retryTime：设备查询失败后的重试间隔（秒）
• pollPeriod：设备状态更新周期（秒），建议保持较高值以避免干扰设备休眠
• disabledDevices：遇到兼容性问题时，可以在此列表中禁用特定设备

实用技巧与优化建议 💡

1. 延长电池寿命的设置

为了最大化无线设备的电池寿命，建议进行以下配置：

pollPeriod = 1800  # 将轮询间隔增加到30分钟

较长的轮询间隔可以减少设备唤醒次数，从而延长电池使用时间。

2. 解决兼容性问题

如果某个设备导致应用不稳定，可以将其添加到禁用列表：

disabledDevices = [
    "G403",
    "G502"
]

只需包含设备名称的一部分即可生效。

3. 启用外部访问

如果你希望通过其他设备监控电池状态，可以修改服务器绑定地址：

addr = "0.0.0.0"  # 允许所有网络接口访问

注意：这需要管理员权限，并确保网络环境安全。

常见问题解答 ❓

Q：为什么原生HID和G Hub显示的电量百分比不同？

A：这是正常的！原生HID使用3.7V锂电池的平均曲线计算百分比，而G Hub使用设备特定的查找表。两种方法都有其合理性，你可以根据偏好选择信任的数据源。

Q：我的设备没有被检测到怎么办？

A：尝试以下步骤：

1. 确保设备已连接且电源打开
2. 检查是否安装了Logitech G Hub（如果需要G Hub支持）
3. 尝试重启应用
4. 查看 disabledDevices 列表是否误禁用了你的设备

Q：HTTP服务器有什么实际用途？

A：HTTP服务器功能非常实用，例如：

• 在家庭服务器上运行，通过浏览器远程查看所有设备的电池状态
• 集成到Home Assistant等智能家居系统中
• 创建自定义的电池监控仪表板

Q：应用占用多少系统资源？

A：LGSTrayBattery 设计为轻量级应用，通常占用不到50MB内存和极少的CPU资源，对系统性能影响微乎其微。

支持的设备列表 🖱️

经过测试支持的设备：

• G403 Wireless（无线模式）
• MX Anywhere 2

社区测试过的设备（需要重新验证）：

• 各种罗技无线鼠标
• 部分罗技无线键盘
• 兼容HID++协议的罗技耳机

高级功能：自定义开发 🛠️

对于开发者，LGSTrayBattery 提供了丰富的扩展可能性：

1. 通过API获取设备数据

curl http://localhost:12321/device/dev00000000

返回的XML文档包含设备名称、电池百分比、电压等信息。

2. 区分数据源

设备ID以 dev 开头的数据来自Logitech G Hub驱动，而随机数字ID来自原生HID++实现。两者提供的数据字段略有不同：

字段	G Hub	原生HID
设备ID	✔️	✔️
设备名称	✔️	✔️
设备类型	✔️	✔️
电池百分比	✔️	✔️
电池电压	❌	✔️*
里程估计	✔️	❌

*取决于设备支持情况

性能优化建议 ⚡

1. 合理设置轮询间隔：对于不常使用的设备，可以设置较长的 pollPeriod 值
2. 选择性启用数据源：如果只使用G Hub，可以禁用原生HID以减少资源占用
3. 使用数字模式：数字图标比图形图标更节省系统资源

结语

LGSTrayBattery 解决了无线罗技设备用户的一个痛点问题——电池状态不透明。无论你是普通用户还是技术爱好者，这个工具都能为你提供准确、实时的电池监控体验。

它的开源特性意味着你可以根据自己的需求进行定制，活跃的社区也在不断改进和扩展功能。现在就去尝试 LGSTrayBattery，告别电池焦虑，享受无忧的无线使用体验！

小提示：首次运行后，建议花几分钟时间熟悉配置选项，根据你的使用习惯进行个性化设置，这将大大提升使用体验。记得定期检查更新，开发者会不断改进功能和修复问题。🎯

【免费下载链接】LGSTrayBattery A tray app used to track battery levels of wireless Logitech mouse. 项目地址: https://gitcode.com/gh_mirrors/lg/LGSTrayBattery