wx.onBLECharacteristicValueChange(function callback)

基础库 2.9.2 开始支持,低版本需做兼容处理

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

参数

function callback

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

参数

Object res
属性类型说明
deviceIdstring蓝牙设备 id
serviceIdstring蓝牙特征值对应服务的 uuid
characteristicIdstring蓝牙特征值的 uuid
valueArrayBuffer特征值最新的值

示例代码

在开发者工具中预览效果

  1. // ArrayBuffer转16进制字符串示例
  2. function ab2hex(buffer) {
  3. let hexArr = Array.prototype.map.call(
  4. new Uint8Array(buffer),
  5. function(bit) {
  6. return ('00' + bit.toString(16)).slice(-2)
  7. }
  8. )
  9. return hexArr.join('');
  10. }
  11. wx.onBLECharacteristicValueChange(function(res) {
  12. console.log(`characteristic ${res.characteristicId} has changed, now is ${res.value}`)
  13. console.log(ab2hex(res.value))
  14. })