AirBattery项目中的蓝牙设备重复显示问题分析与解决方案

问题背景

在macOS平台上，AirBattery作为一款优秀的电池状态监控工具，能够显示蓝牙设备的电量信息。但在实际使用中，部分用户反馈他们的蓝牙耳机(如Bose系列)会在AirBattery中出现重复显示的情况。这种现象不仅影响界面美观，也可能导致电量信息显示不准确。

技术原因分析

经过深入分析，我们发现这一问题源于macOS系统的蓝牙设备管理机制：

1. 双重发现机制：macOS会通过两种方式发现蓝牙设备

   • 传统蓝牙连接(Classic Bluetooth)
   • 低功耗蓝牙广播(BLE)

2. 设备识别差异：同一物理设备可能被系统识别为两个逻辑设备

   • 传统蓝牙连接显示为"设备名称"(如"Bose Headphones")
   • 低功耗蓝牙广播显示为"LE-设备名称"(如"LE-Bose Headphones")

3. AirBattery的扫描策略：应用会同时从系统信息和BLE广播中获取设备信息，导致同一设备被重复捕获

解决方案演进

初始方案：BLE黑名单功能

AirBattery最初版本提供了BLE设备黑名单功能，用户可以将"LE-"前缀的设备加入黑名单。但这一方案存在局限性：

• 只能屏蔽BLE设备
• 无法灵活选择保留哪种连接方式
• 可能导致设备完全不可见(当屏蔽错误选项时)

优化方案：全设备黑名单机制

在1.4.9版本中，开发团队对黑名单功能进行了重要改进：

1. 扩展黑名单范围：不再局限于BLE设备，可屏蔽任何类型的蓝牙设备
2. 更灵活的配置：用户可根据实际情况选择保留传统连接或BLE连接
3. 操作建议：
   • 对于Bose耳机，建议屏蔽"Bose Headphones"保留"LE-Bose Headphones"
   • 重启应用使更改生效

设备图标支持

开发团队还收集了常见蓝牙设备的厂商ID和产品ID，计划为更多设备添加专属图标(类似AirPods的定制显示)。这需要用户提供以下信息：

• 厂商ID(Vendor ID)
• 产品ID(Product ID)

这些信息可通过macOS系统报告中的蓝牙部分获取，将帮助开发团队完善对不同品牌设备的支持。

未来优化方向

基于用户反馈，开发团队考虑进一步改进设备管理功能：

1. 可视化设备管理界面：将黑名单改为可勾选的设备列表
2. 排序与分组功能：让用户自定义设备显示顺序
3. 智能去重机制：自动识别并合并同一设备的不同连接方式

总结

AirBattery通过持续迭代，逐步解决了蓝牙设备重复显示的问题。1.4.9版本的全设备黑名单机制为用户提供了更灵活的配置选项。随着更多设备信息的收集，未来版本将提供更精准的设备识别和更美观的显示效果。用户遇到类似问题时，可尝试更新到最新版本，并根据实际需求配置黑名单。