抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台

tt.startBluetoothDevicesDiscovery

收藏
我的收藏

基础库 1.0.0 开始支持本方法,这是一个异步方法。

开始搜寻附近的蓝牙外围设备。

前提条件无
业务背景无
使用限制无
注意事项
1. 该操作比较耗费系统资源,请在搜索到目标设备后及时调用tt.stopBluetoothDevicesDiscovery停止搜索。 2. services参数可用于根据主服务UUID过滤设备,提高搜索效率。
支持沙盒
否
相关教程无

语法

tt.startBluetoothDevicesDiscovery(options)

参数说明

options 为 object 类型,属性如下:

属性名类型默认值必填说明最低支持版本
servicesArray<string>-否
要搜索的蓝牙设备主服务的UUID列表。
3.87.0
allowDuplicatesKeybooleanfalse否
是否允许重复上报同一设备。
3.87.0
intervalnumber0否
上报设备的间隔,单位毫秒。
3.87.0
powerLevelenummedium否
扫描模式,影响扫描速度和功耗
3.87.0
successfunction否
接口调用成功的回调函数
1.0.0
failfunction否
接口调用失败的回调函数
1.0.0
completefunction否
接口调用结束的回调函数(调用成功、失败都会执行)
1.0.0

powerLevel 的合法值

值说明最低支持版本
low
低功耗模式
3.87.0
medium
中等功耗模式
3.87.0
high
高功耗模式
3.87.0

回调成功

object 类型,属性如下:

属性名类型说明最低支持版本
errMsgstring
"startBluetoothDevicesDiscovery:ok"
3.87.0
errorCodestring
错误码信息
3.87.0

回调失败

object 类型,属性如下:

属性名类型说明最低支持版本
errMsgstring
"startBluetoothDevicesDiscovery:fail" + 详细错误信息
3.87.0
errorCodestring
错误码信息
3.87.0

错误码

errorCodeerrMsgerrorType说明最低支持版本
187001startBluetoothDevicesDiscovery:fail not initD
未初始化蓝牙适配器
3.87.0
187002startBluetoothDevicesDiscovery:fail adapter not availableF
小程序框架内部错误,有需要请创建工单咨询
3.87.0
187009startBluetoothDevicesDiscovery:fail system errorF
小程序框架内部错误,有需要请创建工单咨询
3.87.0

代码示例

开发者工具中预览

tt.startBluetoothDevicesDiscovery({ services: this.user.services, success(res) { console.log(res) } })