ESP32 BLE启用PROPERTY_NOTIFY时InTheHand BLE无法识别特征值

该报错是ESP32端BLE特征值配置不符合BLE规范导致的：仅给特征值声明PROPERTY_NOTIFY属性，但没有挂载标准的客户端特征配置描述符（CCC, 固定UUID 0x2902）。Windows系统原生BLE栈（InTheHand.BluetoothLE库底层调用的就是系统栈）对规范合规性校验严格，只要特征值声明支持通知/指示能力，就会强制校验对应CCC描述符是否存在，缺失时就会在枚举特征值阶段抛出"设备无法识别该命令"的错误，这也是去掉NOTIFY标志后异常消失的原因。

不需要移除特征值的NOTIFY属性，只需要补全缺失的CCC描述符配置即可，步骤如下：

• 保留原有特征值创建逻辑，READ/WRITE/NOTIFY属性组合不需要修改
• 特征值创建完成后，为其挂载标准BLE2902类型的CCC描述符
• 后续发送通知时，先调用setValue()写入要发送的数据，再调用notify()方法推送给已订阅的客户端即可

完整参考代码：

// 创建特征值，原有属性配置保持不变
pCharacteristic = pService->createCharacteristic(
                                     CHARACTERISTIC_UUID,
                                     BLECharacteristic::PROPERTY_READ
                                     | BLECharacteristic::PROPERTY_WRITE
                                     | BLECharacteristic::PROPERTY_NOTIFY
                                   );

// 关键补全代码：添加标准CCC描述符，这是之前缺失的核心步骤
pCharacteristic->addDescriptor(new BLE2902());

// 可选配置：如果需要默认开放通知权限，可以按如下方式初始化描述符
// BLE2902* cccDesc = new BLE2902();
// cccDesc->setNotifications(true); // 允许客户端开启通知
// pCharacteristic->addDescriptor(cccDesc);

• 不要用自定义UUID的描述符代替标准0x2902 CCC描述符，系统栈无法识别自定义描述符，依然会触发枚举错误。
• 该配置兼容所有标准BLE客户端，包括安卓、iOS、Windows的原生BLE接口和通用BLE调试工具，不需要在客户端做特殊适配。
• 配置完成后Windows端可正常调用await serv.GetCharacteristicsAsync()枚举特征值，后续开启通知订阅、接收数据的流程均可正常执行。

内容的提问来源于stack exchange，提问作者Ben Emanuel