自 2026 年起，为了与我们的主干稳定开发模型保持一致，并确保生态系统的平台稳定性，我们将在第 2 季度和第 4 季度向 AOSP 发布源代码。如需构建 AOSP 并为其贡献代码，请使用 android-latest-release。android-latest-release 清单分支将始终引用推送到 AOSP 的最新版本。如需了解详情，请参阅 AOSP 变更。

Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

IWifiHelper

public interface IWifiHelper

com.android.tradefed.device.IWifiHelper

已知的间接子类

WifiHelper

WifiHelper 用于在设备上操控 Wi-Fi 服务的辅助类。

用于在设备上操控 WiFi 服务的辅助接口。

摘要

公共方法
`abstract boolean`	`addOpenNetwork(String ssid)` 添加由 SSID 标识的开放安全网络。
`abstract boolean`	`addOpenNetwork(String ssid, boolean scanSsid)` 添加由 SSID 标识的开放安全网络。
`abstract boolean`	`addWpaPskNetwork(String ssid, String psk)` 添加由 SSID 标识的 WPA-PSK 安全网络。
`abstract boolean`	`addWpaPskNetwork(String ssid, String psk, boolean scanSsid)` 添加由 SSID 标识的 WPA-PSK 安全网络。
`abstract boolean`	`checkConnectivity(String urlToCheck)` 通过向指定网址发送 HTTP 请求来检查连接。
`abstract void`	`cleanUp()` 清理资源和 WiFi 帮助程序软件包安装。
`abstract boolean`	`connectToNetwork(String ssid, String psk, String urlToCheck)` 连接到 WLAN 网络并检查连接。
`abstract IWifiHelper.WifiConnectionResult`	`connectToNetwork(String ssid, String psk, String urlToCheck, boolean scanSsid, String defaultType)` 连接到 WLAN 网络并检查连接。
`abstract IWifiHelper.WifiConnectionResult`	`connectToNetwork(String ssid, String psk, String urlToCheck, boolean scanSsid)` 连接到 WLAN 网络并检查连接。
`abstract boolean`	`disableWifi()` 停用设备上的 Wi-Fi 状态。
`abstract boolean`	`disconnectFromNetwork()` 断开与当前 Wi-Fi 网络的连接并停用 Wi-Fi。
`abstract boolean`	`enableWifi()` 启用设备上的 Wi-Fi 状态。
`abstract String`	`getBSSID()` 获取当前接入点的基本服务集标识符 (BSSID)。
`abstract String`	`getIpAddress()` 获取与 Wi-Fi 接口相关联的 IP 地址。
`abstract String`	`getSSID()` 获取当前已连接网络的服务集标识符。
`abstract Map<String, String>`	`getWifiInfo()` 获取当前的 Wi-Fi 连接信息。
`abstract boolean`	`hasValidIp()`
`abstract boolean`	`isWifiEnabled()` 检查 Wi-Fi 是否已启用。
`abstract boolean`	`removeAllNetworks()` 移除所有已知网络。
`abstract boolean`	`startMonitor(long interval, String urlToCheck)` 开始监控网络连接。
`abstract List<Long>`	`stopMonitor()` 停止网络连接监控。
`abstract boolean`	`waitForIp(long timeout)` 等待系统为 WLAN 适配器分配 IP 地址。
`abstract boolean`	`waitForWifiDisabled(long timeout)` 等待 `isWifiEnabled()` 为 false。
`abstract boolean`	`waitForWifiDisabled()` 等待 `isWifiEnabled()` 变为 false，并使用默认超时时间。
`abstract boolean`	`waitForWifiEnabled(long timeout)` 等待 `isWifiEnabled()` 为 true。
`abstract boolean`	`waitForWifiEnabled()` 等待 `isWifiEnabled()` 为 true，并使用默认超时时间。
`abstract boolean`	`waitForWifiState(WifiState... expectedStates)` 等待直到出现其中一种预期 Wi-Fi 状态。

公共方法

addOpenNetwork

public abstract boolean addOpenNetwork (String ssid)

添加由 SSID 标识的开放安全网络。

如需连接到任何 WLAN 网络，必须先在 wpa_supplicant 配置中创建网络配置文件。这将调用 wpa_cli 来添加由 ssid 标识的开放安全网络。

参数
`ssid`	`String`：要添加的网络的 SSID。

返回
`boolean`	如果成功添加了网络，则为 `true`；否则为 `false`。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

addOpenNetwork

public abstract boolean addOpenNetwork (String ssid, 
                boolean scanSsid)

添加由 SSID 标识的开放安全网络。

如需连接到任何 WLAN 网络，必须先在 wpa_supplicant 配置中创建网络配置文件。这将调用 wpa_cli 来添加由 ssid 标识的开放安全网络。

参数
`ssid`	`String`：要添加的网络的 SSID。
`scanSsid`	`boolean`：是否扫描此网络的隐藏 SSID。

返回
`boolean`	如果成功添加了网络，则为 `true`；否则为 `false`。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

addWpaPskNetwork

public abstract boolean addWpaPskNetwork (String ssid, 
                String psk)

添加由 SSID 标识的 WPA-PSK 安全网络。

参数
`ssid`	`String`：要添加的网络的 SSID。
`psk`	`String`：要使用的 WPA-PSK 密码

返回
`boolean`	如果成功添加了网络，则为 `true`；否则为 `false`。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

addWpaPskNetwork

public abstract boolean addWpaPskNetwork (String ssid, 
                String psk, 
                boolean scanSsid)

添加由 SSID 标识的 WPA-PSK 安全网络。

参数
`ssid`	`String`：要添加的网络的 SSID。
`psk`	`String`：要使用的 WPA-PSK 密码
`scanSsid`	`boolean`：是否扫描此网络的隐藏 SSID。

返回
`boolean`	如果成功添加了网络，则为 `true`；否则为 `false`。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

checkConnectivity

public abstract boolean checkConnectivity (String urlToCheck)

通过向指定网址发送 HTTP 请求来检查连接。

参数
`urlToCheck`	`String`：用于 HTTP 请求检查的目标网址

返回
`boolean`	`true` 设备是否通过连接检查。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

cleanUp

public abstract void cleanUp ()

清理资源和 WiFi 帮助程序软件包安装。仅当调用不再需要 Wi-Fi 时才应调用此方法，因为当卸载辅助程序时，设备会失去 Wi-Fi 连接。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

connectToNetwork

public abstract boolean connectToNetwork (String ssid, 
                String psk, 
                String urlToCheck)

连接到 WLAN 网络并检查连接。

参数
`ssid`	`String`：要连接的网络的 SSID
`psk`	`String`：要使用的 WPA-PSK 口令。此字段可为 null。
`urlToCheck`	`String`：用于 HTTP 请求检查的目标网址

返回
`boolean`	`true` 设备是否通过连接检查。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

connectToNetwork

public abstract IWifiHelper.WifiConnectionResult connectToNetwork (String ssid, 
                String psk, 
                String urlToCheck, 
                boolean scanSsid, 
                String defaultType)

连接到 WLAN 网络并检查连接。

参数
`ssid`	`String`：要连接的网络的 SSID
`psk`	`String`：要使用的 WPA-PSK 口令。此字段可为 null。
`urlToCheck`	`String`：用于 HTTP 请求检查的目标网址
`scanSsid`	`boolean`：是否扫描此网络的隐藏 SSID
`defaultType`	`String`：如果无法确定 SSID 的网络类型，则回退到的默认网络类型

返回
`IWifiHelper.WifiConnectionResult`	表示 Wi-Fi 连接结果的 WifiConnectionResult

抛出
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

connectToNetwork

public abstract IWifiHelper.WifiConnectionResult connectToNetwork (String ssid, 
                String psk, 
                String urlToCheck, 
                boolean scanSsid)

连接到 WLAN 网络并检查连接。

参数
`ssid`	`String`：要连接的网络的 SSID
`psk`	`String`：要使用的 WPA-PSK 口令。此字段可为 null。
`urlToCheck`	`String`：用于 HTTP 请求检查的目标网址
`scanSsid`	`boolean`：是否扫描此网络的隐藏 SSID

返回
`IWifiHelper.WifiConnectionResult`	表示 Wi-Fi 连接结果的 WifiConnectionResult

抛出
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

disableWifi

public abstract boolean disableWifi ()

停用设备上的 Wi-Fi 状态。

返回
`boolean`	如果成功停用 Wi-Fi，则为 `true`

抛出
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

disconnectFromNetwork

public abstract boolean disconnectFromNetwork ()

断开与当前 Wi-Fi 网络的连接，并停用 Wi-Fi。

返回
`boolean`	如果操作成功，则为 `true`。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

enableWifi

public abstract boolean enableWifi ()

在设备上启用 Wi-Fi 状态。

返回
`boolean`	如果成功启用 Wi-Fi，则为 `true`

抛出
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBSSID

public abstract String getBSSID ()

获取当前接入点的基本服务集标识符 (BSSID)。

返回
`String`

抛出
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

另见：

http://developer.android.com/reference/android/net/wifi/WifiInfo.html#getSSID()

getIpAddress

public abstract String getIpAddress ()

获取与 Wi-Fi 接口关联的 IP 地址。如果检索 IP 地址失败，则返回 null。

返回
`String`

抛出
`DeviceNotAvailableException`

getSSID

public abstract String getSSID ()

获取当前已连接网络的服务集标识符。

返回
`String`

抛出
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

另见：

http://developer.android.com/reference/android/net/wifi/WifiInfo.html#getSSID()

getWifiInfo

public abstract Map<String, String> getWifiInfo ()

获取当前的 Wi-Fi 连接信息。

这包括 SSID、BSSID、IP 地址、链路速度和 RSSI。

返回
`Map<String, String>`	包含 WLAN 连接信息的地图。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

hasValidIp

public abstract boolean hasValidIp ()

返回
`boolean`	`true`（如果设备具有有效的 IP 地址）

抛出
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isWifiEnabled

public abstract boolean isWifiEnabled ()

检查 Wi-Fi 目前是否已启用。

返回
`boolean`

抛出
`DeviceNotAvailableException`

removeAllNetworks

public abstract boolean removeAllNetworks ()

移除所有已知网络。

返回
`boolean`

抛出
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

startMonitor

public abstract boolean startMonitor (long interval, 
                String urlToCheck)

启动网络连接监控。

参数
`interval`	`long`：连接检查之间的时间间隔。
`urlToCheck`	`String`：用于检查连接性的网址。

返回
`boolean`	如果操作成功，则为 `true`。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

stopMonitor

public abstract List<Long> stopMonitor ()

停止网络连接监控。

此方法还会返回自上次 IWifiHelper.startMonitor(long,String) 调用以来的延迟时间历史记录。

返回
`List<Long>`	延迟时间历史记录。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForIp

public abstract boolean waitForIp (long timeout)

等待系统为 WLAN 适配器分配 IP 地址。

参数
`timeout`	`long`：等待时长

返回
`boolean`	如果在超时之前分配了 IP 地址，则为 `true`；否则为 `false`

抛出
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForWifiDisabled

public abstract boolean waitForWifiDisabled (long timeout)

等待 isWifiEnabled() 变为 false。

参数
`timeout`	`long`：等待时间（以毫秒为单位）

返回
`boolean`	如果 Wi-Fi 在超时之前被停用，则为 `true`；否则为 `false`。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForWifiDisabled

public abstract boolean waitForWifiDisabled ()

等待 isWifiEnabled() 变为 false，并使用默认超时时间。

返回
`boolean`	如果 Wi-Fi 在超时之前被停用，则为 `true`；否则为 `false`。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForWifiEnabled

public abstract boolean waitForWifiEnabled (long timeout)

等待 isWifiEnabled() 变为 true。

参数
`timeout`	`long`：等待时间（以毫秒为单位）

返回
`boolean`	如果 Wi-Fi 在超时之前已启用，则为 `true`，否则为 `false`。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForWifiEnabled

public abstract boolean waitForWifiEnabled ()

等待 isWifiEnabled() 变为 true，并使用默认超时时间。

返回
`boolean`	如果 Wi-Fi 在超时之前已启用，则为 `true`，否则为 `false`。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForWifiState

public abstract boolean waitForWifiState (WifiState... expectedStates)

等待直到出现预期的 Wi-Fi 状态。

参数
`expectedStates`	`WifiState`：要预期的一个或多个 Wi-Fi 状态

返回
`boolean`	如果出现了某个预期状态，则为 `true`。`false` 如果在达到超时时间之前未出现任何状态

抛出
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`