ap.getBluetoothDevices 获取所有已发现的蓝牙设备
优质
小牛编辑
126浏览
2023-12-01
ap.getBluetoothDevices(OPTION | services | service, CALLBACK)
获取所有已发现的蓝牙设备，包括已经和本机处于连接状态的设备。可直接传入一个数组作为 OPTION.services 参数。也可直接传入一个字符串作为 OPTION.services 的第一项。
OPTION 参数说明
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| services | Array | 否 | 蓝牙设备主 service 的 uuid 列表 |
CALLBACK 参数说明
| 名称 | 类型 | 描述 |
|---|---|---|
| devices | Array | service 的 uuid 对应的(如果有传入 services)设备列表 |
device对象说明
| 名称 | 类型 | 描述 |
|---|---|---|
| name | String | 蓝牙设备名称，某些设备可能没有 |
| deviceName（兼容旧版本） | String | 值与 name 一致 |
| localName | String | 广播设备名称 |
| deviceId | String | 设备 Id |
| RSSI | Number | 设备信号强度 |
| advertisData | Hex String | 设备的广播内容 |
错误码说明
| 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.getBluetoothDevices({
success: function(res){
ap.alert('共发现' + res.devices.length + '个设备');
}
});
});
</script>