IWifiHelper

public interface IWifiHelper

com.android.tradefed.device.IWifiHelper


Hilfsschnittstelle zum Bearbeiten von WLAN-Diensten auf dem Gerät.

Zusammenfassung

Öffentliche Methoden

abstract boolean addOpenNetwork(String ssid)

Fügt das offene Sicherheitsnetzwerk hinzu, das durch „ssid“ identifiziert wird.

abstract boolean addOpenNetwork(String ssid, boolean scanSsid)

Fügt das offene Sicherheitsnetzwerk hinzu, das durch „ssid“ identifiziert wird.

abstract boolean addWpaPskNetwork(String ssid, String psk)

Fügt das durch „ssid“ identifizierte WPA-PSK-Sicherheitsnetzwerk hinzu.

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

Fügt das durch „ssid“ identifizierte WPA-PSK-Sicherheitsnetzwerk hinzu.

abstract boolean checkConnectivity(String urlToCheck)

Prüft die Verbindung, indem eine HTTP-Anfrage an die angegebene URL gesendet wird.

abstract void cleanUp()

Bereinigen Sie die Ressourcen und die Installation des WLAN-Helfer-Pakets.

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

Stellt eine Verbindung zu einem WLAN her und prüft die Verbindung.

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

Stellt eine Verbindung zu einem WLAN her und prüft die Verbindung.

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

Stellt eine Verbindung zu einem WLAN her und prüft die Verbindung.

abstract boolean disableWifi()

Deaktiviert den WLAN-Status auf dem Gerät.

abstract boolean disconnectFromNetwork()

Trennen Sie die Verbindung zum aktuellen WLAN und deaktivieren Sie WLAN.

abstract boolean enableWifi()

Aktiviert den WLAN-Status auf dem Gerät.

abstract String getBSSID()

Ruft die BSSID (Basic Service Set Identifier) des aktuellen Zugangspunkts ab.

abstract String getIpAddress()

Ruft die IP-Adresse ab, die mit der WLAN-Schnittstelle verknüpft ist.

abstract String getSSID()

Ruft den Service Set Identifier des aktuell verbundenen Netzwerks ab.

abstract Map<String, String> getWifiInfo()

Ruft die aktuellen WLAN-Verbindungsinformationen ab.

abstract boolean hasValidIp()
abstract boolean isWifiEnabled()

Prüfe, ob WLAN derzeit aktiviert ist.

abstract boolean removeAllNetworks()

Entfernt alle bekannten Netzwerke.

abstract boolean startMonitor(long interval, String urlToCheck)

Startet die Überwachung der Netzwerkverbindung.

abstract List<Long> stopMonitor()

Beendet die Überwachung der Netzwerkverbindung.

abstract boolean waitForIp(long timeout)

Warten Sie, bis dem WLAN-Adapter eine IP-Adresse zugewiesen wurde.

abstract boolean waitForWifiDisabled(long timeout)

Warten Sie, bis isWifiEnabled() „false“ ist.

abstract boolean waitForWifiDisabled()

Warten Sie, bis isWifiEnabled() mit einem Standard-Timeout „false“ ist.

abstract boolean waitForWifiEnabled(long timeout)

Warten Sie, bis isWifiEnabled() „true“ ist.

abstract boolean waitForWifiEnabled()

Wartet mit einem Standard-Timeout, bis isWifiEnabled() „true“ ist.

abstract boolean waitForWifiState(WifiState... expectedStates)

Wartet, bis einer der erwarteten WLAN-Status eintritt.

Öffentliche Methoden

addOpenNetwork

public abstract boolean addOpenNetwork (String ssid)

Fügt das offene Sicherheitsnetzwerk hinzu, das durch „ssid“ identifiziert wird.

Um eine Verbindung zu einem WLAN herzustellen, muss zuerst ein Netzwerkprofil in der wpa_supplicant-Konfiguration erstellt werden. Dadurch wird „wpa_cli“ aufgerufen, um das offene Sicherheitsnetzwerk hinzuzufügen, das durch „ssid“ identifiziert wird.

Parameter
ssid String: Die SSID des hinzuzufügenden Netzwerks.

Gibt Folgendes zurück:
boolean true, wenn das Netzwerk hinzugefügt wurde, andernfalls false.

Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

addOpenNetwork

public abstract boolean addOpenNetwork (String ssid, 
                boolean scanSsid)

Fügt das offene Sicherheitsnetzwerk hinzu, das durch „ssid“ identifiziert wird.

Um eine Verbindung zu einem WLAN herzustellen, muss zuerst ein Netzwerkprofil in der wpa_supplicant-Konfiguration erstellt werden. Dadurch wird „wpa_cli“ aufgerufen, um das offene Sicherheitsnetzwerk hinzuzufügen, das durch „ssid“ identifiziert wird.

Parameter
ssid String: Die SSID des hinzuzufügenden Netzwerks.

scanSsid boolean: Gibt an, ob für dieses Netzwerk nach verborgenen SSIDs gesucht werden soll.

Gibt Folgendes zurück:
boolean true, wenn das Netzwerk hinzugefügt wurde, andernfalls false.

Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

addWpaPskNetwork

public abstract boolean addWpaPskNetwork (String ssid, 
                String psk)

Fügt das durch „ssid“ identifizierte WPA-PSK-Sicherheitsnetzwerk hinzu.

Parameter
ssid String: Die SSID des hinzuzufügenden Netzwerks.

psk String: die zu verwendende WPA-PSK-Passphrase

Gibt Folgendes zurück:
boolean true, wenn das Netzwerk hinzugefügt wurde, andernfalls false.

Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

addWpaPskNetwork

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

Fügt das durch „ssid“ identifizierte WPA-PSK-Sicherheitsnetzwerk hinzu.

Parameter
ssid String: Die SSID des hinzuzufügenden Netzwerks.

psk String: die zu verwendende WPA-PSK-Passphrase

scanSsid boolean: Gibt an, ob für dieses Netzwerk nach verborgenen SSIDs gesucht werden soll.

Gibt Folgendes zurück:
boolean true, wenn das Netzwerk hinzugefügt wurde, andernfalls false.

Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

checkConnectivity

public abstract boolean checkConnectivity (String urlToCheck)

Prüft die Verbindung, indem eine HTTP-Anfrage an die angegebene URL gesendet wird.

Parameter
urlToCheck String: Eine Ziel-URL für eine HTTP-Anfrageprüfung

Gibt Folgendes zurück:
boolean true, wenn das Gerät den Konnektivitätstest besteht.

Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

cleanUp

public abstract void cleanUp ()

Bereinigen Sie die Ressourcen und die Installation des WLAN-Helfer-Pakets. Diese Methode sollte nur aufgerufen werden, wenn WLAN für den Aufruf nicht mehr benötigt wird, da das Gerät die WLAN-Verbindung verliert, wenn der Helfer deinstalliert wird.

Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToNetwork

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

Stellt eine Verbindung zu einem WLAN her und prüft die Verbindung.

Parameter
ssid String: Die SSID des Netzwerks, mit dem eine Verbindung hergestellt werden soll.

psk String: die zu verwendende WPA-PSK-Passphrase. Kann null sein.

urlToCheck String: Eine Ziel-URL für eine HTTP-Anfrageprüfung

Gibt Folgendes zurück:
boolean true, wenn das Gerät den Konnektivitätstest besteht.

Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToNetwork

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

Stellt eine Verbindung zu einem WLAN her und prüft die Verbindung.

Parameter
ssid String: Die SSID des Netzwerks, mit dem eine Verbindung hergestellt werden soll.

psk String: die zu verwendende WPA-PSK-Passphrase. Kann null sein.

urlToCheck String: Eine Ziel-URL für eine HTTP-Anfrageprüfung

scanSsid boolean: Gibt an, ob für dieses Netzwerk nach einer verborgenen SSID gesucht werden soll.

defaultType String: Standardnetzwerktyp, auf den zurückgegriffen werden soll, wenn der Netzwerktyp der SSID nicht ermittelt werden kann

Gibt Folgendes zurück:
IWifiHelper.WifiConnectionResult WifiConnectionResult, das das WLAN-Verbindungsergebnis darstellt

Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToNetwork

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

Stellt eine Verbindung zu einem WLAN her und prüft die Verbindung.

Parameter
ssid String: Die SSID des Netzwerks, mit dem eine Verbindung hergestellt werden soll.

psk String: die zu verwendende WPA-PSK-Passphrase. Kann null sein.

urlToCheck String: Eine Ziel-URL für eine HTTP-Anfrageprüfung

scanSsid boolean: Gibt an, ob für dieses Netzwerk nach einer verborgenen SSID gesucht werden soll.

Gibt Folgendes zurück:
IWifiHelper.WifiConnectionResult WifiConnectionResult, das das WLAN-Verbindungsergebnis darstellt

Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

disableWifi

public abstract boolean disableWifi ()

Deaktiviert den WLAN-Status auf dem Gerät.

Gibt Folgendes zurück:
boolean true, wenn WLAN deaktiviert wurde

Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

disconnectFromNetwork

public abstract boolean disconnectFromNetwork ()

Trennen Sie die Verbindung zum aktuellen WLAN und deaktivieren Sie WLAN.

Gibt Folgendes zurück:
boolean true, wenn der Vorgang erfolgreich war.

Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

enableWifi

public abstract boolean enableWifi ()

Aktiviert den WLAN-Status auf dem Gerät.

Gibt Folgendes zurück:
boolean true, wenn WLAN aktiviert wurde

Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBSSID

public abstract String getBSSID ()

Ruft die BSSID (Basic Service Set Identifier) des aktuellen Zugangspunkts ab.

Gibt Folgendes zurück:
String

Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIpAddress

public abstract String getIpAddress ()

Ruft die IP-Adresse ab, die mit der WLAN-Schnittstelle verknüpft ist. Gibt null zurück, wenn beim Abrufen der IP-Adresse ein Fehler aufgetreten ist.

Gibt Folgendes zurück:
String

Löst aus
DeviceNotAvailableException

getSSID

public abstract String getSSID ()

Ruft den Service Set Identifier des aktuell verbundenen Netzwerks ab.

Gibt Folgendes zurück:
String

Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getWifiInfo

public abstract Map<String, String> getWifiInfo ()

Ruft die aktuellen WLAN-Verbindungsinformationen ab.

Dazu gehören SSID, BSSID, IP-Adresse, Verbindungsgeschwindigkeit und RSSI.

Gibt Folgendes zurück:
Map<String, String> Eine Karte mit Informationen zur WLAN-Verbindung.

Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

hasValidIp

public abstract boolean hasValidIp ()

Gibt Folgendes zurück:
boolean true, wenn das Gerät eine gültige IP-Adresse hat

Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

Prüfe, ob WLAN derzeit aktiviert ist.

Gibt Folgendes zurück:
boolean

Löst aus
DeviceNotAvailableException

removeAllNetworks

public abstract boolean removeAllNetworks ()

Entfernt alle bekannten Netzwerke.

Gibt Folgendes zurück:
boolean

Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startMonitor

public abstract boolean startMonitor (long interval, 
                String urlToCheck)

Startet die Überwachung der Netzwerkverbindung.

Parameter
interval long: Intervall zwischen Konnektivitätsprüfungen.

urlToCheck String: Eine URL, mit der die Verbindung geprüft werden soll.

Gibt Folgendes zurück:
boolean true, wenn der Vorgang erfolgreich war.

Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

stopMonitor

public abstract List<Long> stopMonitor ()

Beendet die Überwachung der Netzwerkverbindung.

Außerdem wird der Latenzverlauf seit dem letzten IWifiHelper.startMonitor(long,String)-Aufruf zurückgegeben.

Gibt Folgendes zurück:
List<Long> den Latenzverlauf.

Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

waitForIp

public abstract boolean waitForIp (long timeout)

Warten Sie, bis dem WLAN-Adapter eine IP-Adresse zugewiesen wurde.

Parameter
timeout long: Wartezeit

Gibt Folgendes zurück:
boolean true, wenn eine IP-Adresse vor dem Zeitlimit zugewiesen wird, andernfalls false

Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

waitForWifiDisabled

public abstract boolean waitForWifiDisabled (long timeout)

Warten Sie, bis isWifiEnabled() „false“ ist.

Parameter
timeout long: Zeit in Millisekunden, die gewartet werden soll

Gibt Folgendes zurück:
boolean true, wenn WLAN vor dem Zeitlimit deaktiviert wurde, andernfalls false.

Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

waitForWifiDisabled

public abstract boolean waitForWifiDisabled ()

Warten Sie, bis isWifiEnabled() mit einem Standard-Timeout „false“ ist.

Gibt Folgendes zurück:
boolean true, wenn WLAN vor dem Zeitlimit deaktiviert wurde, andernfalls false.

Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

waitForWifiEnabled

public abstract boolean waitForWifiEnabled (long timeout)

Warten Sie, bis isWifiEnabled() „true“ ist.

Parameter
timeout long: Zeit in Millisekunden, die gewartet werden soll

Gibt Folgendes zurück:
boolean true, wenn WLAN vor dem Zeitlimit aktiviert wurde, andernfalls false.

Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

waitForWifiEnabled

public abstract boolean waitForWifiEnabled ()

Wartet mit einem Standard-Timeout, bis isWifiEnabled() „true“ ist.

Gibt Folgendes zurück:
boolean true, wenn WLAN vor dem Zeitlimit aktiviert wurde, andernfalls false.

Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

waitForWifiState

public abstract boolean waitForWifiState (WifiState... expectedStates)

Wartet, bis einer der erwarteten WLAN-Status eintritt.

Parameter
expectedStates WifiState: ein oder mehrere zu erwartende WLAN-Status

Gibt Folgendes zurück:
boolean true, wenn einer der erwarteten Zustände eingetreten ist. false, wenn keiner der Zustände vor dem Erreichen des Zeitlimits eingetreten ist

Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException