目录

STA模式开发指南

简介

Wi-Fi STA模式（Station Mode，站点模式）是无线设备作为客户端接入无线局域网（WLAN）的工作模式。在该模式下，设备（如手机、电脑、平板等）通过连接到接入点（AP，Access Point）或无线路由器，实现对网络的访问。

场景介绍

接口说明

完整的JS API说明以及示例代码请参考：@ohos.wifiManager (WLAN)。

接口具体说明如下表所示。

接口名 功能描述
isWifiActive() 查询WLAN开关是否已使能。
addCandidateConfig() 添加候选网络配置，使用前先使能WLAN。
connectToCandidateConfig() 应用使用该接口连接到自己添加的候选网络。
isConnected() 查询WLAN是否已连接。
removeCandidateConfig() 移除候选网络配置。
getCandidateConfigs() 获取候选网络配置。
on(type: 'wifiStateChange') 注册WLAN状态改变事件。
off(type: 'wifiStateChange') 取消注册WLAN状态改变事件。
on(type: 'wifiConnectionChange') 注册WLAN连接状态改变事件。
off(type: 'wifiConnectionChange') 取消注册WLAN连接状态改变事件。

主要场景开发步骤

[h2]判断Wi-Fi状态

  1. 导入需要的Wi-Fi模块。

  2. 需要SystemCapability.Communication.WiFi.STA系统能力。

  3. 需要申请权限ohos.permission.GET_WIFI_INFO。

  4. 开启设备Wi-Fi。

  5. 示例代码：

    import { wifiManager } from '@kit.ConnectivityKit';

let recvPowerNotifyFunc: (result: number) => void = (result: number) => {
  let wifiState = "";
  switch (result) {
    case 0:
      wifiState += 'DISABLED';
      break;
    case 1:
      wifiState += 'ENABLED';
      break;
    case 2:
      wifiState += 'ENABLING';
      break;
    case 3:
      wifiState += 'DISABLING';
      break;
    default:
      wifiState += 'UNKNOWN STATUS';
      break;
  }
  console.info(`Wi-Fi state changed: ${wifiState}`);
};
try {
  wifiManager.on("wifiStateChange", recvPowerNotifyFunc);
  let isWifiActive = wifiManager.isWifiActive();
  if (!isWifiActive) {
    console.info("Wi-Fi not enabled. Skipping monitor.");
  } else {
    console.info("Wi-Fi is enabled. Starting monitor...");
  }
} catch (error) {
  console.error(`WiFi state monitor failed: ${error.message}`);
} finally {
  try {
    wifiManager.off("wifiStateChange", recvPowerNotifyFunc);
    console.info("Wi-Fi monitor off: listener removed.");
  } catch (e) {
     console.error(`WiFi state monitor failed. ${e.message}`);
  }
}

[h2]建立Wi-Fi连接

  1. 导入需要的Wi-Fi模块。

  2. 开启设备的Wi-Fi。

  3. 需要SystemCapability.Communication.WiFi.STA系统能力。

  4. 需要申请权限ohos.permission.GET_WIFI_INFO，ohos.permission.SET_WIFI_INFO。

  5. 示例代码：

    import { wifiManager } from '@kit.ConnectivityKit';
import { BusinessError } from '@kit.BasicServicesKit';

let recvWifiConnectionChangeFunc = (result: number) => {
  console.info("Receive wifi connection change event: " + result);
  if (result === 1) {
    // result为1表示已连接，此时查询连接状态和连接信息才有意义
    if (!wifiManager.isConnected()) {
      console.info("Wi-Fi not connected");
    }
    // 获取连接信息
    wifiManager.getLinkedInfo().then(data => {
      console.info("get Wi-Fi linked info: " + JSON.stringify(data));
    }).catch((e: BusinessError) => {
      console.error(`getLinkedInfo failed. Code: ${e.code}, message: ${e.message}`);
    });
  }
}

try {
  let config: wifiManager.WifiDeviceConfig = {
    ssid: "****",
    bssid: "****",
    preSharedKey: "****",
    securityType: 3 // 3为WIFI_SEC_TYPE_PSK；
  }

  // 更新当前Wi-Fi连接状态。
  wifiManager.on("wifiConnectionChange", recvWifiConnectionChangeFunc);
  // 添加候选网络配置
  wifiManager.addCandidateConfig(config).then(result => {
    // 连接指定网络
    wifiManager.connectToCandidateConfig(result);
  }).catch((e: BusinessError) => {
    console.error(`addCandidateConfig failed. Code: ${e.code}, message: ${e.message}`);
    // 添加失败则不会有连接事件，此处解除监听，避免泄漏
    try {
      wifiManager.off("wifiConnectionChange", recvWifiConnectionChangeFunc);
    } catch (err) {
      console.error(`off failed. ${err.message}`);
    }
  });
  // 查询信号强度
  let rssi = -88;
  let band = 1;
  let level = wifiManager.getSignalLevel(rssi, band);
  console.info("level:" + JSON.stringify(level));
} catch (error) {
  console.error(`WiFi Connection failed. ${error.message}`);
  try {
    wifiManager.off("wifiConnectionChange", recvWifiConnectionChangeFunc);
  } catch (e) {
    console.error(`WiFi Connection off failed. ${e.message}`);
  }
}

  6. Wi-Fi连接状态值，详情请参考ConnState。

  7. 错误码详情请参见Wi-Fi错误码。