第三方应用开发
小程序
基础
连接微信
办公
JS-SDK
基础
连接微信
办公
第三方应用开发
客户端API
JS-SDK
蓝牙(BLE)
启用BLE设备特征值订阅
启用BLE设备特征值订阅
最后更新:2024/11/13

目录

  • ww.notifyBLECharacteristicValueChange(params)
  • 功能描述
  • 参数说明
  • params: Object
  • 返回说明
  • 使用说明
  • 旧版jweixin调用
  • 示例代码
  • ww.notifyBLECharacteristicValueChange(params)

    兼容性:企业微信

    功能描述

    启用低功耗蓝牙设备特征值变化时的 notify 功能,订阅特征值。

    ww.notifyBLECharacteristicValueChange({
      deviceId: deviceId,
      serviceId: serviceId,
      characteristicId: characteristicId,
      state: true
    })

    参数说明

    params: Object

    属性类型必填说明
    deviceIdstring

    蓝牙设备 ID

    需要已经通过 createBLEConnection 与对应设备建立链接

    serviceIdstring

    蓝牙特征值对应服务的 uuid

    需要通过 getBLEDeviceServices 接口获取

    characteristicIdstring

    蓝牙特征值的 uuid

    需要通过 getBLEDeviceCharacteristics 接口获取

    stateboolean

    是否启用 notify

    successFunction

    成功回调

    failFunction

    失败回调

    cancelFunction

    取消回调

    completeFunction

    完成回调

    返回说明

    Promise<Object>

    属性类型必填说明
    errMsgstring

    通用错误信息

    errCodenumber

    通用错误码

    使用说明

    • 设备的特征值必须支持 notify 或者 indicate 才可以成功调用,具体参照 characteristic 的 properties 属性

    • 订阅操作成功后需要设备主动更新特征值的 value 才会触发 onBLECharacteristicValueChange 回调

    • 安卓平台上,在调用 notify 成功后立即调用 write 接口,在部分机型上会发生 10008 系统错误

    旧版jweixin调用

    示例代码

    wx.notifyBLECharacteristicValueChange({
      state: true, // 启用 notify 功能
      // 这里的 deviceId 需要已经通过 createBLEConnection 与对应设备建立链接  
      deviceId: deviceId,
      // 这里的 serviceId 需要在上面的 getBLEDeviceServices 接口中获取
      serviceId: serviceId,
      // 这里的 characteristicId 需要在上面的 getBLEDeviceCharacteristics 接口中获取
      characteristicId: characteristicId,
      success: function (res) {
        console.log('notifyBLECharacteristicValueChange success', res.errMsg)
      }
    })
    上一篇写入BLE设备特征值数据
    下一篇监听BLE设备特征值变化
      本节内容
    服务端API
    基础
    数据与智能专区
    应用接收专区通知
    连接微信
    客户联系
    办公
    小程序接入对外收款
    客户端API
    小程序
    基础
    连接微信
    办公
    JS-SDK
    基础
    连接微信
    办公
    更新日志
    联系我们