热点模式

更新时间:2025-12-16 06:17:48下载pdf

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

配网流程

  • 准备阶段

    • 引导用户,将设备重置到热点模式,通常设备的 Wi-Fi 指示灯处于慢闪状态。
    • 引导用户,将手机连接到 Wi-Fi,通常是 2.4 GHz Wi-Fi。
  • 获取配网 Token 和 Wi-Fi 信息

    • App 通过调用 SDK 提供的接口,获取配网 Token。
    • App 通过 UI 交互,获取用户输入的 Wi-Fi 信息,包括 SSID 和 password。
  • 热点连接

    引导用户,将手机的网络连接切换到设备所发出的热点。

  • 开始配网

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

  • 完成配网

    配网完成后,设备的热点会自动关闭,App 会收到 SDK 的完成回调,结束配网流程。

AP 配网 API 使用示例

API 说明,请参考 设备配网

获取配网 Token

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

实现配网监听器中的方法

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

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

创建 AP 配网实例

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

调用开始配网

this.activator.startActive()

调用停止配网

this.activator.stopActive()