场景介绍
应用或者其他模块可以通过接口完成以下功能:
- 获取WLAN状态,查询WLAN是否打开。
 - 发起扫描并获取扫描结果。
 - 获取连接态详细信息,包括连接信息、IP信息等。
 - 获取设备国家码。
 - 获取设备是否支持指定的能力。
 
接口说明
WLAN基础功能由WifiDevice提供,其接口说明如下。
| 
 接口名  | 
 描述  | 
 所需权限  | 
|---|---|---|
| 
 getInstance(Context context)  | 
 获取WLAN功能管理对象实例,通过该实例调用WLAN基本功能API。  | 
 NA  | 
| 
 isWifiActive()  | 
 获取当前WLAN打开状态。  | 
 ohos.permission.GET_WIFI_INFO  | 
| 
 scan()  | 
 发起WLAN扫描。  | 
 ohos.permission.SET_WIFI_INFO ohos.permission.LOCATION  | 
| 
 getScanInfoList()  | 
 获取上次扫描结果。  | 
 ohos.permission.GET_WIFI_INFO ohos.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.LOCATION ohos.permission.GET_WIFI_INFO  | 
| 
 isFeatureSupported(long featureId)  | 
 获取设备是否支持指定的特性。  | 
 ohos.permission.GET_WIFI_INFO  | 
获取WLAN状态
- 调用WifiDevice的getInstance(Context context)接口,获取WifiDevice实例,用于管理本机WLAN操作。
 
调用isWifiActive()接口查询WLAN是否打开。
// 获取WLAN管理对象
WifiDevice wifiDevice = WifiDevice.getInstance(context);
// 调用获取WLAN开关状态接口
boolean isWifiActive = wifiDevice.isWifiActive(); // 若WLAN打开,则返回true,否则返回false
发起扫描并获取结果
- 调用WifiDevice的getInstance(Context context)接口,获取WifiDevice实例,用于管理本机WLAN操作。
 - 调用scan()接口发起扫描。
 
调用getScanInfoList()接口获取扫描结果。
// 获取WLAN管理对象
WifiDevice wifiDevice = WifiDevice.getInstance(context);
// 调用WLAN扫描接口
boolean isScanSuccess = wifiDevice.scan();
// 调用获取扫描结果
List<WifiScanInfo> scanInfos = wifiDevice.getScanInfoList();
获取连接态详细信息
- 调用WifiDevice的getInstance(Context context)接口,获取WifiDevice实例,用于管理本机WLAN操作。
 - 调用isConnected()接口获取当前连接状态。
 - 调用getLinkedInfo()接口获取连接信息。
 
调用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();
}
获取设备国家码
- 调用WifiDevice的getInstance(Context context)接口,获取WifiDevice实例,用于管理本机WLAN操作。
 - 调用getCountryCode()接口获取设备的国家码。
 
// 获取WLAN管理对象
WifiDevice wifiDevice = WifiDevice.getInstance(context);
// 获取当前设备的国家码
String countryCode = wifiDevice.getCountryCode();
判断设备是否支持指定的能力
- 调用WifiDevice的getInstance(Context context)接口,获取WifiDevice实例,用于管理本机WLAN操作。
 
调用isFeatureSupported(long featureId)接口判断设备是否支持指定的能力。
// 获取WLAN管理对象
WifiDevice wifiDevice = WifiDevice.getInstance(context);
// 获取当前设备是否支持指定的能力
boolean isSupportInfra = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_INFRA);
isSupportInfra5g = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_INFRA_5G);
isSupportPasspoint = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_PASSPOINT);
isSupportP2p = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_P2P);
isSupportHotspot = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_MOBILE_HOTSPOT);
isSupportAware = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_AWARE);
isSupportApSta = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_AP_STA);
isSupportWpa3Sae = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_WPA3_SAE);
isSupportWpa3SuiteB = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_WPA3_SUITE_B);
isSupportOwe = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_OWE);