XB1ControllerBatteryIndicator 使用指南

一、功能解析

🔍核心要点：控制器电池监控与通知提醒

1.1 核心功能

定义：Xbox风格控制器电池状态监控工具
作用：实时显示电池电量，低电量时发送通知
注意事项：需保持程序在系统托盘运行

1.2 功能模块关系

┌───────────────┐      ┌───────────────┐      ┌───────────────┐
│  系统托盘模块  │◄────►│ 电池检测模块  │◄────►│ 通知提醒模块  │
└───────────────┘      └───────────────┘      └───────────────┘
        ▲                      ▲                      ▲
        │                      │                      │
        └──────────────────────┼──────────────────────┘
                               │
                      ┌───────────────┐
                      │ 本地化支持模块  │
                      └───────────────┘

1.3 支持特性

• 多语言界面切换
• 四种电池状态显示（满电/中等/低电量/空电）
• 有线连接状态识别

二、快速上手

🔍核心要点：3分钟完成安装与基础使用

2.1 获取项目

执行命令：git clone https://gitcode.com/gh_mirrors/xb1/XB1ControllerBatteryIndicator

2.2 启动应用

双击运行 XB1ControllerBatteryIndicator/XB1ControllerBatteryIndicator.exe，程序将自动最小化到系统托盘。

2.3 基本操作

• 查看状态：点击托盘图标查看当前电池状态
• 切换语言：右键菜单选择语言选项
• 退出程序：右键菜单选择退出

三、深度配置

🔍核心要点：自定义应用行为与外观

3.1 配置版本信息

编辑 current_version.xml 文件：

<Configuration>
  <Version>1.0.0</Version> <!-- 默认值：1.0.0 -->
  <UpdateURL></UpdateURL>  <!-- 默认值：空，修改风险：可能影响更新检测 -->
</Configuration>

3.2 管理语言资源

语言文件路径：Localization/Strings.[语言代码].resx
操作方法：编辑对应语言文件修改界面文本

3.3 更换托盘图标

图标文件位置：Resources/ 目录下
注意事项：替换图标需保持相同命名格式，建议尺寸48x48像素

四、常见问题

🔍核心要点：解决使用中的典型问题

4.1 控制器未检测

检查控制器连接状态，确保驱动正常安装

4.2 通知不显示

确认系统通知权限已开启，检查应用是否被系统防火墙阻止

4.3 语言切换无效

重启应用后再次尝试，确保对应语言文件存在