鸿蒙OS WLAN基础功能

场景介绍

应用或者其他模块可以通过接口完成以下功能：

1. 获取 WLAN 状态，查询 WLAN 是否打开。
2. 发起扫描并获取扫描结果。
3. 获取连接态详细信息，包括连接信息、IP信息等。
4. 获取设备国家码。
5. 获取设备是否支持指定的能力。

接口说明

WifiDevice 提供 WLAN 的基本功能，其接口说明如下。

接口名	描述	所需权限
getInstance(Context context)	获取WLAN功能管理对象实例，通过该实例调用 WLAN 基本功能 API。	NA
isWifiActive()	获取当前WLAN打开状态。	ohos.permission.GET_WIFI_INFO
scan()	发起 WLAN 扫描。	ohos.permission.SET_WIFI_INFOohos.permission.LOCATION
getScanInfoList()	获取上次扫描结果。	ohos.permission.GET_WIFI_INFOohos.permission.LOCATION
isConnected()	获取当前 WLAN 连接状态。	ohos.permission.GET_WIFI_INFO
getLinkedInfo()	获取当前的 WLAN 连接信息。	ohos.permission.GET_WIFI_INFO
getIpInfo()	获取当前连接的 WLAN IP 信息。	ohos.permission.GET_WIFI_INFO
getSignalLevel(int rssi, int band)	通过 RSSI 与频段计算信号格数。	NA
getCountryCode()	获取设备的国家码。	ohos.permission.LOCATIONohos.permission.GET_WIFI_INFO
isFeatureSupported(long featureId)	获取设备是否支持指定的特性。	ohos.permission.GET_WIFI_INFO

获取 WLAN 状态

1. 调用 WifiDevice 的 getInstance(Context context)接口，获取 WifiDevice 实例，用于管理本机 WLAN 操作。

1. 调用 isWifiActive()接口查询 WLAN 是否打开。

   // 获取WLAN管理对象
   WifiDevice wifiDevice = WifiDevice.getInstance(context);
   // 调用获取WLAN开关状态接口
   boolean isWifiActive  = wifiDevice.isWifiActive(); // 若WLAN打开，则返回true，否则返回false

发起扫描并获取结果

1. 调用 WifiDevice 的 getInstance(Context context)接口，获取 WifiDevice 实例，用于管理本机 WLAN 操作。

1. 调用 scan() 接口发起扫描。

1. 调用 getScanInfoList() 接口获取扫描结果。

   // 获取WLAN管理对象
   WifiDevice wifiDevice = WifiDevice.getInstance(context);
   // 调用WLAN扫描接口
   boolean isScanSuccess = wifiDevice.scan(); // true
   // 调用获取扫描结果
    List<WifiScanInfo> scanInfos = wifiDevice.getScanInfoList();

获取连接态详细信息

1. 调用 WifiDevice 的 getInstance(Context context)接口，获取 WifiDevice 实例，用于管理本机WLAN操作。

1. 调用 isConnected() 接口获取当前连接状态。

1. 调用 getLinkedInfo() 接口获取连接信息。

1. 调用 getIpInfo() 接口获取 IP 信息。

   // 获取WLAN管理对象
   WifiDevice wifiDevice = WifiDevice.getInstance(context);
   // 调用WLAN连接状态接口,确定当前设备是否连接WLAN
   boolean isConnected = wifiDevice.isConnected();
   if (isConnected) {
       // 获取WLAN连接信息
       Optional<WifiLinkedInfo> linkedInfo = wifiDevice.getLinkedInfo();
       // 获取连接信息中的SSID
       String ssid = linkedInfo.get().getSsid();
       // 获取WLAN的IP信息
       Optional<IpInfo> ipInfo = wifiDevice.getIpInfo();
       // 获取IP信息中的IP地址与网关
       int ipAddress = ipInfo.get().getIpAddress();
       int gateway = ipInfo.get().getGateway();
   }

获取设备国家码

1. 调用 WifiDevice 的 getInstance(Context context) 接口，获取 WifiDevic e实例，用于管理本机WLAN操作。

1. 调用 getCountryCode() 接口获取设备的国家码。

   // 获取WLAN管理对象
   WifiDevice wifiDevice = WifiDevice.getInstance(context);
   // 获取当前设备的国家码
   String countryCode = wifiDevice.getCountryCode();

判断设备是否支持指定的能力

1. 调用 WifiDevice 的 getInstance(Context context)接口，获取 WifiDevice 实例，用于管理本机 WLAN 操作。

1. 调用 isFeatureSupported(long featureId)接口判断设备是否支持指定的能力。

   // 获取WLAN管理对象
   WifiDevice wifiDevice = WifiDevice.getInstance(context);
   // 获取当前设备是否支持指定的能力
   boolean isSupport = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_INFRA);
   isSupport = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_INFRA_5G);
   isSupport = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_PASSPOINT);
   isSupport = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_P2P);
   isSupport = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_MOBILE_HOTSPOT);
   isSupport = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_AWARE);
   isSupport = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_AP_STA);
   isSupport = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_WPA3_SAE);
   isSupport = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_WPA3_SUITE_B);
   isSupport = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_OWE);