XB1ControllerBatteryIndicator 使用指南

1. 功能总览：认识你的Xbox手柄电池管家

XB1ControllerBatteryIndicator是一款系统托盘应用，专为Xbox系列手柄设计，能够实时显示电池电量状态并在电量过低时发送通知提醒。就像给手柄配备了一位24小时电量管家，让你在游戏关键时刻不会因突然断电而中断体验。

核心功能包括：

• 系统托盘动态电量图标显示（支持1-4号手柄独立监测）
• 多语言界面支持（含中文、英文、日文等20种语言）
• 低电量自动通知提醒
• 有线/无线连接状态识别
• 后台静默运行模式

2. 核心组件解析：程序的"五脏六腑"

2.1 核心文件地图

XB1ControllerBatteryIndicator/
├── 🔧 启动核心
│   ├── App.xaml.cs         # 应用入口点，如同程序的"启动钥匙"
│   └── Bootstrapper.cs     # 初始化配置，好比"系统启动引导程序"
├── 🖥️ 用户界面
│   ├── MainWindow.xaml.cs  # 主窗口控制器，管理用户交互
│   ├── SystemTrayView.xaml # 托盘图标视图，负责电量图标显示
│   └── SystemTrayViewModel.cs # 托盘逻辑处理，决定显示哪个电量图标
├── 🌐 本地化系统
│   ├── Localization/       # 多语言资源包，支持全球20种语言
│   └── TranslationManager.cs # 语言切换控制器，如同"多语言翻译官"
└── ⚙️ 配置系统
    ├── current_version.xml # 版本配置文件，程序的"身份证"
    └── Settings.cs         # 用户偏好设置，存储你的使用习惯

2.2 关键文件详解

App.xaml.cs

• 功能定位：应用程序的"大脑中枢"，负责启动整个程序
• 用户交互场景：双击程序时首先运行的文件，决定程序如何启动
• 修改注意事项：除非需要更改启动行为，否则不建议修改此文件

SystemTrayViewModel.cs

• 功能定位：托盘图标的"指挥中心"，处理电池状态逻辑
• 用户交互场景：当手柄电量变化时，此文件决定显示哪种电量图标
• 修改注意事项：修改可能导致电量显示错误，建议先备份原文件

current_version.xml

• 功能定位：程序的"出生证明"，记录版本信息
• 用户交互场景：程序启动时自动读取，用于版本验证和更新检查
• 修改注意事项：手动修改可能导致程序无法识别版本，建议通过官方更新渠道升级

3. 3分钟快速启动的3个关键步骤

3.1 首次运行向导

1. 获取程序

   git clone https://gitcode.com/gh_mirrors/xb1/XB1ControllerBatteryIndicator
   

2. 启动应用

   • 进入XB1ControllerBatteryIndicator/XB1ControllerBatteryIndicator目录
   • 双击XB1ControllerBatteryIndicator.exe（Windows系统）
   • 首次运行会弹出语言选择窗口，选择你偏好的语言（如"中文(简体)"）

3. 验证运行状态

   • 查看系统托盘区是否出现电池图标（默认在屏幕右下角）
   • 连接Xbox手柄，图标应显示当前电量状态
   • 右键点击托盘图标，确认菜单正常显示

3.2 后台运行模式

🔧 设置开机启动

1. 右键点击系统托盘图标
2. 选择"设置" → "常规"选项卡
3. 勾选"开机自动启动"
4. 点击"应用"保存设置

⚠️ 注意：后台运行时，程序不会显示主窗口，仅在系统托盘保持活动。如需打开设置界面，只需双击托盘图标即可。

4. 配置指南：打造你的个性化电池管家

4.1 新手安全配置区

这些设置不会影响程序核心功能，适合初次使用的用户：

语言设置

1. 双击托盘图标打开主窗口
2. 点击顶部"语言"下拉菜单
3. 选择所需语言（如"中文(台湾)"）
4. 程序会自动重启以应用语言设置

通知设置

1. 打开设置界面
2. 切换到"通知"选项卡
3. 调整低电量通知阈值（建议保持默认的20%）
4. 勾选"电量低于阈值时显示通知"

4.2 高级参数调优

对于有经验的用户，可以通过修改配置文件进行高级设置：

修改检查更新频率

编辑current_version.xml文件：

<Configuration>
  <Version>1.0.0</Version>
  <UpdateURL>http://example.com/update</UpdateURL>
  <!-- 以下为高级设置 -->
  <UpdateCheckInterval>24</UpdateCheckInterval> <!-- 检查更新间隔（小时） -->
  <NotificationDuration>10</NotificationDuration> <!-- 通知显示时间（秒） -->
</Configuration>

自定义电量图标

1. 准备48x48像素的ICO格式图标文件
2. 命名格式：battery_[状态]_[手柄编号].ico（如battery_full_one.ico）
3. 替换Resources目录下的对应文件
4. 重启程序使图标生效

5. 常见问题诊断树

问题：托盘图标不显示

• 检查1：程序是否正在运行（任务管理器中查看进程）
  • 是 → 尝试重启资源管理器
  • 否 → 检查程序是否被安全软件阻止
• 检查2：手柄是否已连接
  • 是 → 尝试重新拔插手柄
  • 否 → 连接手柄后等待10秒

问题：电量显示不正确

• 检查1：是否使用原装Xbox手柄
  • 是 → 进入设置界面执行"电池校准"
  • 否 → 部分第三方手柄可能不支持电量检测
• 检查2：无线连接是否稳定
  • 是 → 尝试更新手柄固件
  • 否 → 靠近接收器或减少干扰源

问题：通知不弹出

• 检查1：系统通知设置是否允许该程序发送通知
  • 是 → 检查通知阈值是否设置过高
  • 否 → 在系统设置中启用通知权限
• 检查2：是否勾选了"静音模式"
  • 是 → 取消勾选恢复通知
  • 否 → 重启程序尝试修复

6. 总结：让手柄电量尽在掌握

通过本指南，你已经了解了XB1ControllerBatteryIndicator的核心功能、配置方法和问题排查技巧。这款轻量级工具能让你在游戏过程中实时掌握手柄电量状态，避免因突然断电而影响游戏体验。

无论是休闲玩家还是竞技高手，一个可靠的电池指示器都是提升游戏体验的重要辅助工具。现在就启动程序，让你的Xbox手柄从此告别"突然死亡"的尴尬时刻！