Google 致力于为黑人社区推动种族平等。查看具体举措
此页面由 Cloud Translation API 翻译。
Switch to English

IWifi助手

interface IWifiHelper

com.android.tradefed.device.IWifiHelper


用于在设备上操纵wifi服务的帮助程序界面。

摘要

嵌套类

enum IWifiHelper.WifiState

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请求发送到给定的URL来检查连接性。

abstract void cleanUp ()

清理资源,然后打包安装wifi helper。

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

连接到wifi网络并检查连接性。

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

连接到wifi网络并检查连接性。

abstract boolean disableWifi ()

在设备上禁用wifi状态。

abstract boolean disconnectFromNetwork ()

断开当前的wifi网络并禁用wifi。

abstract boolean enableWifi ()

在设备上启用wifi状态。

abstract String getBSSID ()

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

abstract String getIpAddress ()

获取与wifi接口关联的IP地址。

abstract String getSSID ()

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

abstract Map<String, String> getWifiInfo ()

获取当前的wifi连接信息。

abstract boolean hasValidIp ()
abstract boolean isWifiEnabled ()

检查当前是否启用了wifi。

abstract boolean removeAllNetworks ()

删除所有已知的网络。

abstract boolean startMonitor (long interval, String urlToCheck)

启动网络连接监视。

abstract List<Long> stopMonitor ()

停止网络连接监视。

abstract boolean waitForIp (long timeout)

等待一个IP地址分配给wifi适配器。

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)

等待直到出现预期的wifi状态之一。

公开方法

addOpenNetwork

public abstract boolean addOpenNetwork (String ssid)

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

要连接到任何wifi网络,必须首先在wpa_supplicant配置中创建网络配置文件。这将调用wpa_cli以添加由ssid标识的开放安全网络。

参量
ssid String :要添加的网络的ssid。

退货
boolean 如果网络添加成功,则为true ,否则为false

投掷
DeviceNotAvailableException

addOpenNetwork

public abstract boolean addOpenNetwork (String ssid, 
                boolean scanSsid)

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

要连接到任何wifi网络,必须首先在wpa_supplicant配置中创建网络配置文件。这将调用wpa_cli以添加由ssid标识的开放安全网络。

参量
ssid String :要添加的网络的ssid。

scanSsid boolean :是否扫描此网络的隐藏SSID。

退货
boolean 如果网络添加成功,则为true ,否则为false

投掷
DeviceNotAvailableException

addWpaPskNetwork

public abstract boolean addWpaPskNetwork (String ssid, 
                String psk)

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

参量
ssid String :要添加的网络的ssid。

psk String :要使用的WPA-PSK密码

退货
boolean 如果网络添加成功,则为true ,否则为false

投掷
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

投掷
DeviceNotAvailableException

checkConnectivity

public abstract boolean checkConnectivity (String urlToCheck)

通过将HTTP请求发送到给定的URL来检查连接性。

参量
urlToCheck String :HTTP请求检查的目标URL

退货
boolean 如果设备通过连接检查,则为true

投掷
DeviceNotAvailableException

清理

public abstract void cleanUp ()

清理资源,然后打包安装wifi helper。仅当不再需要Wifi进行调用时才应调用此方法,因为在卸载助手时设备将失去wifi连接。

投掷
DeviceNotAvailableException

connectToNetwork

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

连接到wifi网络并检查连接性。

参量
ssid String :要连接的网络的ssid

psk String :要使用的WPA-PSK密码短语。可以为空。

urlToCheck String :HTTP请求检查的目标URL

退货
boolean 如果设备通过连接检查,则为true

投掷
DeviceNotAvailableException

connectToNetwork

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

连接到wifi网络并检查连接性。

参量
ssid String :要连接的网络的ssid

psk String :要使用的WPA-PSK密码短语。可以为空。

urlToCheck String :HTTP请求检查的目标URL

scanSsid boolean :是否扫描此网络的隐藏SSID

退货
boolean 如果设备通过连接检查,则为true

投掷
DeviceNotAvailableException

禁用WiFi

public abstract boolean disableWifi ()

在设备上禁用wifi状态。

退货
boolean 如果成功禁用wifi,则为true

投掷
DeviceNotAvailableException

从网络断开

public abstract boolean disconnectFromNetwork ()

断开当前的wifi网络并禁用wifi。

退货
boolean 如果操作成功,则为true

投掷
DeviceNotAvailableException

enableWifi

public abstract boolean enableWifi ()

在设备上启用wifi状态。

退货
boolean 如果成功启用wifi,则为true

投掷
DeviceNotAvailableException

getBSSID

public abstract String getBSSID ()

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

退货
String

投掷
DeviceNotAvailableException

getIpAddress

public abstract String getIpAddress ()

获取与wifi接口关联的IP地址。如果检索IP地址失败,则返回null

退货
String

投掷
DeviceNotAvailableException

getSSID

public abstract String getSSID ()

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

退货
String

投掷
DeviceNotAvailableException

getWifiInfo

public abstract Map<String, String> getWifiInfo ()

获取当前的wifi连接信息。

这包括SSID,BSSID,IP地址,链接速度和RSSI。

退货
Map<String, String> 包含wifi连接信息的地图。

投掷
DeviceNotAvailableException

hasValidIp

public abstract boolean hasValidIp ()

退货
boolean 如果设备具有有效的IP地址,则为true

投掷
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

检查当前是否启用了wifi。

退货
boolean

投掷
DeviceNotAvailableException

removeAllNetworks

public abstract boolean removeAllNetworks ()

删除所有已知的网络。

退货
boolean

投掷
DeviceNotAvailableException

startMonitor

public abstract boolean startMonitor (long interval, 
                String urlToCheck)

启动网络连接监视。

参量
interval long :连接检查之间的间隔。

urlToCheck String :用于检查连接性的URL。

退货
boolean 如果操作成功,则为true

投掷
DeviceNotAvailableException

stopMonitor

public abstract List<Long> stopMonitor ()

停止网络连接监视。

这还将返回自上次startMonitor(long, String)调用以来的延迟历史记录。

退货
List<Long> 延迟历史记录。

投掷
DeviceNotAvailableException

waitForIp

public abstract boolean waitForIp (long timeout)

等待一个IP地址分配给wifi适配器。

参量
timeout long :等待多长时间

退货
boolean true如果一个IP地址超时,之前分配的false ,否则

投掷
DeviceNotAvailableException

waitForWifiDisabled

public abstract boolean waitForWifiDisabled (long timeout)

等待isWifiEnabled()为false。

参量
timeout long :等待时间(以毫秒为单位)

退货
boolean 如果在超时之前禁用了wifi,则为true ,否则为false

投掷
DeviceNotAvailableException

waitForWifiDisabled

public abstract boolean waitForWifiDisabled ()

等待isWifiEnabled()为false并具有默认超时。

退货
boolean 如果在超时之前禁用了wifi,则为true ,否则为false

投掷
DeviceNotAvailableException

waitForWifiEnabled

public abstract boolean waitForWifiEnabled (long timeout)

等待isWifiEnabled()为true。

参量
timeout long :等待时间(以毫秒为单位)

退货
boolean 如果在超时之前启用了wifi,则为true ,否则为false

投掷
DeviceNotAvailableException

waitForWifiEnabled

public abstract boolean waitForWifiEnabled ()

等待isWifiEnabled()为true并具有默认超时。

退货
boolean 如果在超时之前启用了wifi,则为true ,否则为false

投掷
DeviceNotAvailableException

waitForWifiState

public abstract boolean waitForWifiState ( WifiState... expectedStates)

等待直到出现预期的wifi状态之一。

参量
expectedStates WifiState :可以预期的一个或多个WiFi状态

退货
boolean 如果预期状态之一发生,则为true 。如果在达到超时之前未发生任何状态,则返回false

投掷
DeviceNotAvailableException