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 操作 |
错误码说明
代码示例
<script src="https://gw.alipayobjects.com/as/g/h5-lib/alipayjsapi/3.1.1/alipayjsapi.inc.min.js"></script>
<button id="J_btn" class="btn btn-default">获取设备特征值</button>
<script>
var btn = document.querySelector('#J_btn');
btn.addEventListener('click', function(){
ap.getBLEDeviceCharacteristics({
deviceId: 'deviceId',
serviceId: 'serviceId',
success: function(res){
ap.alert('此服务共有' + res.characteristics.length + '个特征值');
},
fail: function(res) {
ap.showToast('获取失败');
}
});
});
</script>
其他说明
- 建立连接后先执行 my.getBLEDeviceServices 与 my.getBLEDeviceCharacteristics 后再进行与蓝牙设备的数据交互。