Flutter BLE设备特征值编写与SOS按钮监听及断连问题排查

一、特征值统一设计方案 #

对接多款BLE设备（手表、SOS按钮等），核心是统一服务与特征值规范，避免适配混乱：

• 服务UUID：用自定义128位UUID（避开标准服务冲突），比如0000FFE0-0000-1000-8000-00805F9B34FB，要求所有设备统一使用这个服务标识
• SOS触发特征值UUID：配套自定义128位UUID，比如0000FFE1-0000-1000-8000-00805F9B34FB，特征属性必须开启NOTIFY（支持设备主动推送事件），可选READ（用于查询当前状态）
• 数据格式：用极简字节格式保证兼容性：
  • 单字节：0x00=无触发，0x01=SOS按钮点击
  • 进阶版可加时间戳：[0x01, 0xAB, 0xCD]表示SOS触发，时间戳为0xABCD（根据设备能力调整）
• 强制统一：要求所有对接设备严格遵循上述规范，客户端只需监听固定特征值，无需适配不同设备的差异

二、现有代码的问题修复 #

你的代码存在3个核心问题，导致无响应+自动断开，修改如下：

1. 精准定位目标特征值，避免遍历所有服务 #

遍历所有服务/特征值会浪费资源，还可能误操作其他特征导致设备断开，直接定位到SOS服务和特征值：

onTapSwitch: () async {
  // 替换为你和设备厂商约定的UUID
  const sosServiceUuid = '0000FFE0-0000-1000-8000-00805F9B34FB';
  const sosCharUuid = '0000FFE1-0000-1000-8000-00805F9B34FB';

  try {
    // 连接时禁用自动重连，设置超时避免僵死
    await device.connect(autoConnect: false, timeout: const Duration(seconds: 10));
    
    final services = await device.discoverServices();
    
    // 找到SOS服务
    final sosService = services.firstWhere(
      (s) => s.uuid.toString() == sosServiceUuid,
      orElse: () => throw Exception('未找到SOS服务'),
    );
    
    // 找到SOS特征值
    final sosChar = sosService.characteristics.firstWhere(
      (c) => c.uuid.toString() == sosCharUuid,
      orElse: () => throw Exception('未找到SOS特征值'),
    );
    
    // 可选：读取初始状态
    final initialValue = await sosChar.read();
    print('当前SOS状态: $initialValue');
    
    // 开启通知监听
    await sosChar.setNotifyValue(true);
    sosChar.value.listen((value) {
      // 解析数据，判断是否触发SOS
      if (value.isNotEmpty && value[0] == 0x01) {
        print('SOS按钮被触发！');
      } else {
        print('收到数据: $value');
      }
    }, onError: (err) {
      print('监听出错: $err');
    });
    
  } catch (e) {
    print('操作失败: $e');
    // 出错时主动断开设备
    if (device.isConnected) await device.disconnect();
  }
});

2. 解决设备自动断开问题 #

设备自动断开通常是因为连接超时无交互，或者设备端配置问题：

• 加心跳包：每隔几秒读取一次SOS特征值，保持连接活性（在开启监听后添加）：

  Timer.periodic(const Duration(seconds: 5), (timer) async {
    if (!device.isConnected) {
      timer.cancel();
      return;
    }
    try {
      await sosChar.read();
    } catch (e) {
      print('心跳失败: $e');
      timer.cancel();
      await device.disconnect();
    }
  });
  

• 检查设备端配置：联系厂商确认设备的BLE连接超时时间、连接间隔是否合理，部分设备固件bug会导致通知异常后断开
• 连接参数优化：部分设备需要指定连接间隔，可通过BLE库的高级API设置（比如flutter_blue_plus的connectionParameters）

3. 其他必查项 #

• 权限：Android要申请BLUETOOTH_CONNECT、BLUETOOTH_SCAN权限，iOS要在Info.plist中添加NSBluetoothAlwaysUsageDescription
• 连接状态监听：注册设备连接状态回调，处理断开后的重连逻辑
• 线程：BLE操作必须在异步线程执行，避免阻塞UI

内容的提问来源于stack exchange，提问作者Dastan Kerimkulov