Alipay JSSDK V3.1.1

ap.startBluetoothDevicesDiscovery(OPTION | services | service, CALLBACK)

开始搜寻附近的蓝牙外围设备。搜索结果将在 bluetoothDeviceFound 事件中返回。可直接传入一个数组作为 OPTION.services 参数。也可直接传入一个字符串作为 OPTION.services 的第一项。

OPTION 参数说明

名称类型必填描述
servicesArray蓝牙设备主 service 的 uuid 列表
allowDuplicatesKeyBoolean是否允许重复上报同一设备, 如果允许重复上报,则onBluetoothDeviceFound 方法会多次上报同一设备,但是 RSSI 值会有不同
intervalNumber上报设备的间隔,单位为ms,默认为0ms,意思是找到新设备立即上报,否则根据传入的间隔上报

错误码说明

error描述
12开始搜索失败

代码示例

<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(){
    //此处 service 只是示例,并非真正的设备服务 id
    ap.startBluetoothDevicesDiscovery({
      services: ['0000fdd7-0000-1011-8004-00987f9b34fb']
    });
  });
</script>

其他说明

  • 该操作比较耗费系统资源,请在搜索并连接到设备后调用 stop 方法停止搜索。