热点模式

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

配网流程

获取令牌

在执行 AP 模式的配网操作之前，SDK 需要从涂鸦 IoT 云端获取配网令牌。此令牌有效期为 10 分钟。配网成功后，此令牌立即失效。如果您需要重新配网，必须重新获取令牌。

配网相关的接口封装在 TYDeviceRegistrationManager 中，请先初始化一个实例：let manager = TYDeviceRegistrationManager()

如需获取令牌，调用 manager.generateToken(for: assetID: completionHandle: )。

参数说明

TYDeviceRegistrationToken 说明

代码示例

manager.generateToken(for: .AP, assetID: "1234567890") { (token, error) in
    guard error == nil else {
        print(error?.localizedDescription)
        return
    }

    let pairingToken = token?.pairingToken
}

初始化配网参数

let activator = TYAPActivator(SSID: "ssid", password: "password", pairingToken: "pairingToken")

参数说明

配网方法调用

let activator = TYAPActivator(SSID: "ssid", password: "password", pairingToken: "pairingToken")
// 开始配网
activator.start();
// 停止配网
activator.stop();

获取配网结果

如需获取配网结果，调用 TYDeviceRegistrationManager 的 queryRegistrationResult(of: completionHandle: )。

参数说明

TYDeviceRegistrationResult 说明

TYPairedDevice 说明

TYFailedPairingDevice 说明

设备配网属于异步过程。设备配网的耗时取决于网络质量。您必须调用 API 来检查设备配网结果。当系统返回配网设备列表或配网任务超时后，轮询任务停止。

建议轮询任务设置为每隔 1 秒运行一次。配对任务的超时值建议设置为 100 秒。