ap.startBluetoothDevicesDiscovery(OPTION | services | service, CALLBACK)
开始搜寻附近的蓝牙外围设备。搜索结果将在 bluetoothDeviceFound 事件中返回。可直接传入一个数组作为 OPTION.services 参数。也可直接传入一个字符串作为 OPTION.services 的第一项。
OPTION 参数说明
名称 | 类型 | 必填 | 描述 |
---|
services | Array | 否 | 蓝牙设备主 service 的 uuid 列表 |
allowDuplicatesKey | Boolean | 否 | 是否允许重复上报同一设备, 如果允许重复上报,则onBluetoothDeviceFound 方法会多次上报同一设备,但是 RSSI 值会有不同 |
interval | Number | 否 | 上报设备的间隔,单位为ms,默认为0ms,意思是找到新设备立即上报,否则根据传入的间隔上报 |
错误码说明
代码示例
<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');
ap.onBluetoothDeviceFound(function(res){
ap.showToast('搜索到' + res.devices.length + '个设备');
});
btn.addEventListener('click', function(){
ap.startBluetoothDevicesDiscovery({
services: ['0000fdd7-0000-1011-8004-00987f9b34fb']
});
});
</script>
其他说明
- 该操作比较耗费系统资源,请在搜索并连接到设备后调用 stop 方法停止搜索。