热点配网

更新时间：2024-05-20 02:05:54下载pdf

热点配网又称 热点模式 或 AP（Access Point）配网，是一种通过 Wi-Fi 进行配网的连接能力。将手机连接到配网设备 Wi-Fi 热点后，App 与设备直接通过 Wi-Fi 进行通信配网。成功率高、可靠性好，可适配 2.4G/5G 混频路由器配网，但用户需要手动切换手机的 Wi-Fi 设置。

IActivator 初始化

参数说明

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

代码示例

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

获取配网 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`	是	配网操作相关的参数信息，见代码示例

代码示例

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

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

停止配网

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

代码示例

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

上一篇快连模式

下一篇摄像头二维码配网