ap.readBLECharacteristicValue 读取低功耗蓝牙设备特征值中的数据

优质

小牛编辑

133浏览

2023-12-01

ap.readBLECharacteristicValue(OPTION, CALLBACK)

读取低功耗蓝牙设备特征值中的数据。调用后在 ap.onBLECharacteristicValueChange() 事件中接收数据返回。

OPTION 参数说明

名称	类型	必填	描述
deviceId	String	是	蓝牙设备 id，参考 device 对象
serviceId	String	是	蓝牙特征值对应 service 的 uuid
characteristicId	String	是	蓝牙特征值的 uuid

CALLBACK 参数说明

名称	类型	描述
characteristic	Object	设备特征值信息

characteristic对象

蓝牙设备characteristic(特征值)信息

名称	类型	描述
characteristicId	String	蓝牙设备特征值的 uuid
serviceId	String	蓝牙设备特征值对应服务的 uuid
value	Hex String	蓝牙设备特征值的 value

错误码说明

error	描述
12	读取数据失败

代码示例

<script src="https://gw.alipayobjects.com/as/g/h5-lib/alipayjsapi/3.1.1/alipayjsapi.inc.min.js"></script>

<button class="btn btn-default">读取设备特征值</button>
<script>
  var btn = document.querySelector('#J_btn');
  btn.addEventListener('click', function(){
    ap.readBLECharacteristicValue({
      // 这里的 deviceId 需要在 getBluetoothDevices 或 onBluetoothDeviceFound 接口中获取
      deviceId: 'deviceId',
      // 这里的 serviceId 需要在 getBLEDeviceServices 接口中获取
      serviceId: 'serviceId',
      // 这里的 characteristicId 需要在 getBLEDeviceCharacteristics 接口中获取
      characteristicId: 'characteristicId',
      success: function(res){
        ap.alert('正在读取，请在 ap.onBLECharacteristicValueChange 事件中接收');
      },
      fail: function(res) {
        ap.showToast('读取数据指令失败');
      }
    });
  });
</script>