title: Taro.onBLECharacteristicValueChange(callback)
sidebar_label: onBLECharacteristicValueChange
Listens on the BLE device characteristic change event. You must enable notifyBLECharacteristicValueChange to receive notifications pushed by devices.
Type
(callback: Callback) => void
Parameters
Callback
The callback function for the BLE device characteristic change event.
(result: CallbackResult) => void
| Property | Type | 
|---|---|
| result | CallbackResult | 
    
CallbackResult
| Property | Type | Description | 
|---|---|---|
| characteristicId | string | 
      The Bluetooth characteristic UUID | 
| deviceId | string | 
      The Bluetooth device ID | 
| serviceId | string | 
      The UUID of the service corresponding to a Bluetooth characteristic | 
| value | ArrayBuffer | 
      The latest value of a characteristic | 
Sample Code
// Example of an ArrayBuffer converted to a hexadecimal stringfunction ab2hex(buffer) {let hexArr = Array.prototype.map.call(new Uint8Array(buffer),function(bit) {return ('00' + bit.toString(16)).slice(-2)})return hexArr.join('');}Taro.onBLECharacteristicValueChange(function (res) {console.log(`characteristic ${res.characteristicId} has changed, now is ${res.value}`)console.log(ab2hex(res.value))})
API Support
| API | WeChat Mini-Program | H5 | React Native | 
|---|---|---|---|
| Taro.onBLECharacteristicValueChange | ✔️ | 
