WifiDevice

java.lang.Object
- ohos.wifi.WifiDevice

```
public final class WifiDevice
extends Object
```
Provides interfaces to manage Wi-Fi.
This class provides methods for obtaining Wi-Fi status and information, such as checking whether Wi-Fi is enabled, obtaining the list of information about access points detected in a Wi-Fi scan, and checking whether a Wi-Fi connection has been set up.

从以下版本开始:

1

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法	说明
`boolean`	`addUntrustedConfig(WifiDeviceConfig config)`	Adds a specified untrusted hotspot configuration.
`String`	`getCountryCode()`	Obtains the country code of this device.
`static WifiDevice`	`getInstance(Context context)`	Obtains a `WifiDevice` instance.
`Optional<IpInfo>`	`getIpInfo()`	Obtains the IP information of a Wi-Fi connection.
`Optional<WifiLinkedInfo>`	`getLinkedInfo()`	Obtains information about a Wi-Fi connection.
`List<WifiScanInfo>`	`getScanInfoList()`	Obtains the list of information about the access points detected in a Wi-Fi scan.
`int`	`getSignalLevel(int rssi, int band)`	Calculates the Wi-Fi signal level based on the Wi-Fi RSSI and frequency band.
`boolean`	`isConnected()`	Checks whether a Wi-Fi connection has been set up.
`boolean`	`isFeatureSupported(long featureId)`	Checks whether this device supports a specified feature.
`boolean`	`isWifiActive()`	Checks whether Wi-Fi is enabled.
`boolean`	`removeUntrustedConfig(WifiDeviceConfig config)`	Removes a specified untrusted hotspot configuration.
`boolean`	`scan()`	Scans Wi-Fi hotspots.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 方法详细资料
  - getInstance
```
public static WifiDevice getInstance(Context context)
                              throws IllegalArgumentException
```
    Obtains a WifiDevice instance.
    WifiDevice is a singleton class.
    
    参数:
    
    context - Indicates the application context of the caller.
    
    返回:
    
    Returns the WifiDevice instance.
    
    抛出:
    
    IllegalArgumentException - if the caller is missing required context.
    
    从以下版本开始:
    
    1
  - isWifiActive
```
public boolean isWifiActive()
```
    Checks whether Wi-Fi is enabled.
    The application must have the permission specified by ohos.permission.GET_WIFI_INFO.
    
    返回:
    
    Returns true if Wi-Fi is enabled; returns false otherwise.
    
    从以下版本开始:
    
    1
  - scan
```
public boolean scan()
```
    Scans Wi-Fi hotspots.
    The method is asynchronous. After the scanning is complete, the WifiEvents#EVENT_SCAN_STATE notification will be sent, and the getScanInfoList() method is invoked to obtain the result.
    The application must have the permission specified by ohos.permission.SET_WIFI_INFO and ohos.permission.LOCATION.
    
    返回:
    
    Returns true if the method is called successfully; returns false otherwise.
    
    从以下版本开始:
    
    1
  - getScanInfoList
```
public List<WifiScanInfo> getScanInfoList()
```
    Obtains the list of information about the access points detected in a Wi-Fi scan.
    The ohos.permission.LOCATION permission and ohos.permission.GET_WIFI_INFO or ohos.permission.GET_WIFI_PEERS_MAC permission is required for obtaining all available Wi-Fi access points.
    
    返回:
    
    Returns the list of information about the access points detected in a Wi-Fi scan.
    
    从以下版本开始:
    
    1
  - isConnected
```
public boolean isConnected()
```
    Checks whether a Wi-Fi connection has been set up.
    The application must have the permission specified by ohos.permission.GET_WIFI_INFO.
    
    返回:
    
    Returns true if a Wi-Fi connection has been set up; returns false otherwise.
    
    从以下版本开始:
    
    1
  - getLinkedInfo
```
public Optional<WifiLinkedInfo> getLinkedInfo()
```
    Obtains information about a Wi-Fi connection.
    The connection information includes the SSID, BSSID, and RSSI of the Wi-Fi hotspot. networkId is the unique ID of the Wi-Fi network.
    The application must have the permission specified by ohos.permission.GET_WIFI_INFO.
    
    返回:
    
    Returns the Wi-Fi connection information.
    
    从以下版本开始:
    
    1
  - getIpInfo
```
public Optional<IpInfo> getIpInfo()
```
    Obtains the IP information of a Wi-Fi connection.
    The IP information includes the host IP address, gateway address, and DNS information.
    The application must have the permission specified by ohos.permission.GET_WIFI_INFO.
    
    返回:
    
    Returns the IP information of the Wi-Fi connection.
    
    从以下版本开始:
    
    1
  - getSignalLevel
```
public int getSignalLevel(int rssi,
                          int band)
```
    Calculates the Wi-Fi signal level based on the Wi-Fi RSSI and frequency band.
    The Wi-Fi signal level ranges from 0 to 4.
    
    参数:
    
    rssi - Indicates the Wi-Fi RSSI.
    
    band - Indicates the Wi-Fi frequency band.
    
    返回:
    
    Returns the Wi-Fi signal level.
    
    从以下版本开始:
    
    2
  - getCountryCode
```
public String getCountryCode()
```
    Obtains the country code of this device.
    The application must have the permission specified by ohos.permission.GET_WIFI_INFO and ohos.permission.LOCATION.
    
    返回:
    
    Returns the country code of this device.
    
    从以下版本开始:
    
    3
  - isFeatureSupported
```
public boolean isFeatureSupported(long featureId)
```
    Checks whether this device supports a specified feature.
    
    参数:
    
    featureId - Indicates the ID of the feature to check. WifiUtils provides feature IDs, for example, WifiUtils#WIFI_FEATURE_INFRA.
    The application must have the permission specified by ohos.permission.GET_WIFI_INFO.
    
    返回:
    
    Returns true if this device supports the specified feature; returns false otherwise.
    
    从以下版本开始:
    
    3
  - addUntrustedConfig
```
public boolean addUntrustedConfig(WifiDeviceConfig config)
```
    Adds a specified untrusted hotspot configuration.
    This method adds one configuration at a time. After this configuration is added, your device will determine whether to connect to the hotspot.
    You need to obtain the following permission before calling this method: SystemPermission.SET_WIFI_INFO.
    
    参数:
    
    config - Indicates the untrusted hotspot configuration to add. The configuration can use only the Simultaneous Authentication of Equals (SAE) or pre-shared key (PSK) mode.
    
    返回:
    
    Returns true if the untrusted hotspot configuration is added; returns false otherwise.
    
    从以下版本开始:
    
    5
  - removeUntrustedConfig
```
public boolean removeUntrustedConfig(WifiDeviceConfig config)
```
    Removes a specified untrusted hotspot configuration.
    This method removes one configuration at a time.
    You need to obtain the following permission before calling this method: SystemPermission.SET_WIFI_INFO.
    
    参数:
    
    config - Indicates the untrusted hotspot configuration to remove.
    
    返回:
    
    Returns true if the untrusted hotspot configuration is removed; returns false otherwise.
    
    从以下版本开始:
    
    5

类 WifiDevice

方法概要

从类继承的方法 java.lang.Object

方法详细资料

getInstance

isWifiActive

scan

getScanInfoList

isConnected

getLinkedInfo

getIpInfo

getSignalLevel

getCountryCode

isFeatureSupported

addUntrustedConfig

removeUntrustedConfig