快连模式

更新时间：2024-05-20 06:53:57下载pdf

Wi-Fi 快连配网又称 快连模式 （Easy-Connect）、SmartConfig 或 EZ 配网。用户将手机连接到路由器后，利用路由器广播报文与设备进行通信配网。用户操作简单，但对手机和路由器有兼容性要求，成功率低于热点配网。

IActivator 初始化

参数说明

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

代码示例

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

获取配网 Token

参数说明

参数名	类型	是否必填	说明
`assetId`	`String`	是	指定的资产 ID
`longitude`	`String`	否	经度信息
`latitude`	`String`	否	纬度信息
`success`	`((String)->(Void))?`	否	成功回调函数
`failure`	`((Error)->(Void))?`	否	失败回调函数

代码示例

// 获取资产激活令牌
ActivatorService.shared.activatorToken(assetId: "123456", longitude: "30.1234", latitude: "120.5678", success: { token in
    // 成功回调函数
    print("激活令牌为：\(token)")
}, failure: { error in
    // 失败回调函数
    print("获取激活令牌失败，错误信息为：\(error.localizedDescription)")
})

注册 IActivatorListener 监听配网结果

参数说明

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

回调函数说明

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

代码示例

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

extension WiFiModeTableViewController: IActivatorListener {
    func onSuccess(deviceModel: IActivatedDevice?, params: ActivatorParams?) {
        SVProgressHUD.dismiss()
        self.navigationController?.popToRootViewController(animated: true)
    }

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

开始配网

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

参数说明

参数名	类型	是否必填	说明
`params`	`ActivatorParams`	是	配网操作相关的参数信息，见示例代码

代码示例

// 创建 EZActivatorParams 实例
let params = EZActivatorParams(ssid: "my_wifi_ssid", password: "my_wifi_password", pairToken: "my_pair_token")

// 开始设备配网操作，pair 是在初始化过程中生成的
// self.pair = ActivatorService.shared.activator(.EZ)
pair.startPair(params)

停止配网

该方法用于停止设备配网操作。

代码示例

// 停止设备配网操作，pair 是在初始化过程中生成的
// self.pair = ActivatorService.shared.activator(.EZ)
pair.stopPair()

上一篇设备配网

下一篇热点配网