快连模式

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

配网流程

• 准备阶段。

  • 引导用户，将设备重置到 Wi-Fi 快连模式，通常设备的 Wi-Fi 指示灯处于快闪状态。
  • 引导用户，将手机连接到 Wi-Fi，通常是 2.4 GHz Wi-Fi。

• 获取配网 Token 和 Wi-Fi 信息。

  • App 通过调用 SDK 提供的接口，获取配网 Token。
  • App 通过 UI 交互，获取用户输入的 Wi-Fi 信息，包括 SSID 和 password，其中 SSID 也可以通过调用系统 API 获取。

• 开始配网。

  App 通过调用 SDK 提供的配网接口，设置 Wi-Fi 信息（SSID、password）和配网 token 等参数，开始为设备配网。

• 完成配网。

  配网完成后，App 会收到 SDK 的完成回调，结束配网流程。

EZ 配网 API 使用示例

API 说明请参考 设备配网。

获取配网 Token

// 获取token
this.activatorToken = await TSmartActivatorRequester.getActivatorToken(this.homeId)

实现配网监听器中的方法

activatorListener: ITSmartActivatorListener = {
    onActiveSetpAndError: (step: TSmartActivatorStep, error?: Error, device?: TSmartDeviceModel) => {
      // 实现相关逻辑
    },

    onActiveSuccess: (deviceModel: TSmartDeviceModel) => {
      // 处理配网成功的逻辑，例如更新UI，跳转到下一个页面
    },
};

创建EZ配网实例

const activatorBuilder = TSmartActivator.buildEzActivatorBuilder(
          this.ssid,
          this.password,
          120 * 1000,
          this.activatorListener,
          this.homeId,
        )
this.activator = TSmartActivator.createActivator(activatorBuilder);

调用开始配网

this.activator.startActive()

调用停止配网

this.activator.stopActive()