小程序API能力集成指南——配网能力API汇总（三）

ty.playnet.startBLEScanDevice

指定时间内扫描已配网的设备，扫描结果通过【onBLEScanDevice】事件获取

需引入PlayNetKit，且在>=1.1.0版本才可使用

请求参数

Object object

属性	类型	默认值	必填	说明
timeout	number		是	扫描超时时间
scanType	string		是	扫描类型 SINGLE -> "SINGLE" SINGLE_QR -> "SINGLE_QR" MESH -> "MESH" MESH -> "MESH" SIG_MESH -> "SIG_MESH" NORMAL -> "NORMAL" 默认 Thing_BEACON -> "Thing_BEACON" Multi_Mode 双模
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数

返回结果

• success

无

• fail

属性	类型	说明
errorMsg	string	插件错误信息
errorCode	string	错误码
innerError	object	插件外部依赖错误信息 {errorMsg: string, errorCode: string }

请求示例

ty.playnet.startBLEScanDevice({
  timeout: 120,
  scanType: 'NORMAL'
})
  .then(() => {
  })
  .catch();

 

ty.playnet.stopActivator

停止配网

需引入PlayNetKit，且在>=1.1.0版本才可使用

请求参数

Object object

属性	类型	默认值	必填	说明
pairType	string		是	配网类型，后续新流程添加在这里 AP -> "AP" WIFI_BLE -> "WIFI_BLE", 蓝牙配网需要填uuid
uuid	string		否	uuid 根据uuid来匹配找到对应的蓝牙配网设备
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数

返回结果

• success

无

• fail

属性	类型	说明
errorMsg	string	插件错误信息
errorCode	string	错误码
innerError	object	插件外部依赖错误信息 {errorMsg: string, errorCode: string }

请求示例

ty.playnet.stopActivator({
  pairType: 'AP'
})
  .then(() => {
  })
  .catch();

 

ty.playnet.stopBLEScan

停止蓝牙扫描

需引入PlayNetKit，且在>=1.1.0版本才可使用

请求参数

Object object s

属性	类型	默认值	必填	说明
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数

返回结果

• success

无

• fail

属性	类型	说明
errorMsg	string	插件错误信息
errorCode	string	错误码
innerError	object	插件外部依赖错误信息 {errorMsg: string, errorCode: string }

请求示例

ty.playnet.stopBLEScan()
  .then(() => {
  })
  .catch();

 

ty.playnet.onBLEScanDevice

扫描到设备后进行通知

需引入PlayNetKit，且在>=1.1.0版本才可使用

请求参数

Function Callback

扫描到设备后进行通知的回调函数

回调结果

Object object

属性	类型	默认值	必填	说明
uuid	string		是	uuid
flag	number		是	flag
rssi	number		是	rssi
productId	string		是	productId
isShare	boolean		是	isShare
isbind	boolean		是	isbind
deviceType	number		是	deviceType

请求示例

ty.playnet.onBLEScanDevice((res) => {
  console.log(res);
})

返回示例

{
  "uuid": "bb768f78f8151037",
  "flag": 0,
  "rssi": 0,
  "productId": "key8u54q9dtru5jw",
  "isShare": false,
  "isbind": false,
  "deviceType": 0
}

 

ty.playnet.offBLEScanDevice

取消监听：扫描到设备后进行通知

需引入PlayNetKit，且在>=1.1.0版本才可使用

请求参数

无

返回结果

无

请求示例

ty.playnet.offBLEScanDevice()

 👉 立即开发。

ty.playnet.onBLEStateChange

蓝牙状态发生变化

需引入PlayNetKit，且在>=1.1.0版本才可使用

请求参数

Function Callback

蓝牙状态发生变化的回调函数

回调结果

Object object

属性	类型	默认值	必填	说明
enable	boolean		是	enable

请求示例

ty.playnet.onBlePermissionChange((res) => {
  console.log(res);
})

返回示例

{ enable: true }

 

ty.playnet.offBLEStateChange

取消监听：蓝牙状态发生变化

需引入PlayNetKit，且在>=1.1.0版本才可使用

请求参数

无

返回结果

无

请求示例

ty.playnet.offBLEStateChange()

 

ty.playnet.onBlePermissionChange

蓝牙权限发生变化

需引入PlayNetKit，且在>=1.1.0版本才可使用

请求参数

Function Callback

蓝牙权限发生变化的回调函数

回调结果

Object object

属性	类型	默认值	必填	说明
enable	boolean		是	enable

请求示例

ty.playnet.onBlePermissionChange((res) => {
  console.log(res);
})

返回示例

{ enable: true }

 

ty.playnet.offBlePermissionChange

取消监听：蓝牙权限发生变化

需引入PlayNetKit，且在>=1.1.0版本才可使用

请求参数

无

返回结果

无

请求示例

ty.playnet.offBlePermissionChange()

 

ty.playnet.onWifiStateChange

wifi状态发生变化

需引入PlayNetKit，且在>=1.1.0版本才可使用

请求参数

Function Callback

wifi状态发生变化的回调函数

回调结果

Object object

属性	类型	默认值	必填	说明
enable	boolean		是	enable

请求示例

ty.playnet.onBlePermissionChange((res) => {
  console.log(res);
})

返回示例

{ enable: true }

 

ty.playnet.offWifiStateChange

取消监听：wifi状态发生变化

需引入PlayNetKit，且在>=1.1.0版本才可使用

请求参数

无

返回结果

无

请求示例

ty.playnet.offWifiStateChanges()

 

ty.playnet.onlocalNetWorkPermissionChange

本地网络权限发生变化

需引入PlayNetKit，且在>=1.1.0版本才可使用

请求参数

Function Callback

本地网络权限发生变化的回调函数

回调结果

Object object

属性	类型	默认值	必填	说明
enable	boolean		是	enable

请求示例

ty.playnet.onBlePermissionChange((res) => {
  console.log(res);
})

返回示例

{ enable: true }

 

ty.playnet.offlocalNetWorkPermissionChange

取消监听：本地网络权限发生变化

需引入PlayNetKit，且在>=1.1.0版本才可使用

请求参数

无

返回结果

无

请求示例

ty.playnet.offlocalNetWorkPermissionChange()

👉 立即开发。