有线设备配网

更新时间:2025-12-16 06:21:46下载pdf

有线设备已通过网线连接着网络,设备激活过程中,用户无需输入路由器的名称和密码。

配网流程

  • 准备阶段

    引导用户,将设备重置到配网状态。

  • 获取配网 Token

    App 通过调用 SDK 提供的接口,获取配网 Token。

  • 获取设备信息

    App 通过调用 SDK 提供的 API,获取设备信息。

  • 开始配网

    App 通过调用 SDK 提供的配网接口,设置配网参数,开始为设备配网。

  • 完成配网

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

有线设备配网API使用示例

API说明参考设备配网

局域网设备扫描

SDK 提供发现待配网有线设备的功能,获取设备前,手机需与设备接入同一网络。然后通过实现 TSmartScannerListener 扫描监听器的方法获得设备信息。

实现扫描结果监听器

 scanListener: TSmartScannerListener = {
    onDeviceFound: (scanResult: TSmartScannerResult): void => {
      // 实现相关逻辑
    }
  };

构造扫描实例

// 使用扫描监听器创建扫描实例
this.scanner = new TSmartScannerBuilder(this.scanListener);
// 设置扫描超时时间和扫描方式
this.scanner.setScanTimeout(120000).addScanMode(TSmartScanMode.SCAN_MODE_LAN);

开始扫描

this.scanner.startScan();

停止扫描

this.scanner.stopScan();

配网

获取配网token

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

实现配网监听器中的方法

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

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

创建有线配网实例

const activatorBuilder = TSmartActivator.buildWiredActivatorBuilder(
          this.homeId,
          gwId,
          productId,
          120 * 1000,
          this.activatorListener,
  		  this.activatorToken
        )
this.activator = TSmartActivator.createActivator(activatorBuilder);

调用开始配网

this.activator.startActive()

调用停止配网

this.activator.stopActive()