A partir de 2026, para alinearnos con nuestro modelo de desarrollo llamado Trunk Stable y garantizar la estabilidad de la plataforma para el ecosistema, publicaremos el código fuente en el AOSP en el segundo y cuarto trimestre. Para compilar el AOSP y contribuir a él, usa android-latest-release. La rama del manifiesto android-latest-release siempre hará referencia a la versión más reciente que se envió al AOSP. Para obtener más información, consulta Cambios en el AOSP.

Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

IWifiHelper

public interface IWifiHelper

com.android.tradefed.device.IWifiHelper

Subcategorías indirectas conocidas

WifiHelper

WifiHelper Clase de ayuda para manipular los servicios de Wi-Fi en el dispositivo.

Es una interfaz de ayuda para manipular los servicios de Wi-Fi en el dispositivo.

Resumen

Métodos públicos
`abstract boolean`	`addOpenNetwork(String ssid)` Agrega la red de seguridad abierta identificada por ssid.
`abstract boolean`	`addOpenNetwork(String ssid, boolean scanSsid)` Agrega la red de seguridad abierta identificada por ssid.
`abstract boolean`	`addWpaPskNetwork(String ssid, String psk)` Agrega la red de seguridad WPA-PSK identificada por ssid.
`abstract boolean`	`addWpaPskNetwork(String ssid, String psk, boolean scanSsid)` Agrega la red de seguridad WPA-PSK identificada por ssid.
`abstract boolean`	`checkConnectivity(String urlToCheck)` Verifica la conectividad enviando una solicitud HTTP a la URL proporcionada.
`abstract void`	`cleanUp()` Limpia los recursos y la instalación empaquetada del asistente de Wi-Fi.
`abstract boolean`	`connectToNetwork(String ssid, String psk, String urlToCheck)` Se conecta a una red Wi-Fi y verifica la conectividad.
`abstract IWifiHelper.WifiConnectionResult`	`connectToNetwork(String ssid, String psk, String urlToCheck, boolean scanSsid, String defaultType)` Se conecta a una red Wi-Fi y verifica la conectividad.
`abstract IWifiHelper.WifiConnectionResult`	`connectToNetwork(String ssid, String psk, String urlToCheck, boolean scanSsid)` Se conecta a una red Wi-Fi y verifica la conectividad.
`abstract boolean`	`disableWifi()` Inhabilita el estado de Wi-Fi en el dispositivo.
`abstract boolean`	`disconnectFromNetwork()` Desconéctate de la red Wi-Fi actual y deshabilita la conexión Wi-Fi.
`abstract boolean`	`enableWifi()` Habilita el estado de Wi-Fi en el dispositivo.
`abstract String`	`getBSSID()` Obtiene el identificador de conjunto de servicios básicos (BSSID) del punto de acceso actual.
`abstract String`	`getIpAddress()` Obtiene la dirección IP asociada con la interfaz Wi-Fi.
`abstract String`	`getSSID()` Obtiene el identificador del conjunto de servicios de la red conectada actualmente.
`abstract Map<String, String>`	`getWifiInfo()` Obtiene la información de conexión Wi-Fi actual.
`abstract boolean`	`hasValidIp()`
`abstract boolean`	`isWifiEnabled()` Comprueba si el Wi-Fi está habilitado actualmente.
`abstract boolean`	`removeAllNetworks()` Quita todas las redes conocidas.
`abstract boolean`	`startMonitor(long interval, String urlToCheck)` Inicia la supervisión de la conectividad de red.
`abstract List<Long>`	`stopMonitor()` Detiene la supervisión de la conectividad de red.
`abstract boolean`	`waitForIp(long timeout)` Espera hasta que se asigne una dirección IP al adaptador de Wi-Fi.
`abstract boolean`	`waitForWifiDisabled(long timeout)` Espera a que `isWifiEnabled()` sea falso.
`abstract boolean`	`waitForWifiDisabled()` Espera a que `isWifiEnabled()` sea falso con un tiempo de espera predeterminado.
`abstract boolean`	`waitForWifiEnabled(long timeout)` Espera a que `isWifiEnabled()` sea verdadero.
`abstract boolean`	`waitForWifiEnabled()` Espera a que `isWifiEnabled()` sea verdadero con un tiempo de espera predeterminado.
`abstract boolean`	`waitForWifiState(WifiState... expectedStates)` Espera hasta que se produzca uno de los estados de Wi-Fi esperados.

Métodos públicos

addOpenNetwork

public abstract boolean addOpenNetwork (String ssid)

Agrega la red de seguridad abierta identificada por ssid.

Para conectarse a cualquier red Wi-Fi, primero se debe crear un perfil de red en la configuración de wpa_supplicant. Esto llamará a wpa_cli para agregar la red de seguridad abierta identificada por ssid.

Parámetros
`ssid`	`String`: Es el SSID de la red que se agregará.

Muestra
`boolean`	`true` si la red se agregó correctamente; de lo contrario, `false`.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

addOpenNetwork

public abstract boolean addOpenNetwork (String ssid, 
                boolean scanSsid)

Agrega la red de seguridad abierta identificada por ssid.

Parámetros
`ssid`	`String`: Es el SSID de la red que se agregará.
`scanSsid`	`boolean`: Indica si se debe buscar el SSID oculto de esta red.

Muestra
`boolean`	`true` si la red se agregó correctamente; de lo contrario, `false`.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

addWpaPskNetwork

public abstract boolean addWpaPskNetwork (String ssid, 
                String psk)

Agrega la red de seguridad WPA-PSK identificada por ssid.

Parámetros
`ssid`	`String`: Es el SSID de la red que se agregará.
`psk`	`String`: Es la frase de contraseña de WPA-PSK que se usará.

Muestra
`boolean`	`true` si la red se agregó correctamente; de lo contrario, `false`.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

addWpaPskNetwork

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

Agrega la red de seguridad WPA-PSK identificada por ssid.

Parámetros
`ssid`	`String`: Es el SSID de la red que se agregará.
`psk`	`String`: Es la frase de contraseña de WPA-PSK que se usará.
`scanSsid`	`boolean`: Indica si se debe buscar el SSID oculto de esta red.

Muestra
`boolean`	`true` si la red se agregó correctamente; de lo contrario, `false`.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

checkConnectivity

public abstract boolean checkConnectivity (String urlToCheck)

Verifica la conectividad enviando una solicitud HTTP a la URL proporcionada.

Parámetros
`urlToCheck`	`String`: Es una URL de destino para una verificación de solicitud HTTP.

Muestra
`boolean`	`true` si el dispositivo pasa la verificación de conectividad

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

cleanUp

public abstract void cleanUp ()

Limpia los recursos y la instalación empaquetada del asistente de Wi-Fi. Solo se debe llamar a este método cuando ya no se necesita Wi-Fi para la invocación, ya que el dispositivo perdería la conexión Wi-Fi cuando se desinstale el asistente.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

connectToNetwork

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

Se conecta a una red Wi-Fi y verifica la conectividad.

Parámetros
`ssid`	`String`: Es el SSID de la red a la que se conectará.
`psk`	`String`: Es la frase de contraseña de WPA-PSK que se usará. Puede ser nulo.
`urlToCheck`	`String`: Es una URL de destino para una verificación de solicitud HTTP.

Muestra
`boolean`	`true` si el dispositivo pasa la verificación de conectividad

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

connectToNetwork

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

Se conecta a una red Wi-Fi y verifica la conectividad.

Parámetros
`ssid`	`String`: Es el SSID de la red a la que se conectará.
`psk`	`String`: Es la frase de contraseña de WPA-PSK que se usará. Puede ser nulo.
`urlToCheck`	`String`: Es una URL de destino para una verificación de solicitud HTTP.
`scanSsid`	`boolean`: Indica si se debe buscar el SSID oculto de esta red.
`defaultType`	`String`: Es el tipo de red predeterminado al que se recurre si no se determina el tipo de red del SSID.

Muestra
`IWifiHelper.WifiConnectionResult`	WifiConnectionResult que representa el resultado de la conexión Wi-Fi

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

connectToNetwork

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

Se conecta a una red Wi-Fi y verifica la conectividad.

Parámetros
`ssid`	`String`: Es el SSID de la red a la que se conectará.
`psk`	`String`: Es la frase de contraseña de WPA-PSK que se usará. Puede ser nulo.
`urlToCheck`	`String`: Es una URL de destino para una verificación de solicitud HTTP.
`scanSsid`	`boolean`: Indica si se debe buscar el SSID oculto de esta red.

Muestra
`IWifiHelper.WifiConnectionResult`	WifiConnectionResult que representa el resultado de la conexión Wi-Fi

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

disableWifi

public abstract boolean disableWifi ()

Inhabilita el estado de Wi-Fi en el dispositivo.

Muestra
`boolean`	`true` si se inhabilitó el Wi-Fi correctamente

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

disconnectFromNetwork

public abstract boolean disconnectFromNetwork ()

Desconéctate de la red Wi-Fi actual y deshabilita la conexión Wi-Fi.

Muestra
`boolean`	`true` si la operación se realizó correctamente.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

enableWifi

public abstract boolean enableWifi ()

Habilita el estado de Wi-Fi en el dispositivo.

Muestra
`boolean`	`true` si la conexión Wi-Fi se habilitó correctamente

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBSSID

public abstract String getBSSID ()

Obtiene el identificador de conjunto de servicios básicos (BSSID) del punto de acceso actual.

Muestra
`String`

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

También:

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

getIpAddress

public abstract String getIpAddress ()

Obtiene la dirección IP asociada con la interfaz Wi-Fi. Devuelve null si no se pudo recuperar la dirección IP.

Muestra
`String`

Arroja
`DeviceNotAvailableException`

getSSID

public abstract String getSSID ()

Obtiene el identificador del conjunto de servicios de la red conectada actualmente.

Muestra
`String`

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

También:

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

getWifiInfo

public abstract Map<String, String> getWifiInfo ()

Obtiene la información de conexión Wi-Fi actual.

Esto incluye el SSID, el BSSID, la dirección IP, la velocidad de vínculo y el RSSI.

Muestra
`Map<String, String>`	Un mapa que contiene información de conexión Wi-Fi.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

hasValidIp

public abstract boolean hasValidIp ()

Muestra
`boolean`	`true` si el dispositivo tiene una dirección IP válida

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isWifiEnabled

public abstract boolean isWifiEnabled ()

Comprueba si el Wi-Fi está habilitado actualmente.

Muestra
`boolean`

Arroja
`DeviceNotAvailableException`

removeAllNetworks

public abstract boolean removeAllNetworks ()

Quita todas las redes conocidas.

Muestra
`boolean`

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

startMonitor

public abstract boolean startMonitor (long interval, 
                String urlToCheck)

Inicia la supervisión de la conectividad de red.

Parámetros
`interval`	`long`: Intervalo entre las verificaciones de conectividad.
`urlToCheck`	`String`: Es una URL para verificar la conectividad.

Muestra
`boolean`	`true` si la operación se realizó correctamente.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

stopMonitor

public abstract List<Long> stopMonitor ()

Detiene la supervisión de la conectividad de red.

También devuelve el historial de latencia desde la última llamada a IWifiHelper.startMonitor(long,String).

Muestra
`List<Long>`	el historial de latencia.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForIp

public abstract boolean waitForIp (long timeout)

Espera hasta que se asigne una dirección IP al adaptador de Wi-Fi.

Parámetros
`timeout`	`long`: Cuánto tiempo esperar

Muestra
`boolean`	`true` si se asigna una dirección IP antes del tiempo de espera; de lo contrario, `false`

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForWifiDisabled

public abstract boolean waitForWifiDisabled (long timeout)

Espera a que isWifiEnabled() sea falso.

Parámetros
`timeout`	`long`: Tiempo en ms para esperar

Muestra
`boolean`	`true` si se inhabilitó el Wi-Fi antes del tiempo de espera; de lo contrario, `false`.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForWifiDisabled

public abstract boolean waitForWifiDisabled ()

Espera a que isWifiEnabled() sea falso con un tiempo de espera predeterminado.

Muestra
`boolean`	`true` si se inhabilitó el Wi-Fi antes del tiempo de espera; de lo contrario, `false`.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForWifiEnabled

public abstract boolean waitForWifiEnabled (long timeout)

Espera a que isWifiEnabled() sea verdadero.

Parámetros
`timeout`	`long`: Tiempo en ms para esperar

Muestra
`boolean`	`true` si el Wi-Fi estaba habilitado antes del tiempo de espera; de lo contrario, `false`.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForWifiEnabled

public abstract boolean waitForWifiEnabled ()

Espera a que isWifiEnabled() sea verdadero con un tiempo de espera predeterminado.

Muestra
`boolean`	`true` si el Wi-Fi estaba habilitado antes del tiempo de espera; de lo contrario, `false`.

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForWifiState

public abstract boolean waitForWifiState (WifiState... expectedStates)

Espera hasta que se produzca uno de los estados de Wi-Fi esperados.

Parámetros
`expectedStates`	`WifiState`: Uno o más estados de Wi-Fi esperados

Muestra
`boolean`	`true` si se produjo uno de los estados esperados. `false` si ninguno de los estados ocurrió antes de que se alcanzara el tiempo de espera

Arroja
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`