接口名	功能描述
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连接状态改变事件。

主要场景开发步骤

判断Wi-Fi状态

导入需要的Wi-Fi模块。
需要SystemCapability.Communication.WiFi.STA系统能力。
需要申请权限ohos.permission.GET_WIFI_INFO。
开启设备Wi-Fi。

示例代码：

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}`);
  }
}

建立Wi-Fi连接

导入需要的Wi-Fi模块。
开启设备的Wi-Fi。
需要SystemCapability.Communication.WiFi.STA系统能力。
需要申请权限ohos.permission.GET_WIFI_INFO，ohos.permission.SET_WIFI_INFO。

示例代码：

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

try {
  let recvWifiConnectionChangeFunc = (result: number) => {
    console.info("Receive wifi connection change event: " + result);
  }

  let config: wifiManager.WifiDeviceConfig = {
    ssid: "****",
    bssid: "****",
    preSharedKey: "****",
    securityType: 0
  }

  // 更新当前Wi-Fi连接状态
  wifiManager.on("wifiConnectionChange", recvWifiConnectionChangeFunc);
  // 添加候选网络配置
  wifiManager.addCandidateConfig(config).then(result => {
    // 连接指定网络
    wifiManager.connectToCandidateConfig(result);
  });

  if (!wifiManager.isConnected()) {
    console.info("Wi-Fi not connected");
  }
  // 获取连接信息
  wifiManager.getLinkedInfo().then(data => {
    console.info("get Wi-Fi linked info: " + JSON.stringify(data));
  })
  // 查询信号强度
  let rssi = -88;
  let band = 1;
  let level = wifiManager.getSignalLevel(rssi, band);
  console.info("level:" + JSON.stringify(level));

  // 取消注册，停止更新当前Wi-Fi连接状态
  wifiManager.off("wifiConnectionChange", recvWifiConnectionChangeFunc);
} catch (error) {
  console.error(`WiFi Connection failed. ${error.message}`);
}

Wi-Fi连接状态值，详情请参考ConnState。
错误码详情请参见WIFI错误码。

P2P模式开发指南

Wi-Fi扫描开发指南

意见反馈

以上内容对您是否有帮助？

意见反馈

如果您有其他疑问，您也可以通过开发者社区问答频道来和我们联系探讨。

社区提问智能客服提问