ap.getBLEDeviceCharacteristics 获取蓝牙设备所有特征值

优质

小牛编辑

130浏览

2023-12-01

ap.getBLEDeviceCharacteristics(OPTION | deviceId, CALLBACK)

获取蓝牙设备所有 characteristic（特征值）。

OPTION 参数说明

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

CALLBACK 参数说明

名称	类型	描述
characteristics	Array	设备特征值列表

characteristic 对象

蓝牙设备 characteristic （特征值）信息

名称	类型	描述
characteristicId	String	蓝牙设备特征值的 uuid
serviceId	String	蓝牙设备特征值对应服务的 uuid
value	Hex String	蓝牙设备特征值对应的16进制值
properties	Object	该特征值支持的操作类型

properties 对象

名称	类型	描述
read	boolean	该特征值是否支持 read 操作
write	boolean	该特征值是否支持 write 操作
notify	boolean	该特征值是否支持 notify 操作
indicate	boolean	该特征值是否支持 indicate 操作

错误码说明

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.getBLEDeviceCharacteristics({
      // 这里的 deviceId 需要在 getBluetoothDevices 或 onBluetoothDeviceFound 接口中获取
      deviceId: 'deviceId',
      // 这里的 serviceId 需要在 getBLEDeviceServices 接口中获取
      serviceId: 'serviceId',
      success: function(res){
        ap.alert('此服务共有' + res.characteristics.length + '个特征值');
      },
      fail: function(res) {
        ap.showToast('获取失败');
      }
    });
  });
</script>