A partire dal 2026, per allinearci al nostro modello di sviluppo trunk stabile e garantire la stabilità della piattaforma per l'ecosistema, pubblicheremo il codice sorgente su AOSP nel secondo e nel quarto trimestre. Per compilare e contribuire ad AOSP, utilizza android-latest-release. Il branch del manifest android-latest-release farà sempre riferimento alla release più recente pubblicata su AOSP. Per saperne di più, consulta la sezione Modifiche ad AOSP.

Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

IWifiHelper

public interface IWifiHelper

com.android.tradefed.device.IWifiHelper

Sottoclassi indirette note

WifiHelper

WifiHelper Classe helper per la manipolazione dei servizi Wi-Fi sul dispositivo.

Interfaccia helper per la manipolazione dei servizi Wi-Fi sul dispositivo.

Riepilogo

Metodi pubblici
`abstract boolean`	`addOpenNetwork(String ssid)` Aggiunge la rete di sicurezza aperta identificata da ssid.
`abstract boolean`	`addOpenNetwork(String ssid, boolean scanSsid)` Aggiunge la rete di sicurezza aperta identificata da ssid.
`abstract boolean`	`addWpaPskNetwork(String ssid, String psk)` Aggiunge la rete di sicurezza WPA-PSK identificata da ssid.
`abstract boolean`	`addWpaPskNetwork(String ssid, String psk, boolean scanSsid)` Aggiunge la rete di sicurezza WPA-PSK identificata da ssid.
`abstract boolean`	`checkConnectivity(String urlToCheck)` Controlla la connettività inviando una richiesta HTTP all'URL specificato.
`abstract void`	`cleanUp()` Libera spazio dalle risorse e dall'installazione del pacchetto helper Wi-Fi.
`abstract boolean`	`connectToNetwork(String ssid, String psk, String urlToCheck)` Si connette a una rete Wi-Fi e verifica la connettività.
`abstract IWifiHelper.WifiConnectionResult`	`connectToNetwork(String ssid, String psk, String urlToCheck, boolean scanSsid, String defaultType)` Si connette a una rete Wi-Fi e verifica la connettività.
`abstract IWifiHelper.WifiConnectionResult`	`connectToNetwork(String ssid, String psk, String urlToCheck, boolean scanSsid)` Si connette a una rete Wi-Fi e verifica la connettività.
`abstract boolean`	`disableWifi()` Disattiva lo stato del Wi-Fi sul dispositivo.
`abstract boolean`	`disconnectFromNetwork()` Disconnettiti dalla rete Wi-Fi corrente e disattiva il Wi-Fi.
`abstract boolean`	`enableWifi()` Attiva lo stato del Wi-Fi sul dispositivo.
`abstract String`	`getBSSID()` Recupera il Basic Service Set Identifier (BSSID) del punto di accesso attuale.
`abstract String`	`getIpAddress()` Ottiene l'indirizzo IP associato all'interfaccia Wi-Fi.
`abstract String`	`getSSID()` Recupera il Service Set Identifier della rete attualmente connessa.
`abstract Map<String, String>`	`getWifiInfo()` Recupera le informazioni sulla connessione Wi-Fi attuale.
`abstract boolean`	`hasValidIp()`
`abstract boolean`	`isWifiEnabled()` Controlla se il Wi-Fi è attualmente attivo.
`abstract boolean`	`removeAllNetworks()` Rimuove tutte le reti conosciute.
`abstract boolean`	`startMonitor(long interval, String urlToCheck)` Avvia il monitoraggio della connettività di rete.
`abstract List<Long>`	`stopMonitor()` Interrompe il monitoraggio della connettività di rete.
`abstract boolean`	`waitForIp(long timeout)` Attendi che venga assegnato un indirizzo IP alla scheda Wi-Fi.
`abstract boolean`	`waitForWifiDisabled(long timeout)` Attendi che `isWifiEnabled()` sia false.
`abstract boolean`	`waitForWifiDisabled()` Attendi che `isWifiEnabled()` sia false con un timeout predefinito.
`abstract boolean`	`waitForWifiEnabled(long timeout)` Attendi che `isWifiEnabled()` sia true.
`abstract boolean`	`waitForWifiEnabled()` Attendi che `isWifiEnabled()` sia true con un timeout predefinito.
`abstract boolean`	`waitForWifiState(WifiState... expectedStates)` Attende che si verifichi uno degli stati Wi-Fi previsti.

Metodi pubblici

addOpenNetwork

public abstract boolean addOpenNetwork (String ssid)

Aggiunge la rete di sicurezza aperta identificata da ssid.

Per connettersi a qualsiasi rete Wi-Fi, è necessario prima creare un profilo di rete nella configurazione di wpa_supplicant. Verrà chiamato wpa_cli per aggiungere la rete con sicurezza aperta identificata da ssid.

Parametri
`ssid`	`String`: l'SSID della rete da aggiungere.

Resi
`boolean`	`true` se la rete è stata aggiunta, `false` in caso contrario.

Genera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

addOpenNetwork

public abstract boolean addOpenNetwork (String ssid, 
                boolean scanSsid)

Aggiunge la rete di sicurezza aperta identificata da ssid.

Parametri
`ssid`	`String`: l'SSID della rete da aggiungere.
`scanSsid`	`boolean`: indica se eseguire la scansione dell'SSID nascosto per questa rete.

Resi
`boolean`	`true` se la rete è stata aggiunta, `false` in caso contrario.

Genera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

addWpaPskNetwork

public abstract boolean addWpaPskNetwork (String ssid, 
                String psk)

Aggiunge la rete di sicurezza WPA-PSK identificata da ssid.

Parametri
`ssid`	`String`: l'SSID della rete da aggiungere.
`psk`	`String`: la passphrase WPA-PSK da utilizzare

Resi
`boolean`	`true` se la rete è stata aggiunta, `false` in caso contrario.

Genera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

addWpaPskNetwork

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

Aggiunge la rete di sicurezza WPA-PSK identificata da ssid.

Parametri
`ssid`	`String`: l'SSID della rete da aggiungere.
`psk`	`String`: la passphrase WPA-PSK da utilizzare
`scanSsid`	`boolean`: indica se eseguire la scansione dell'SSID nascosto per questa rete.

Resi
`boolean`	`true` se la rete è stata aggiunta, `false` in caso contrario.

Genera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

checkConnectivity

public abstract boolean checkConnectivity (String urlToCheck)

Controlla la connettività inviando una richiesta HTTP all'URL specificato.

Parametri
`urlToCheck`	`String`: un URL di destinazione per un controllo della richiesta HTTP

Resi
`boolean`	`true` se il dispositivo supera il controllo della connettività.

Genera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

cleanUp

public abstract void cleanUp ()

Libera spazio dalle risorse e dall'installazione del pacchetto helper Wi-Fi. Questo metodo deve essere chiamato solo quando il Wi-Fi non è più necessario per la chiamata, poiché il dispositivo perderebbe la connessione Wi-Fi quando l'helper viene disinstallato.

Genera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

connectToNetwork

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

Si connette a una rete Wi-Fi e verifica la connettività.

Parametri
`ssid`	`String`: l'SSID della rete a cui connettersi
`psk`	`String`: la passphrase WPA-PSK da utilizzare. Questo campo può essere nullo.
`urlToCheck`	`String`: un URL di destinazione per un controllo della richiesta HTTP

Resi
`boolean`	`true` se il dispositivo supera il controllo della connettività.

Genera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

connectToNetwork

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

Si connette a una rete Wi-Fi e verifica la connettività.

Parametri
`ssid`	`String`: l'SSID della rete a cui connettersi
`psk`	`String`: la passphrase WPA-PSK da utilizzare. Questo campo può essere nullo.
`urlToCheck`	`String`: un URL di destinazione per un controllo della richiesta HTTP
`scanSsid`	`boolean`: indica se eseguire la scansione dell'SSID nascosto per questa rete
`defaultType`	`String`: Tipo di rete predefinito a cui eseguire il fallback se il tipo di rete dell'SSID non è determinato

Resi
`IWifiHelper.WifiConnectionResult`	WifiConnectionResult che rappresenta il risultato della connessione Wi-Fi

Genera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

connectToNetwork

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

Si connette a una rete Wi-Fi e verifica la connettività.

Parametri
`ssid`	`String`: l'SSID della rete a cui connettersi
`psk`	`String`: la passphrase WPA-PSK da utilizzare. Questo campo può essere nullo.
`urlToCheck`	`String`: un URL di destinazione per un controllo della richiesta HTTP
`scanSsid`	`boolean`: indica se eseguire la scansione dell'SSID nascosto per questa rete

Resi
`IWifiHelper.WifiConnectionResult`	WifiConnectionResult che rappresenta il risultato della connessione Wi-Fi

Genera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

disableWifi

public abstract boolean disableWifi ()

Disattiva lo stato del Wi-Fi sul dispositivo.

Resi
`boolean`	`true` se il Wi-Fi è stato disattivato

Genera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

disconnectFromNetwork

public abstract boolean disconnectFromNetwork ()

Disconnettiti dalla rete Wi-Fi corrente e disattiva il Wi-Fi.

Resi
`boolean`	`true` se l'operazione è riuscita.

Genera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

enableWifi

public abstract boolean enableWifi ()

Attiva lo stato del Wi-Fi sul dispositivo.

Resi
`boolean`	`true` se il Wi-Fi è stato attivato correttamente

Genera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBSSID

public abstract String getBSSID ()

Recupera il Basic Service Set Identifier (BSSID) del punto di accesso attuale.

Resi
`String`

Genera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

Vedi anche:

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

getIpAddress

public abstract String getIpAddress ()

Ottiene l'indirizzo IP associato all'interfaccia Wi-Fi. Restituisce null se si è verificato un errore durante il recupero dell'indirizzo IP.

Resi
`String`

Genera
`DeviceNotAvailableException`

getSSID

public abstract String getSSID ()

Recupera il Service Set Identifier della rete attualmente connessa.

Resi
`String`

Genera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

Vedi anche:

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

getWifiInfo

public abstract Map<String, String> getWifiInfo ()

Recupera le informazioni sulla connessione Wi-Fi attuale.

Sono inclusi SSID, BSSID, indirizzo IP, velocità del collegamento e RSSI.

Resi
`Map<String, String>`	una mappa contenente informazioni sulla connessione Wi-Fi.

Genera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

hasValidIp

public abstract boolean hasValidIp ()

Resi
`boolean`	`true` se il dispositivo ha un indirizzo IP valido

Genera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isWifiEnabled

public abstract boolean isWifiEnabled ()

Controlla se il Wi-Fi è attualmente attivo.

Resi
`boolean`

Genera
`DeviceNotAvailableException`

removeAllNetworks

public abstract boolean removeAllNetworks ()

Rimuove tutte le reti conosciute.

Resi
`boolean`

Genera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

startMonitor

public abstract boolean startMonitor (long interval, 
                String urlToCheck)

Avvia il monitoraggio della connettività di rete.

Parametri
`interval`	`long`: intervallo tra i controlli di connettività.
`urlToCheck`	`String`: un URL per verificare la connettività.

Resi
`boolean`	`true` se l'operazione è riuscita.

Genera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

stopMonitor

public abstract List<Long> stopMonitor ()

Interrompe il monitoraggio della connettività di rete.

Restituisce anche la cronologia della latenza dall'ultima chiamata IWifiHelper.startMonitor(long,String).

Resi
`List<Long>`	la cronologia della latenza.

Genera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForIp

public abstract boolean waitForIp (long timeout)

Attendi che venga assegnato un indirizzo IP alla scheda Wi-Fi.

Parametri
`timeout`	`long`: tempo di attesa

Resi
`boolean`	`true` se viene assegnato un indirizzo IP prima del timeout, `false` altrimenti

Genera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForWifiDisabled

public abstract boolean waitForWifiDisabled (long timeout)

Attendi che isWifiEnabled() sia false.

Parametri
`timeout`	`long`: tempo di attesa in ms

Resi
`boolean`	`true` se il Wi-Fi è stato disattivato prima del timeout, `false` altrimenti.

Genera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForWifiDisabled

public abstract boolean waitForWifiDisabled ()

Attendi che isWifiEnabled() sia false con un timeout predefinito.

Resi
`boolean`	`true` se il Wi-Fi è stato disattivato prima del timeout, `false` altrimenti.

Genera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForWifiEnabled

public abstract boolean waitForWifiEnabled (long timeout)

Attendi che isWifiEnabled() sia true.

Parametri
`timeout`	`long`: tempo di attesa in ms

Resi
`boolean`	`true` se il Wi-Fi è stato attivato prima del timeout, `false` in caso contrario.

Genera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForWifiEnabled

public abstract boolean waitForWifiEnabled ()

Attendi che isWifiEnabled() sia true con un timeout predefinito.

Resi
`boolean`	`true` se il Wi-Fi è stato attivato prima del timeout, `false` in caso contrario.

Genera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForWifiState

public abstract boolean waitForWifiState (WifiState... expectedStates)

Attende che si verifichi uno degli stati Wi-Fi previsti.

Parametri
`expectedStates`	`WifiState`: uno o più stati del Wi-Fi da prevedere

Resi
`boolean`	`true` se si è verificato uno degli stati previsti. `false` se nessuno degli stati si è verificato prima del raggiungimento del timeout

Genera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`