服务商代开发
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
服务商代开发
客户端API
WECOM-JSSDK
蓝牙(BLE)
启用BLE设备特征值订阅
启用BLE设备特征值订阅
最后更新:2023/02/23

目录

  • ww.notifyBLECharacteristicValueChange(params)
  • 功能描述
  • 参数说明
  • params: Object
  • 返回说明
  • 使用说明
  • 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 系统错误

    上一篇写入BLE设备特征值数据
    下一篇监听BLE设备特征值变化
      本节内容
    服务端API
    基础
    数据与智能专区
    应用接收专区通知
    连接微信
    客户联系
    办公
    客户端API
    小程序
    基础
    连接微信
    办公
    WECOM-JSSDK
    JS-SDK
    基础
    连接微信
    办公
    更新日志
    联系我们