局域网配网

LAN 配网适用于已经通过局域网发现的设备。统一接口会连接设备、发送 Wi-Fi 信息并等待云端注册结果。

开始配网

import { GizDeviceRegistrationInfo, GizProvisionEvent } from '@gizwits/smart-sdk';
import { hilog } from '@kit.PerformanceAnalysisKit';
 
const registration: GizDeviceRegistrationInfo | undefined =
  await device.lanCapability.provideWiFiCredentials(
    device,
    'wifi-ssid',
    'wifi-password',
    60,
    (event: GizProvisionEvent): void => {
      hilog.info(
        0x0000,
        'GizwitsSample',
        'LAN provisioning: %{public}s',
        event.stage
      );
    }
  );

成功时返回 GizDeviceRegistrationInfo；超时、发送失败或网络切换时 Promise 会抛出异常。

取消配网

device.lanCapability.stopProvideWiFiCredentials(device);

取消后回调会收到 CONFIG_CANCELLED，调用方应停止加载状态并允许用户重试。

⚠️

调用前确认目标 SSID 可用。不要把 Wi-Fi 密码写入 hilog、错误上报或用户反馈。