IWifiHelper

public interface IWifiHelper

com.android.tradefed.device.IWifiHelper

ממשק עזר לשינוי שירותי Wi-Fi במכשיר.

סיכום

‫methods ציבוריים

abstract boolean addOpenNetwork(String ssid)

מוסיף את רשת האבטחה הפתוחה שזוהתה על ידי ssid.

abstract boolean addOpenNetwork(String ssid, boolean scanSsid)

מוסיף את רשת האבטחה הפתוחה שזוהתה על ידי ssid.

abstract boolean addWpaPskNetwork(String ssid, String psk)

מוסיף את רשת האבטחה WPA-PSK שזוהתה על ידי ssid.

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

מוסיף את רשת האבטחה WPA-PSK שזוהתה על ידי ssid.

abstract boolean checkConnectivity(String urlToCheck)

בודק את הקישוריות על ידי שליחת בקשת HTTP לכתובת ה-URL שצוינה.

abstract void cleanUp()

מנקים את המשאבים ואת ההתקנה של חבילת כלי העזר ל-Wi-Fi.

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

מתחבר לרשת Wi-Fi ובודק את החיבור.

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

מתחבר לרשת Wi-Fi ובודק את החיבור.

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

מתחבר לרשת Wi-Fi ובודק את החיבור.

abstract boolean disableWifi()

ההגדרה משביתה את מצב ה-Wi-Fi במכשיר.

abstract boolean disconnectFromNetwork()

מתנתקים מרשת ה-Wi-Fi הנוכחית ומשביתים את ה-Wi-Fi.

abstract boolean enableWifi()

ההגדרה מאפשרת את מצב ה-Wi-Fi במכשיר.

abstract String getBSSID()

מקבל את המזהה של מערך השירות הבסיסי (BSSID) של נקודת הגישה הנוכחית.

abstract String getIpAddress()

הפונקציה מחזירה את כתובת ה-IP שמשויכת לממשק ה-Wi-Fi.

abstract String getSSID()

מקבל את המזהה של מערך השירות של הרשת שמחוברת כרגע.

abstract Map<String, String> getWifiInfo()

קבלת פרטי החיבור הנוכחי ל-Wi-Fi.

abstract boolean hasValidIp()
abstract boolean isWifiEnabled()

בודקים אם ה-Wi-Fi מופעל.

abstract boolean removeAllNetworks()

הסרת כל הרשתות הידועות.

abstract boolean startMonitor(long interval, String urlToCheck)

מפעיל את המעקב אחרי החיבור לרשת.

abstract List<Long> stopMonitor()

מפסיק את המעקב אחרי החיבור לרשת.

abstract boolean waitForIp(long timeout)

מחכים עד שכתובת IP מוקצית למתאם ה-Wi-Fi.

abstract boolean waitForWifiDisabled(long timeout)

מחכים עד שהערך של isWifiEnabled() יהיה false.

abstract boolean waitForWifiDisabled()

המתנה עד שהערך של isWifiEnabled() יהיה False עם פסק זמן שמוגדר כברירת מחדל.

abstract boolean waitForWifiEnabled(long timeout)

מחכים עד ש-isWifiEnabled() יהיה true.

abstract boolean waitForWifiEnabled()

המתנה עד שהערך של isWifiEnabled() יהיה TRUE עם זמן קצוב לתפוגה שמוגדר כברירת מחדל.

abstract boolean waitForWifiState(WifiState... expectedStates)

הפונקציה ממתינה עד שאחד ממצבי ה-Wi-Fi הצפויים מתרחש.

‫methods ציבוריים

addOpenNetwork

public abstract boolean addOpenNetwork (String ssid)

מוסיף את רשת האבטחה הפתוחה שזוהתה על ידי ssid.

כדי להתחבר לרשת Wi-Fi, צריך קודם ליצור פרופיל רשת בהגדרות של wpa_supplicant. הפעולה הזו תפעיל את wpa_cli כדי להוסיף את רשת האבטחה הפתוחה שזוהתה על ידי ssid.

פרמטרים
ssid ‫String: ה-SSID של הרשת שרוצים להוסיף.
החזרות
boolean ‫true אם הרשת נוספה בהצלחה, אחרת false.
הקפצת הודעות שגיאה (throw)
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

addOpenNetwork

public abstract boolean addOpenNetwork (String ssid, 
                boolean scanSsid)

מוסיף את רשת האבטחה הפתוחה שזוהתה על ידי ssid.

כדי להתחבר לרשת Wi-Fi, צריך קודם ליצור פרופיל רשת בהגדרות של wpa_supplicant. הפעולה הזו תפעיל את wpa_cli כדי להוסיף את רשת האבטחה הפתוחה שזוהתה על ידי ssid.

פרמטרים
ssid ‫String: ה-SSID של הרשת שרוצים להוסיף.
scanSsid ‫boolean: האם לסרוק SSID מוסתר ברשת הזו.
החזרות
boolean ‫true אם הרשת נוספה בהצלחה, אחרת false.
הקפצת הודעות שגיאה (throw)
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

addWpaPskNetwork

public abstract boolean addWpaPskNetwork (String ssid, 
                String psk)

מוסיף את רשת האבטחה WPA-PSK שזוהתה על ידי ssid.

פרמטרים
ssid ‫String: ה-SSID של הרשת שרוצים להוסיף.
psk ‫String: סיסמת WPA-PSK לשימוש
החזרות
boolean ‫true אם הרשת נוספה בהצלחה, אחרת false.
הקפצת הודעות שגיאה (throw)
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

addWpaPskNetwork

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

מוסיף את רשת האבטחה WPA-PSK שזוהתה על ידי ssid.

פרמטרים
ssid ‫String: ה-SSID של הרשת שרוצים להוסיף.
psk ‫String: סיסמת WPA-PSK לשימוש
scanSsid ‫boolean: האם לסרוק SSID מוסתר ברשת הזו.
החזרות
boolean ‫true אם הרשת נוספה בהצלחה, אחרת false.
הקפצת הודעות שגיאה (throw)
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

checkConnectivity

public abstract boolean checkConnectivity (String urlToCheck)

בודק את הקישוריות על ידי שליחת בקשת HTTP לכתובת ה-URL שצוינה.

פרמטרים
urlToCheck ‫String: כתובת יעד לבדיקת בקשת HTTP
החזרות
boolean true אם המכשיר עובר את בדיקת החיבור.
הקפצת הודעות שגיאה (throw)
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

cleanUp

public abstract void cleanUp ()

מנקים את המשאבים ואת ההתקנה של חבילת כלי העזר ל-Wi-Fi. הפונקציה הזו צריכה להיקרא רק כשאין יותר צורך ב-Wi-Fi להפעלה, כי המכשיר יאבד את חיבור ה-Wi-Fi כשהעוזר יוסר.

הקפצת הודעות שגיאה (throw)
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToNetwork

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

מתחבר לרשת Wi-Fi ובודק את החיבור.

פרמטרים
ssid ‫String: ה-SSID של הרשת שאליה רוצים להתחבר
psk ‫String: סיסמת WPA-PSK לשימוש. הערך בשדה הזה יכול להיות null.
urlToCheck ‫String: כתובת יעד לבדיקת בקשת HTTP
החזרות
boolean true אם המכשיר עובר את בדיקת החיבור.
הקפצת הודעות שגיאה (throw)
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToNetwork

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

מתחבר לרשת Wi-Fi ובודק את החיבור.

פרמטרים
ssid ‫String: ה-SSID של הרשת שאליה רוצים להתחבר
psk ‫String: סיסמת WPA-PSK לשימוש. הערך בשדה הזה יכול להיות null.
urlToCheck ‫String: כתובת יעד לבדיקת בקשת HTTP
scanSsid ‫boolean: האם לסרוק SSID מוסתר ברשת הזו
defaultType ‫String: סוג הרשת שמוגדר כברירת מחדל שאליה המערכת תחזור אם לא ייקבע סוג הרשת של ה-SSID
החזרות
IWifiHelper.WifiConnectionResult ‫WifiConnectionResult שמייצג את תוצאת החיבור ל-Wi-Fi
הקפצת הודעות שגיאה (throw)
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToNetwork

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

מתחבר לרשת Wi-Fi ובודק את החיבור.

פרמטרים
ssid ‫String: ה-SSID של הרשת שאליה רוצים להתחבר
psk ‫String: סיסמת WPA-PSK לשימוש. הערך בשדה הזה יכול להיות null.
urlToCheck ‫String: כתובת יעד לבדיקת בקשת HTTP
scanSsid ‫boolean: האם לסרוק SSID מוסתר ברשת הזו
החזרות
IWifiHelper.WifiConnectionResult ‫WifiConnectionResult שמייצג את תוצאת החיבור ל-Wi-Fi
הקפצת הודעות שגיאה (throw)
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

disableWifi

public abstract boolean disableWifi ()

ההגדרה משביתה את מצב ה-Wi-Fi במכשיר.

החזרות
boolean ‫true אם ה-Wi-Fi הושבת בהצלחה
הקפצת הודעות שגיאה (throw)
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

disconnectFromNetwork

public abstract boolean disconnectFromNetwork ()

מתנתקים מרשת ה-Wi-Fi הנוכחית ומשביתים את ה-Wi-Fi.

החזרות
boolean ‫true אם הפעולה הצליחה.
הקפצת הודעות שגיאה (throw)
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

enableWifi

public abstract boolean enableWifi ()

ההגדרה מאפשרת את מצב ה-Wi-Fi במכשיר.

החזרות
boolean ‫true אם ה-Wi-Fi הופעל בהצלחה
הקפצת הודעות שגיאה (throw)
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBSSID

public abstract String getBSSID ()

מקבל את המזהה של מערך השירות הבסיסי (BSSID) של נקודת הגישה הנוכחית.

החזרות
String

הקפצת הודעות שגיאה (throw)
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIpAddress

public abstract String getIpAddress ()

הפונקציה מחזירה את כתובת ה-IP שמשויכת לממשק ה-Wi-Fi. הפונקציה מחזירה את הערך null אם אחזור כתובת ה-IP נכשל.

החזרות
String

הקפצת הודעות שגיאה (throw)
DeviceNotAvailableException

getSSID

public abstract String getSSID ()

מקבל את המזהה של מערך השירות של הרשת שמחוברת כרגע.

החזרות
String

הקפצת הודעות שגיאה (throw)
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getWifiInfo

public abstract Map<String, String> getWifiInfo ()

קבלת פרטי החיבור הנוכחי ל-Wi-Fi.

המידע הזה כולל את ה-SSID,‏ BSSID, כתובת ה-IP, מהירות הקישור ו-RSSI.

החזרות
Map<String, String> מפה שמכילה פרטי חיבור Wi-Fi.
הקפצת הודעות שגיאה (throw)
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

hasValidIp

public abstract boolean hasValidIp ()

החזרות
boolean ‫true אם למכשיר יש כתובת IP תקינה
הקפצת הודעות שגיאה (throw)
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

בודקים אם ה-Wi-Fi מופעל.

החזרות
boolean

הקפצת הודעות שגיאה (throw)
DeviceNotAvailableException

removeAllNetworks

public abstract boolean removeAllNetworks ()

הסרת כל הרשתות הידועות.

החזרות
boolean

הקפצת הודעות שגיאה (throw)
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startMonitor

public abstract boolean startMonitor (long interval, 
                String urlToCheck)

מפעיל את המעקב אחרי החיבור לרשת.

פרמטרים
interval ‫long: האינטרוול בין בדיקות הקישוריות.
urlToCheck ‫String: כתובת URL לבדיקת הקישוריות.
החזרות
boolean ‫true אם הפעולה הצליחה.
הקפצת הודעות שגיאה (throw)
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

stopMonitor

public abstract List<Long> stopMonitor ()

מפסיק את המעקב אחרי החיבור לרשת.

הפונקציה מחזירה גם את היסטוריית זמן האחזור מאז השיחה האחרונה IWifiHelper.startMonitor(long,String).

החזרות
List<Long> היסטוריית זמני האחזור.
הקפצת הודעות שגיאה (throw)
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

waitForIp

public abstract boolean waitForIp (long timeout)

מחכים עד שכתובת IP מוקצית למתאם ה-Wi-Fi.

פרמטרים
timeout ‫long: כמה זמן לחכות
החזרות
boolean ‫true אם כתובת ה-IP מוקצית לפני פסק הזמן, false אחרת
הקפצת הודעות שגיאה (throw)
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

waitForWifiDisabled

public abstract boolean waitForWifiDisabled (long timeout)

מחכים עד שהערך של isWifiEnabled() יהיה false.

פרמטרים
timeout ‫long: זמן ההמתנה במילישניות
החזרות
boolean ‫true אם ה-Wi-Fi הושבת לפני שהזמן הקצוב לתפוגה הסתיים, false אחרת.
הקפצת הודעות שגיאה (throw)
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

waitForWifiDisabled

public abstract boolean waitForWifiDisabled ()

המתנה עד שהערך של isWifiEnabled() יהיה False עם פסק זמן שמוגדר כברירת מחדל.

החזרות
boolean ‫true אם ה-Wi-Fi הושבת לפני שהזמן הקצוב לתפוגה הסתיים, false אחרת.
הקפצת הודעות שגיאה (throw)
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

waitForWifiEnabled

public abstract boolean waitForWifiEnabled (long timeout)

מחכים עד ש-isWifiEnabled() יהיה true.

פרמטרים
timeout ‫long: זמן ההמתנה במילישניות
החזרות
boolean ‫true אם ה-Wi-Fi הופעל לפני שהזמן הקצוב לתפוגה הסתיים, false אחרת.
הקפצת הודעות שגיאה (throw)
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

waitForWifiEnabled

public abstract boolean waitForWifiEnabled ()

המתנה עד שהערך של isWifiEnabled() יהיה TRUE עם זמן קצוב לתפוגה שמוגדר כברירת מחדל.

החזרות
boolean ‫true אם ה-Wi-Fi הופעל לפני שהזמן הקצוב לתפוגה הסתיים, false אחרת.
הקפצת הודעות שגיאה (throw)
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

waitForWifiState

public abstract boolean waitForWifiState (WifiState... expectedStates)

הפונקציה ממתינה עד שאחד ממצבי ה-Wi-Fi הצפויים מתרחש.

פרמטרים
expectedStates ‫WifiState: מצב Wi-Fi אחד או יותר שצפויים
החזרות
boolean ‫true אם אחד מהמצבים הצפויים התרחש. false if none of the states occurred before timeout is reached
הקפצת הודעות שגיאה (throw)
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException