XB1ControllerBatteryIndicator 使用指南：零基础玩转Xbox手柄电池管理

一、核心功能解析：三大场景解决手柄续航痛点

1.1 低电量智能预警

当Xbox手柄电量低于预设阈值时，系统会自动弹出通知提醒（通过[SystemTrayViewModel.cs]实现）。程序会根据电池剩余电量分级显示不同图标，从满电到低电量状态直观可见，避免游戏中突然断电的尴尬。

1.2 多设备并行管理

支持同时连接多个Xbox手柄，每个设备在系统托盘（Tray Icon）区域显示独立的电池状态图标。通过图标上的数字标识（如电池图标旁的"1"、"2"）区分不同手柄，轻松掌握所有设备电量情况。

1.3 后台运行优化

程序启动后自动最小化至系统托盘，不占用任务栏空间（通过[MainWindow.xaml.cs]控制窗口行为）。采用低资源占用设计，即使长时间运行也不会影响游戏性能，让你专注于游戏体验。

💡小贴士：双击系统托盘图标可快速打开主界面，查看详细的电池状态信息；右键点击图标可打开功能菜单，进行退出程序等操作。

二、快速上手：三步启动法零基础入门

2.1 环境检查

🔧 第一步：确认电脑已安装.NET Framework运行环境（程序依赖Windows系统组件）。 🔧 第二步：从仓库克隆项目代码：

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

🔧 第三步：检查项目目录结构完整性，确保[XB1ControllerBatteryIndicator]文件夹下包含所有必要文件。

2.2 参数配置

🔧 第一步：打开项目根目录下的[current_version.xml]文本配置文件。 🔧 第二步：确认基础配置信息，默认内容如下：

<Configuration>
  <Version>1.0.0</Version>
  <UpdateURL>http://example.com/update</UpdateURL>
</Configuration>

⚠️ 注意：首次使用无需修改配置，保持默认值即可正常运行。

2.3 运行验证

🔧 第一步：进入[XB1ControllerBatteryIndicator]文件夹，双击执行主程序。 🔧 第二步：观察系统托盘区域，应出现电池图标。 🔧 第三步：连接Xbox手柄，图标会实时显示当前电池状态。 ✅ 预期结果：系统托盘出现电池图标，连接手柄后显示对应电量状态，低电量时弹出通知提醒。

三、深度配置：五大高频问题Q&A

Q1: 如何自定义版本号？

A1: 编辑[current_version.xml]文件，修改<Version>节点值即可。例如：

<Version>2.0.0</Version>

修改后重启程序生效，版本号将用于程序内部标识。

Q2: 能否调整低电量预警阈值？

A2: 可以通过修改[Settings.cs]文件中的LowBatteryThreshold参数实现，默认阈值为20%。找到以下代码段进行调整：

public static int LowBatteryThreshold { get; set; } = 20;

Q3: 如何更换通知音效？

A3: 1. 将自定义音效文件放入[Resources]文件夹； 2. 打开[SystemTrayViewModel.cs]，找到通知触发代码； 3. 修改音频文件引用路径为新音效文件名称。

⚠️ 注意：仅支持WAV格式音频文件，建议文件大小不超过500KB。

Q4: 程序能否随系统自动启动？

A4: 可以通过Windows任务计划程序实现：

1. 打开"任务计划程序"创建基本任务；
2. 触发器选择"登录时"；
3. 操作选择"启动程序"，浏览选择主程序路径；
4. 完成设置后，下次开机将自动启动程序。

Q5: 如何切换语言显示？

A5: 程序支持多语言切换，通过[Localization]文件夹中的语言资源文件实现。在程序设置界面选择对应语言即可，支持包括中文、英文、日文等在内的多种语言。

💡小贴士：如果需要添加新的语言支持，可以复制[Strings.resx]文件并命名为"Strings.语言代码.resx"，然后翻译其中的文本内容。

通过以上功能解析、快速上手和深度配置，即使是零基础用户也能轻松掌握XB1ControllerBatteryIndicator的使用方法。程序小巧实用，是Xbox手柄用户的必备工具，让你彻底告别低电量焦虑，尽情享受游戏乐趣。