IWifiHelper

public interface IWifiHelper

com.android.tradefed.device.IWifiHelper


Interface d'assistance pour manipuler les services Wi-Fi sur l'appareil.

Résumé

Méthodes publiques

abstract boolean addOpenNetwork(String ssid)

Ajoute le réseau de sécurité ouvert identifié par ssid.

abstract boolean addOpenNetwork(String ssid, boolean scanSsid)

Ajoute le réseau de sécurité ouvert identifié par ssid.

abstract boolean addWpaPskNetwork(String ssid, String psk)

Ajoute le réseau sécurisé WPA-PSK identifié par le ssid.

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

Ajoute le réseau sécurisé WPA-PSK identifié par le ssid.

abstract boolean checkConnectivity(String urlToCheck)

Vérifie la connectivité en envoyant une requête HTTP à l'URL indiquée.

abstract void cleanUp()

Nettoyez les ressources et l'installation du package de l'assistant Wi-Fi.

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

Se connecter à un réseau Wi-Fi et vérifier la connectivité

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

Se connecter à un réseau Wi-Fi et vérifier la connectivité

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

Se connecter à un réseau Wi-Fi et vérifier la connectivité

abstract boolean disableWifi()

Désactive l'état du Wi-Fi sur l'appareil.

abstract boolean disconnectFromNetwork()

Déconnecte-toi du réseau Wi-Fi actuel et désactive le Wi-Fi.

abstract boolean enableWifi()

Active l'état du Wi-Fi sur l'appareil.

abstract String getBSSID()

Récupère l'identifiant de l'ensemble de services de base (BSSID) du point d'accès actuel.

abstract String getIpAddress()

Obtient l'adresse IP associée à l'interface Wi-Fi.

abstract String getSSID()

Récupère l'identifiant du jeu de services du réseau actuellement connecté.

abstract Map<String, String> getWifiInfo()

Obtient les informations actuelles sur la connexion Wi-Fi.

abstract boolean hasValidIp()
abstract boolean isWifiEnabled()

Vérifiez si le Wi-Fi est actuellement activé.

abstract boolean removeAllNetworks()

Supprime tous les réseaux connus.

abstract boolean startMonitor(long interval, String urlToCheck)

Démarre la surveillance de la connectivité réseau.

abstract List<Long> stopMonitor()

Arrête la surveillance de la connectivité réseau.

abstract boolean waitForIp(long timeout)

Attendez qu'une adresse IP soit attribuée à l'adaptateur Wi-Fi.

abstract boolean waitForWifiDisabled(long timeout)

Attendez que isWifiEnabled() soit défini sur "false".

abstract boolean waitForWifiDisabled()

Attendez que isWifiEnabled() soit défini sur "false" avec un délai avant expiration par défaut.

abstract boolean waitForWifiEnabled(long timeout)

Attendez que isWifiEnabled() soit défini sur "true".

abstract boolean waitForWifiEnabled()

Attendez que isWifiEnabled() soit défini sur "true" avec un délai d'attente par défaut.

abstract boolean waitForWifiState(WifiState... expectedStates)

Attend qu'un des états Wi-Fi attendus se produise.

Méthodes publiques

addOpenNetwork

public abstract boolean addOpenNetwork (String ssid)

Ajoute le réseau de sécurité ouvert identifié par ssid.

Pour se connecter à un réseau Wi-Fi, un profil réseau doit d'abord être créé dans la configuration wpa_supplicant. Cela appellera wpa_cli pour ajouter le réseau de sécurité ouvert identifié par ssid.

Paramètres
ssid String : SSID du réseau à ajouter.

Renvoie
boolean true si le réseau a été ajouté, false dans le cas contraire.

Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

addOpenNetwork

public abstract boolean addOpenNetwork (String ssid, 
                boolean scanSsid)

Ajoute le réseau de sécurité ouvert identifié par ssid.

Pour se connecter à un réseau Wi-Fi, un profil réseau doit d'abord être créé dans la configuration wpa_supplicant. Cela appellera wpa_cli pour ajouter le réseau de sécurité ouvert identifié par ssid.

Paramètres
ssid String : SSID du réseau à ajouter.

scanSsid boolean : indique s'il faut rechercher le SSID masqué de ce réseau.

Renvoie
boolean true si le réseau a été ajouté, false dans le cas contraire.

Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

addWpaPskNetwork

public abstract boolean addWpaPskNetwork (String ssid, 
                String psk)

Ajoute le réseau sécurisé WPA-PSK identifié par le ssid.

Paramètres
ssid String : SSID du réseau à ajouter.

psk String : phrase secrète WPA-PSK à utiliser

Renvoie
boolean true si le réseau a été ajouté, false dans le cas contraire.

Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

addWpaPskNetwork

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

Ajoute le réseau sécurisé WPA-PSK identifié par le ssid.

Paramètres
ssid String : SSID du réseau à ajouter.

psk String : phrase secrète WPA-PSK à utiliser

scanSsid boolean : indique s'il faut rechercher le SSID masqué de ce réseau.

Renvoie
boolean true si le réseau a été ajouté, false dans le cas contraire.

Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

checkConnectivity

public abstract boolean checkConnectivity (String urlToCheck)

Vérifie la connectivité en envoyant une requête HTTP à l'URL indiquée.

Paramètres
urlToCheck String : URL de destination pour une vérification de requête HTTP

Renvoie
boolean true si l'appareil réussit le test de connectivité.

Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

cleanUp

public abstract void cleanUp ()

Nettoyez les ressources et l'installation du package de l'assistant Wi-Fi. Cette méthode ne doit être appelée que lorsque le Wi-Fi n'est plus nécessaire pour l'invocation, car l'appareil perdrait la connexion Wi-Fi lorsque l'assistant est désinstallé.

Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToNetwork

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

Se connecter à un réseau Wi-Fi et vérifier la connectivité

Paramètres
ssid String : SSID du réseau auquel se connecter

psk String : phrase secrète WPA-PSK à utiliser. Cette valeur peut être nulle.

urlToCheck String : URL de destination pour une vérification de requête HTTP

Renvoie
boolean true si l'appareil réussit le test de connectivité.

Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToNetwork

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

Se connecter à un réseau Wi-Fi et vérifier la connectivité

Paramètres
ssid String : SSID du réseau auquel se connecter

psk String : phrase secrète WPA-PSK à utiliser. Cette valeur peut être nulle.

urlToCheck String : URL de destination pour une vérification de requête HTTP

scanSsid boolean : indique si le SSID masqué doit être recherché pour ce réseau.

defaultType String : type de réseau par défaut auquel revenir si le type de réseau du SSID n'est pas déterminé.

Renvoie
IWifiHelper.WifiConnectionResult WifiConnectionResult représentant le résultat de la connexion Wi-Fi

Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToNetwork

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

Se connecter à un réseau Wi-Fi et vérifier la connectivité

Paramètres
ssid String : SSID du réseau auquel se connecter

psk String : phrase secrète WPA-PSK à utiliser. Cette valeur peut être nulle.

urlToCheck String : URL de destination pour une vérification de requête HTTP

scanSsid boolean : indique si le SSID masqué doit être recherché pour ce réseau.

Renvoie
IWifiHelper.WifiConnectionResult WifiConnectionResult représentant le résultat de la connexion Wi-Fi

Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

disableWifi

public abstract boolean disableWifi ()

Désactive l'état du Wi-Fi sur l'appareil.

Renvoie
boolean true si le Wi-Fi a été désactivé

Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

disconnectFromNetwork

public abstract boolean disconnectFromNetwork ()

Déconnecte-toi du réseau Wi-Fi actuel et désactive le Wi-Fi.

Renvoie
boolean true si l'opération a réussi.

Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

enableWifi

public abstract boolean enableWifi ()

Active l'état du Wi-Fi sur l'appareil.

Renvoie
boolean true si le Wi-Fi a été activé

Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBSSID

public abstract String getBSSID ()

Récupère l'identifiant de l'ensemble de services de base (BSSID) du point d'accès actuel.

Renvoie
String

Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIpAddress

public abstract String getIpAddress ()

Obtient l'adresse IP associée à l'interface Wi-Fi. Renvoie null en cas d'échec de la récupération de l'adresse IP.

Renvoie
String

Génère
DeviceNotAvailableException

getSSID

public abstract String getSSID ()

Récupère l'identifiant du jeu de services du réseau actuellement connecté.

Renvoie
String

Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getWifiInfo

public abstract Map<String, String> getWifiInfo ()

Obtient les informations actuelles sur la connexion Wi-Fi.

Cela inclut le SSID, le BSSID, l'adresse IP, la vitesse de connexion et le RSSI.

Renvoie
Map<String, String> une carte contenant des informations sur la connexion Wi-Fi.

Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

hasValidIp

public abstract boolean hasValidIp ()

Renvoie
boolean true si l'appareil possède une adresse IP valide

Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

Vérifiez si le Wi-Fi est actuellement activé.

Renvoie
boolean

Génère
DeviceNotAvailableException

removeAllNetworks

public abstract boolean removeAllNetworks ()

Supprime tous les réseaux connus.

Renvoie
boolean

Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startMonitor

public abstract boolean startMonitor (long interval, 
                String urlToCheck)

Démarre la surveillance de la connectivité réseau.

Paramètres
interval long : intervalle entre les vérifications de la connectivité.

urlToCheck String : URL permettant de vérifier la connectivité.

Renvoie
boolean true si l'opération a réussi.

Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

stopMonitor

public abstract List<Long> stopMonitor ()

Arrête la surveillance de la connectivité réseau.

Cela renvoie également l'historique de latence depuis le dernier appel IWifiHelper.startMonitor(long,String).

Renvoie
List<Long> l'historique de latence.

Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

waitForIp

public abstract boolean waitForIp (long timeout)

Attendez qu'une adresse IP soit attribuée à l'adaptateur Wi-Fi.

Paramètres
timeout long : durée d'attente

Renvoie
boolean true si une adresse IP est attribuée avant le délai d'expiration, false sinon.

Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

waitForWifiDisabled

public abstract boolean waitForWifiDisabled (long timeout)

Attendez que isWifiEnabled() soit défini sur "false".

Paramètres
timeout long : temps d'attente en ms

Renvoie
boolean true si le Wi-Fi a été désactivé avant le délai d'inactivité, false dans le cas contraire.

Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

waitForWifiDisabled

public abstract boolean waitForWifiDisabled ()

Attendez que isWifiEnabled() soit défini sur "false" avec un délai avant expiration par défaut.

Renvoie
boolean true si le Wi-Fi a été désactivé avant le délai d'inactivité, false dans le cas contraire.

Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

waitForWifiEnabled

public abstract boolean waitForWifiEnabled (long timeout)

Attendez que isWifiEnabled() soit défini sur "true".

Paramètres
timeout long : temps d'attente en ms

Renvoie
boolean true si le Wi-Fi était activé avant le délai d'inactivité, false dans le cas contraire.

Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

waitForWifiEnabled

public abstract boolean waitForWifiEnabled ()

Attendez que isWifiEnabled() soit défini sur "true" avec un délai d'attente par défaut.

Renvoie
boolean true si le Wi-Fi était activé avant le délai d'inactivité, false dans le cas contraire.

Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

waitForWifiState

public abstract boolean waitForWifiState (WifiState... expectedStates)

Attend qu'un des états Wi-Fi attendus se produise.

Paramètres
expectedStates WifiState : un ou plusieurs états Wi-Fi attendus

Renvoie
boolean true si l'un des états attendus s'est produit. false si aucun des états ne s'est produit avant l'expiration du délai

Génère
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException