小程序蓝牙开发

以下是小程序蓝牙开发的实现流程和关键要点，综合多个技术文档整理而成：

一、基础开发流程

‌初始化蓝牙模块‌
- 调用 wx.openBluetoothAdapter 初始化蓝牙适配器，开启手机蓝牙功能‌。
- 监听蓝牙状态变化（如适配器不可用需提示用户）‌。
‌设备搜索与发现‌
- 安卓设备需先开启 GPS 定位权限‌。
- 调用 wx.startBluetoothDevicesDiscovery 启动设备搜索，通过 wx.onBluetoothDeviceFound 监听新设备并存储到列表‌。
- 建议设置定时器（如 10 秒超时），搜索完成后调用 wx.stopBluetoothDevicesDiscovery 释放资源‌。
‌设备连接与交互‌
- 用户选择设备后，通过 wx.createBLEConnection 建立连接，并监听 wx.onBLEConnectionStateChange 处理连接状态变化‌。
- 连接前需确保已断开之前的连接（避免多次连接冲突）‌。
‌获取服务与特征值‌
- 调用 wx.getBLEDeviceServices 获取设备服务列表，再通过 wx.getBLEDeviceCharacteristics 获取特征值 UUID‌。
- 启用特征值 notify 功能（wx.notifyBLECharacteristicValueChange）以监听数据变化‌。
‌数据读写操作‌
- ‌写入数据‌：调用 wx.writeBLECharacteristicValue 向设备发送指令‌。
- ‌读取数据‌：通过 wx.onBLECharacteristicValueChange 监听设备返回的数据‌。

二、关键开发注意事项

‌角色与模式‌
- 手机默认为中心设备（Central），负责扫描和连接外围设备（Peripheral），后者持续广播但不可主动搜索‌。
‌通信协议规范‌
- 需遵循 BLE 协议层级结构：服务（Service）→ 特征值（Characteristic）→ 描述符（Descriptor）‌。
- 特征值需明确读写属性（如 read、write、notify）‌。
‌兼容性处理‌
- iOS 和安卓的差异：安卓需 GPS 定位支持，iOS 需用户手动授权蓝牙权限‌。
- 设备 UUID 需严格遵循规范（16/32/128 位格式）‌。
‌资源释放‌
- 退出页面或断开连接时，需关闭蓝牙适配器（wx.closeBluetoothAdapter）并停止搜索/监听事件‌。
‌调试工具‌
- 使用微信开发者工具模拟蓝牙设备，或通过真机调试日志排查通信问题‌。

三、参考实现代码片段


wx.({
  :  {
    
    wx.({
      :  {
        wx.( {
          
        });
      }
    });
  }
});


wx.({
  : ,
  :  {
    
    wx.({ deviceId, :  {  } });
  }
});