# wx.notifyBLECharacteristicValueChange(Object object)

基础库 1.1.0 开始支持，低版本需做兼容处理。

以 Promise 风格调用：支持

小程序插件：支持，需要小程序基础库版本不低于 1.9.6

微信鸿蒙 OS 版：支持

相关文档: 蓝牙低功耗 (BLE)

# 功能描述

启用蓝牙低功耗设备特征值变化时的 notify 功能，订阅特征。注意：必须设备的特征支持 notify 或者 indicate 才可以成功调用。

另外，必须先启用 wx.notifyBLECharacteristicValueChange 才能监听到设备 characteristicValueChange 事件

# 参数

# Object object

属性	类型	默认值	必填	说明	最低版本
deviceId	string		是	蓝牙设备 id
serviceId	string		是	蓝牙特征对应服务的 UUID
characteristicId	string		是	蓝牙特征的 UUID
state	boolean		是	是否启用 notify
type	string	indication	否	设置特征订阅类型，有效值有 `notification` 和 `indication`	2.4.0
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）

# 错误

错误码	错误信息	说明
0	ok	正常
-1	already connect	已连接
10000	not init	未初始化蓝牙适配器
10001	not available	当前蓝牙适配器不可用
10002	no device	没有找到指定设备
10003	connection fail	连接失败
10004	no service	没有找到指定服务
10005	no characteristic	没有找到指定特征
10006	no connection	当前连接已断开
10007	property not support	当前特征不支持此操作
10008	system error	其余所有系统上报的异常
10009	system not support	Android 系统特有，系统版本低于 4.3 不支持 BLE
10012	operate time out	连接超时
10013	invalid_data	连接 deviceId 为空或者是格式不正确

# 注意

订阅操作成功后需要设备主动更新特征的 value，才会触发 wx.onBLECharacteristicValueChange 回调。
安卓平台上，在本接口调用成功后立即调用 wx.writeBLECharacteristicValue 接口，在部分机型上会发生 10008 系统错误

# 示例代码

在开发者工具中预览效果

wx.notifyBLECharacteristicValueChange({
  state: true, // 启用 notify 功能
  // 这里的 deviceId 需要已经通过 createBLEConnection 与对应设备建立链接
  deviceId,
  // 这里的 serviceId 需要在 getBLEDeviceServices 接口中获取
  serviceId,
  // 这里的 characteristicId 需要在 getBLEDeviceCharacteristics 接口中获取
  characteristicId,
  success (res) {
    console.log('notifyBLECharacteristicValueChange success', res.errMsg)
  }
})