dlt.startBluetoothDevicesDiscovery

简介

开启蓝牙扫描。

使用限制

1. 前置条件：初始化过蓝牙模块 dlt.openBluetoothAdapter
2. 扫描到结果后要调用 dlt.stopBluetoothDevicesDiscovery 关闭扫描。

参数

Object object

属性	类型	默认值	必填	描述
serviceUUIDS	string		是	要搜索的蓝牙设备主服务的 UUID 列表（支持 16/32/128 位 UUID）。某些蓝牙设备会广播自己的主 service 的 UUID。如果设置此参数，则只搜索广播包有对应 UUID 的主服务的蓝牙设备。建议通过该参数过滤掉周边不需要处理的其他蓝牙设备。
powerLevel	number		否	扫描等级，等级越高，扫描频次越高，越耗电
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）

object.success 回调函数

参数

Object res

属性	类型	说明
success	string	true-成功

object.fail 回调函数

参数

Object res

属性	类型	说明
success	string	false-失败
errCode	string	错误码

错误码释义

错误码	说明
-1	失败
0	正常
10000	未初始化蓝牙适配器
10001	当前蓝牙不可用
10002	没有找到指定设备
10003	连接失败
10004	已连接
10005	未找到特征码
10006	未找到特征码的 Descriptor
10007	当前手机扫描蓝牙需要打开定位功能
10008	系统上报的异常
10013	无效的数据
10014	没有申请权限
10015	已经初始化了 Adapter

示例代码

dlt.startBluetoothDevicesDiscovery({
  serviceUUIDS: JSON.stringify([]),
  powerLevel: 1,
  success: function (res) {
    console.log('success', res);
    dlt.stopBluetoothDevicesDiscovery();
  },
  complete: function (res) {
    console.log('startBluetoothDevicesDiscovery complete', res);
  },
  fail: function (res) {
    console.log('startBluetoothDevicesDiscovery fail', res);
  },
});