蓝牙双模设备连云激活

本文介绍蓝牙双模设备如何连云激活。

准备工作

• 蓝牙权限检测：每次扫描和连接前，都要进行检测，否则 App 无法正常使用蓝牙。
  • App 在使用蓝牙连接或者扫描操作前，需要检查 App 定位权限是否被允许。
  • 检查蓝牙状态是否已开启。
    该部分检查逻辑，智慧行业 App SDK 未提供 API，您可自行检测。

初始化 IActivator

参数说明

参数名	类型	是否必填	说明
mode	ActivatorMode	是	配网模式

代码示例

self.pair = ActivatorService.shared.activator(.BLEWIFICloud)

初始化配网参数

从扫描监听结果中，获取相关参数。

参数说明

参数名	类型	是否必填	说明
devId	String	是	设备 ID
ssid	String	是	Wi-Fi SSID
pwd	String	是	Wi-Fi 密码
timeout	long	否	连云激活超时时间，单位：毫秒，默认值：120

let params = BLEWIFICloudActivatorParams(devId: deviceId, ssid: "", password: "")

注册 IActivatorListener 监听配网结果

参数说明

参数名	类型	是否必填	说明
deviceModel	IActivatedDevice?	是	若操作成功，表示被激活的设备信息，否则为 nil
params	ActivatorParams?	是	操作相关的参数信息

回调函数说明

函数名	参数	说明
onSuccess	deviceModel: IActivatedDevice?, params: ActivatorParams?	操作成功回调函数，返回被激活的设备信息
onError	error: Error, params: ActivatorParams?	操作失败回调函数，返回错误信息

代码示例

private func start() {
    pair.listener = self
}

extension TableViewController: IActivatorListener {
    func onSuccess(deviceModel: IActivatedDevice?, params: ActivatorParams?) {
        SVProgressHUD.dismiss()
    }

    func onError(error: Error, params: ActivatorParams?) {
        SVProgressHUD.dismiss()
        SVProgressHUD.showInfo(withStatus: error.localizedDescription)
    }
}

开始配网

该方法用于开始设备配网操作。

参数说明

参数名	类型	是否必填	说明
params	ActivatorParams	是	配网操作相关的参数信息，见代码示例
deviceInfo	ThingBLEAdvModel	是	设备信息
assetId	String	是	资产 ID
pairToken	String	是	配网 Token
ssid	String	是	Wi-Fi SSID
password	String	是	Wi-Fi 密码
onlyConnectBle	Boolean	否	仅蓝牙连接激活，默认：false

代码示例

// 开始设备配网操作，pair 是在初始化过程中生成的
// self.pair = ActivatorService.shared.activator(.BLEWIFI)
self.pair.startPair(BLEWIFIActivatorParams(deviceInfo: devInfo, assetId: assetID, pairToken: self.pairingToken, ssid: self.ssid, password: self.password, onlyConnectBle: true))

开始连云激活

该方法用于开始设备连云激活操作。

代码示例

let iDevice = IndustryDevice(deviceId: device?.deviceId ?? "")
iDevice.connectBLE {
    // let params = BLEWIFICloudActivatorParams(devId: deviceId, ssid: "", password: "")
     self.pair.startPair(params)
} failure: {

}