notifyBLECharacteristicValueChange

title: Taro.notifyBLECharacteristicValueChange(option)

sidebar_label: notifyBLECharacteristicValueChange

Enables the notify feature when characteristics of a BLE device change to subscribe to characteristics. Note: The device characteristics must support notify or indicate to use this method.

In addition, you must enable notifyBLECharacteristicValueChange to listen on the device characteristicValueChange event.

Notes

• After a successful subscription, the device must actively update the value of the characteristic to trigger the Taro.onBLECharacteristicValueChange callback.
• On the Android platform, if the writeBLECharacteristicValue API is called right after the call to notifyBLECharacteristicValueChange, some device models will report a 10008 system error.

Reference

Type

(option: Option) => Promise<Promised>

Parameters

Promised

Option

Sample Code

Taro.notifyBLECharacteristicValueChange({
  state: true, // Enable the notify feature
  // This deviceId must have been used to connect the appropriate device via createBLEConnection.
  deviceId,
  // This serviceId must be obtained in the getBLEDeviceServices API.
  serviceId,
  // This characteristicId must be obtained in the getBLEDeviceCharacteristics API.
  characteristicId,
  success: function (res) {
    console.log('notifyBLECharacteristicValueChange success', res.errMsg)
  }
})

API Support