Em 2026, para nos alinharmos ao nosso modelo de desenvolvimento estável e garantir a estabilidade da plataforma para o ecossistema, vamos publicar o código-fonte no AOSP no segundo e quarto trimestres. Para criar e contribuir com o AOSP, use android-latest-release. A ramificação de manifesto android-latest-release sempre vai referenciar a versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

IWifiHelper

public interface IWifiHelper

com.android.tradefed.device.IWifiHelper

Subclasses indiretas conhecidas

WifiHelper

WifiHelper Classe auxiliar para manipular serviços de Wi-Fi no dispositivo.

Interface auxiliar para manipular serviços de Wi-Fi no dispositivo.

Resumo

Métodos públicos
`abstract boolean`	`addOpenNetwork(String ssid)` Adiciona a rede de segurança aberta identificada pelo SSID.
`abstract boolean`	`addOpenNetwork(String ssid, boolean scanSsid)` Adiciona a rede de segurança aberta identificada pelo SSID.
`abstract boolean`	`addWpaPskNetwork(String ssid, String psk)` Adiciona a rede de segurança WPA-PSK identificada por ssid.
`abstract boolean`	`addWpaPskNetwork(String ssid, String psk, boolean scanSsid)` Adiciona a rede de segurança WPA-PSK identificada por ssid.
`abstract boolean`	`checkConnectivity(String urlToCheck)` Verifica a conectividade enviando uma solicitação HTTP para o URL especificado.
`abstract void`	`cleanUp()` Limpe os recursos e a instalação do pacote do assistente de Wi-Fi.
`abstract boolean`	`connectToNetwork(String ssid, String psk, String urlToCheck)` Conecta-se a uma rede Wi-Fi e verifica a conectividade.
`abstract IWifiHelper.WifiConnectionResult`	`connectToNetwork(String ssid, String psk, String urlToCheck, boolean scanSsid, String defaultType)` Conecta-se a uma rede Wi-Fi e verifica a conectividade.
`abstract IWifiHelper.WifiConnectionResult`	`connectToNetwork(String ssid, String psk, String urlToCheck, boolean scanSsid)` Conecta-se a uma rede Wi-Fi e verifica a conectividade.
`abstract boolean`	`disableWifi()` Desativa o estado do Wi-Fi no dispositivo.
`abstract boolean`	`disconnectFromNetwork()` Desconecte-se da rede Wi-Fi atual e desative o Wi-Fi.
`abstract boolean`	`enableWifi()` Ativa o estado do Wi-Fi no dispositivo.
`abstract String`	`getBSSID()` Recebe o identificador do conjunto de serviços básicos (BSSID) do ponto de acesso atual.
`abstract String`	`getIpAddress()` Recebe o endereço IP associado à interface Wi-Fi.
`abstract String`	`getSSID()` Recebe o identificador do conjunto de serviços da rede conectada no momento.
`abstract Map<String, String>`	`getWifiInfo()` Recebe as informações atuais de conexão Wi-Fi.
`abstract boolean`	`hasValidIp()`
`abstract boolean`	`isWifiEnabled()` Verifique se o Wi-Fi está ativado.
`abstract boolean`	`removeAllNetworks()` Remove todas as redes conhecidas.
`abstract boolean`	`startMonitor(long interval, String urlToCheck)` Inicia o monitoramento da conectividade de rede.
`abstract List<Long>`	`stopMonitor()` Interrompe o monitoramento da conectividade de rede.
`abstract boolean`	`waitForIp(long timeout)` Aguarde até que um endereço IP seja atribuído ao adaptador Wi-Fi.
`abstract boolean`	`waitForWifiDisabled(long timeout)` Aguarde até que `isWifiEnabled()` seja "false".
`abstract boolean`	`waitForWifiDisabled()` Aguarde até que `isWifiEnabled()` seja falso com um tempo limite padrão.
`abstract boolean`	`waitForWifiEnabled(long timeout)` Aguarde até que `isWifiEnabled()` seja verdadeiro.
`abstract boolean`	`waitForWifiEnabled()` Aguarde até que `isWifiEnabled()` seja verdadeiro com um tempo limite padrão.
`abstract boolean`	`waitForWifiState(WifiState... expectedStates)` Aguarde até que um dos estados de Wi-Fi esperados ocorra.

Métodos públicos

addOpenNetwork

public abstract boolean addOpenNetwork (String ssid)

Adiciona a rede de segurança aberta identificada pelo SSID.

Para se conectar a qualquer rede Wi-Fi, primeiro é preciso criar um perfil de rede na configuração do wpa_supplicant. Isso vai chamar o wpa_cli para adicionar a rede de segurança aberta identificada por ssid.

Parâmetros
`ssid`	`String`: o SSID da rede a ser adicionada.

Retorna
`boolean`	`true` se a rede foi adicionada com sucesso. Caso contrário, `false`.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

addOpenNetwork

public abstract boolean addOpenNetwork (String ssid, 
                boolean scanSsid)

Adiciona a rede de segurança aberta identificada pelo SSID.

Parâmetros
`ssid`	`String`: o SSID da rede a ser adicionada.
`scanSsid`	`boolean`: se é necessário verificar o SSID oculto desta rede.

Retorna
`boolean`	`true` se a rede foi adicionada com sucesso. Caso contrário, `false`.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

addWpaPskNetwork

public abstract boolean addWpaPskNetwork (String ssid, 
                String psk)

Adiciona a rede de segurança WPA-PSK identificada por ssid.

Parâmetros
`ssid`	`String`: o SSID da rede a ser adicionada.
`psk`	`String`: a senha WPA-PSK a ser usada

Retorna
`boolean`	`true` se a rede foi adicionada com sucesso. Caso contrário, `false`.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

addWpaPskNetwork

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

Adiciona a rede de segurança WPA-PSK identificada por ssid.

Parâmetros
`ssid`	`String`: o SSID da rede a ser adicionada.
`psk`	`String`: a senha WPA-PSK a ser usada
`scanSsid`	`boolean`: se é necessário verificar o SSID oculto desta rede.

Retorna
`boolean`	`true` se a rede foi adicionada com sucesso. Caso contrário, `false`.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

checkConnectivity

public abstract boolean checkConnectivity (String urlToCheck)

Verifica a conectividade enviando uma solicitação HTTP para o URL especificado.

Parâmetros
`urlToCheck`	`String`: um URL de destino para uma verificação de solicitação HTTP.

Retorna
`boolean`	`true` se o dispositivo passar na verificação de conectividade.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

cleanUp

public abstract void cleanUp ()

Limpe os recursos e a instalação do pacote do assistente de Wi-Fi. Isso só deve ser chamado quando o Wi-Fi não for mais necessário para a invocação, já que o dispositivo perderia a conexão Wi-Fi quando o auxiliar for desinstalado.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

connectToNetwork

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

Conecta-se a uma rede Wi-Fi e verifica a conectividade.

Parâmetros
`ssid`	`String`: o SSID da rede a ser conectada
`psk`	`String`: a senha WPA-PSK a ser usada. Pode ser nulo.
`urlToCheck`	`String`: um URL de destino para uma verificação de solicitação HTTP.

Retorna
`boolean`	`true` se o dispositivo passar na verificação de conectividade.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

connectToNetwork

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

Conecta-se a uma rede Wi-Fi e verifica a conectividade.

Parâmetros
`ssid`	`String`: o SSID da rede a ser conectada
`psk`	`String`: a senha WPA-PSK a ser usada. Pode ser nulo.
`urlToCheck`	`String`: um URL de destino para uma verificação de solicitação HTTP.
`scanSsid`	`boolean`: se é necessário verificar o SSID oculto desta rede.
`defaultType`	`String`: tipo de rede padrão para usar se o tipo de rede do SSID não for determinado.

Retorna
`IWifiHelper.WifiConnectionResult`	WifiConnectionResult que representa o resultado da conexão Wi-Fi.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

connectToNetwork

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

Conecta-se a uma rede Wi-Fi e verifica a conectividade.

Parâmetros
`ssid`	`String`: o SSID da rede a ser conectada
`psk`	`String`: a senha WPA-PSK a ser usada. Pode ser nulo.
`urlToCheck`	`String`: um URL de destino para uma verificação de solicitação HTTP.
`scanSsid`	`boolean`: se é necessário verificar o SSID oculto desta rede.

Retorna
`IWifiHelper.WifiConnectionResult`	WifiConnectionResult que representa o resultado da conexão Wi-Fi.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

disableWifi

public abstract boolean disableWifi ()

Desativa o estado do Wi-Fi no dispositivo.

Retorna
`boolean`	`true` se o Wi-Fi foi desativado

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

disconnectFromNetwork

public abstract boolean disconnectFromNetwork ()

Desconecte-se da rede Wi-Fi atual e desative o Wi-Fi.

Retorna
`boolean`	`true` se a operação for bem-sucedida.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

enableWifi

public abstract boolean enableWifi ()

Ativa o estado do Wi-Fi no dispositivo.

Retorna
`boolean`	`true` se o Wi-Fi foi ativado com sucesso

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBSSID

public abstract String getBSSID ()

Recebe o identificador do conjunto de serviços básicos (BSSID) do ponto de acesso atual.

Retorna
`String`

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

Confira também:

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

getIpAddress

public abstract String getIpAddress ()

Recebe o endereço IP associado à interface Wi-Fi. Retorna null se houver uma falha ao recuperar o endereço IP.

Retorna
`String`

Gera
`DeviceNotAvailableException`

getSSID

public abstract String getSSID ()

Recebe o identificador do conjunto de serviços da rede conectada no momento.

Retorna
`String`

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

Confira também:

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

getWifiInfo

public abstract Map<String, String> getWifiInfo ()

Recebe as informações atuais de conexão Wi-Fi.

Isso inclui SSID, BSSID, endereço IP, velocidade do link e RSSI.

Retorna
`Map<String, String>`	um mapa com informações de conexão Wi-Fi.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

hasValidIp

public abstract boolean hasValidIp ()

Retorna
`boolean`	`true` se o dispositivo tiver um endereço IP válido

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isWifiEnabled

public abstract boolean isWifiEnabled ()

Verifique se o Wi-Fi está ativado.

Retorna
`boolean`

Gera
`DeviceNotAvailableException`

removeAllNetworks

public abstract boolean removeAllNetworks ()

Remove todas as redes conhecidas.

Retorna
`boolean`

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

startMonitor

public abstract boolean startMonitor (long interval, 
                String urlToCheck)

Inicia o monitoramento da conectividade de rede.

Parâmetros
`interval`	`long`: intervalo entre as verificações de conectividade.
`urlToCheck`	`String`: um URL para verificar a conectividade.

Retorna
`boolean`	`true` se a operação for bem-sucedida.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

stopMonitor

public abstract List<Long> stopMonitor ()

Interrompe o monitoramento da conectividade de rede.

Isso também retorna o histórico de latência desde a última chamada IWifiHelper.startMonitor(long,String).

Retorna
`List<Long>`	o histórico de latência.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForIp

public abstract boolean waitForIp (long timeout)

Aguarde até que um endereço IP seja atribuído ao adaptador Wi-Fi.

Parâmetros
`timeout`	`long`: quanto tempo esperar

Retorna
`boolean`	`true` se um endereço IP for atribuído antes do tempo limite, `false` caso contrário.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForWifiDisabled

public abstract boolean waitForWifiDisabled (long timeout)

Aguarde até que isWifiEnabled() seja "false".

Parâmetros
`timeout`	`long`: tempo em ms para aguardar

Retorna
`boolean`	`true` se o Wi-Fi foi desativado antes do tempo limite, `false` caso contrário.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForWifiDisabled

public abstract boolean waitForWifiDisabled ()

Aguarde até que isWifiEnabled() seja falso com um tempo limite padrão.

Retorna
`boolean`	`true` se o Wi-Fi foi desativado antes do tempo limite, `false` caso contrário.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForWifiEnabled

public abstract boolean waitForWifiEnabled (long timeout)

Aguarde até que isWifiEnabled() seja verdadeiro.

Parâmetros
`timeout`	`long`: tempo em ms para aguardar

Retorna
`boolean`	`true` se o Wi-Fi foi ativado antes do tempo limite. Caso contrário, `false`.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForWifiEnabled

public abstract boolean waitForWifiEnabled ()

Aguarde até que isWifiEnabled() seja verdadeiro com um tempo limite padrão.

Retorna
`boolean`	`true` se o Wi-Fi foi ativado antes do tempo limite. Caso contrário, `false`.

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForWifiState

public abstract boolean waitForWifiState (WifiState... expectedStates)

Aguarde até que um dos estados de Wi-Fi esperados ocorra.

Parâmetros
`expectedStates`	`WifiState`: um ou mais estados de Wi-Fi esperados

Retorna
`boolean`	`true` se um dos estados esperados ocorreu. `false` se nenhum dos estados ocorreu antes do tempo limite ser atingido

Gera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`