Version: next

Taro.onBLECharacteristicValueChange(callback)

监听低功耗蓝牙设备的特征值变化事件。必须先启用 notifyBLECharacteristicValueChange 接口才能接收到设备推送的 notification。

参考文档

类型

(callback: Callback) => void

参数

Callback

低功耗蓝牙设备的特征值变化事件的回调函数

(result: CallbackResult) => void
参数类型
result
CallbackResult

CallbackResult

参数类型说明
characteristicId
string
蓝牙特征值的 uuid
deviceId
string
蓝牙设备 id
serviceId
string
蓝牙特征值对应服务的 uuid
value
ArrayBuffer
特征值最新的值

示例代码

// ArrayBuffer转16进制字符串示例
function 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 支持度

API微信小程序H5React Native
Taro.onBLECharacteristicValueChange✔️