鴻蒙OS WLAN基礎功能

場景介紹

應用或者其他模塊可以通過接口完成以下功能：

1. 獲取 WLAN 狀態(tài)，查詢 WLAN 是否打開。
2. 發(fā)起掃描并獲取掃描結果。
3. 獲取連接態(tài)詳細信息，包括連接信息、IP信息等。
4. 獲取設備國家碼。
5. 獲取設備是否支持指定的能力。

接口說明

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

獲取 WLAN 狀態(tài)

1. 調(diào)用 WifiDevice 的 getInstance(Context context)接口，獲取 WifiDevice 實例，用于管理本機 WLAN 操作。

1. 調(diào)用 isWifiActive()接口查詢 WLAN 是否打開。

   // 獲取WLAN管理對象
   WifiDevice wifiDevice = WifiDevice.getInstance(context);
   // 調(diào)用獲取WLAN開關狀態(tài)接口
   boolean isWifiActive  = wifiDevice.isWifiActive(); // 若WLAN打開，則返回true，否則返回false

發(fā)起掃描并獲取結果

1. 調(diào)用 WifiDevice 的 getInstance(Context context)接口，獲取 WifiDevice 實例，用于管理本機 WLAN 操作。

1. 調(diào)用 scan() 接口發(fā)起掃描。

1. 調(diào)用 getScanInfoList() 接口獲取掃描結果。

   // 獲取WLAN管理對象
   WifiDevice wifiDevice = WifiDevice.getInstance(context);
   // 調(diào)用WLAN掃描接口
   boolean isScanSuccess = wifiDevice.scan(); // true
   // 調(diào)用獲取掃描結果
    List<WifiScanInfo> scanInfos = wifiDevice.getScanInfoList();

獲取連接態(tài)詳細信息

1. 調(diào)用 WifiDevice 的 getInstance(Context context)接口，獲取 WifiDevice 實例，用于管理本機WLAN操作。

1. 調(diào)用 isConnected() 接口獲取當前連接狀態(tài)。

1. 調(diào)用 getLinkedInfo() 接口獲取連接信息。

1. 調(diào)用 getIpInfo() 接口獲取 IP 信息。

   // 獲取WLAN管理對象
   WifiDevice wifiDevice = WifiDevice.getInstance(context);
   // 調(diào)用WLAN連接狀態(tài)接口,確定當前設備是否連接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地址與網(wǎng)關
       int ipAddress = ipInfo.get().getIpAddress();
       int gateway = ipInfo.get().getGateway();
   }

獲取設備國家碼

1. 調(diào)用 WifiDevice 的 getInstance(Context context) 接口，獲取 WifiDevic e實例，用于管理本機WLAN操作。

1. 調(diào)用 getCountryCode() 接口獲取設備的國家碼。

   // 獲取WLAN管理對象
   WifiDevice wifiDevice = WifiDevice.getInstance(context);
   // 獲取當前設備的國家碼
   String countryCode = wifiDevice.getCountryCode();

判斷設備是否支持指定的能力

1. 調(diào)用 WifiDevice 的 getInstance(Context context)接口，獲取 WifiDevice 實例，用于管理本機 WLAN 操作。

1. 調(diào)用 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);