IWifiHelper

public interface IWifiHelper

com.android.tradefed.device.IWifiHelper


رابط کمکی برای دستکاری سرویس‌های وای‌فای روی دستگاه.

خلاصه

روش‌های عمومی

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 به آدرس اینترنتی داده شده، اتصال را بررسی می‌کند.

abstract void cleanUp ()

منابع را پاک‌سازی کنید و بسته‌ی کمکی وای‌فای را نصب کنید.

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

به یک شبکه وای‌فای متصل شوید و اتصال را بررسی کنید.

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

به یک شبکه وای‌فای متصل شوید و اتصال را بررسی کنید.

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

به یک شبکه وای‌فای متصل شوید و اتصال را بررسی کنید.

abstract boolean disableWifi ()

وضعیت وای‌فای دستگاه را غیرفعال می‌کند.

abstract boolean disconnectFromNetwork ()

از شبکه وای‌فای فعلی جدا شوید و وای‌فای را غیرفعال کنید.

abstract boolean enableWifi ()

وضعیت وای‌فای را در دستگاه فعال می‌کند.

abstract String getBSSID ()

شناسه مجموعه سرویس پایه (BSSID) نقطه دسترسی فعلی را دریافت می‌کند.

abstract String getIpAddress ()

آدرس IP مرتبط با رابط وای‌فای را دریافت می‌کند.

abstract String getSSID ()

شناسه مجموعه سرویس شبکه متصل فعلی را دریافت می‌کند.

abstract Map<String, String> getWifiInfo ()

اطلاعات اتصال وای‌فای فعلی را دریافت می‌کند.

abstract boolean hasValidIp ()
abstract boolean isWifiEnabled ()

بررسی کنید که آیا وای فای در حال حاضر فعال است یا خیر.

abstract boolean removeAllNetworks ()

تمام شبکه‌های شناخته‌شده را حذف می‌کند.

abstract boolean startMonitor (long interval, String urlToCheck)

نظارت بر اتصال شبکه را آغاز می‌کند.

abstract List<Long> stopMonitor ()

نظارت بر اتصال شبکه را متوقف می‌کند.

abstract boolean waitForIp (long timeout)

صبر کنید تا یک آدرس IP به آداپتور وای فای اختصاص داده شود.

abstract boolean waitForWifiDisabled (long timeout)

صبر کنید تا isWifiEnabled() ‎ نادرست شود.

abstract boolean waitForWifiDisabled ()

منتظر بمانید تا isWifiEnabled() با یک timeout پیش‌فرض، false شود.

abstract boolean waitForWifiEnabled (long timeout)

صبر کنید تا isWifiEnabled() درست شود.

abstract boolean waitForWifiEnabled ()

منتظر بمانید تا isWifiEnabled() با یک timeout پیش‌فرض، مقدار true پیدا کند.

abstract boolean waitForWifiState ( WifiState... expectedStates)

منتظر می‌ماند تا یکی از حالت‌های وای‌فای مورد انتظار رخ دهد.

روش‌های عمومی

addOpenNetwork

public abstract boolean addOpenNetwork (String ssid)

شبکه امنیتی باز شناسایی شده توسط ssid را اضافه می‌کند.

برای اتصال به هر شبکه وای‌فای، ابتدا باید یک پروفایل شبکه در پیکربندی wpa_supplicant ایجاد شود. این کار wpa_cli را برای اضافه کردن شبکه امنیتی باز که توسط ssid شناسایی شده است، فراخوانی می‌کند.

پارامترها
ssid String : شناسه شبکه‌ای که قرار است اضافه شود.

بازگشت‌ها
boolean اگر شبکه با موفقیت اضافه شده باشد، true و در غیر این صورت false برمی‌گرداند.

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

addOpenNetwork

public abstract boolean addOpenNetwork (String ssid, 
                boolean scanSsid)

شبکه امنیتی باز شناسایی شده توسط ssid را اضافه می‌کند.

برای اتصال به هر شبکه وای‌فای، ابتدا باید یک پروفایل شبکه در پیکربندی wpa_supplicant ایجاد شود. این کار wpa_cli را برای اضافه کردن شبکه امنیتی باز که توسط ssid شناسایی شده است، فراخوانی می‌کند.

پارامترها
ssid String : شناسه شبکه‌ای که قرار است اضافه شود.

scanSsid boolean : آیا SSID مخفی برای این شبکه اسکن شود یا خیر.

بازگشت‌ها
boolean اگر شبکه با موفقیت اضافه شده باشد، true و در غیر این صورت false برمی‌گرداند.

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

addWpaPskNetwork

public abstract boolean addWpaPskNetwork (String ssid, 
                String psk)

شبکه امنیتی WPA-PSK که توسط ssid شناسایی می‌شود را اضافه می‌کند.

پارامترها
ssid String : شناسه شبکه‌ای که قرار است اضافه شود.

psk String : عبارت عبور WPA-PSK مورد استفاده

بازگشت‌ها
boolean اگر شبکه با موفقیت اضافه شده باشد، true و در غیر این صورت false برمی‌گرداند.

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

addWpaPskNetwork

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

شبکه امنیتی WPA-PSK که توسط ssid شناسایی می‌شود را اضافه می‌کند.

پارامترها
ssid String : شناسه شبکه‌ای که قرار است اضافه شود.

psk String : عبارت عبور WPA-PSK مورد استفاده

scanSsid boolean : آیا SSID مخفی برای این شبکه اسکن شود یا خیر.

بازگشت‌ها
boolean اگر شبکه با موفقیت اضافه شده باشد، true و در غیر این صورت false برمی‌گرداند.

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

اتصال را بررسی کنید

public abstract boolean checkConnectivity (String urlToCheck)

با ارسال درخواست HTTP به آدرس اینترنتی داده شده، اتصال را بررسی می‌کند.

پارامترها
urlToCheck String : یک آدرس اینترنتی مقصد برای بررسی درخواست HTTP

بازگشت‌ها
boolean اگر دستگاه از بررسی اتصال عبور کند، true .

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

پاکسازی

public abstract void cleanUp ()

منابع را پاک‌سازی کنید و بسته‌ی کمکی wifi را نصب کنید. این فقط زمانی باید فراخوانی شود که دیگر نیازی به Wifi برای فراخوانی نباشد، زیرا دستگاه هنگام حذف کمکی، اتصال wifi را از دست می‌دهد.

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

اتصال به شبکه

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

به یک شبکه وای‌فای متصل شوید و اتصال را بررسی کنید.

پارامترها
ssid String : ssid شبکه‌ای که قرار است به آن متصل شوید

psk String : رمز عبور WPA-PSK مورد استفاده. این رمز می‌تواند تهی (null) باشد.

urlToCheck String : یک آدرس اینترنتی مقصد برای بررسی درخواست HTTP

بازگشت‌ها
boolean اگر دستگاه از بررسی اتصال عبور کند، true .

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

اتصال به شبکه

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

به یک شبکه وای‌فای متصل شوید و اتصال را بررسی کنید.

پارامترها
ssid String : ssid شبکه‌ای که قرار است به آن متصل شوید

psk String : رمز عبور WPA-PSK مورد استفاده. این رمز می‌تواند تهی (null) باشد.

urlToCheck String : یک آدرس اینترنتی مقصد برای بررسی درخواست HTTP

scanSsid boolean : آیا SSID مخفی برای این شبکه اسکن شود یا خیر

defaultType String : نوع شبکه پیش‌فرض که در صورت عدم تعیین نوع شبکه ssid، به آن برمی‌گردد.

بازگشت‌ها
IWifiHelper.WifiConnectionResult WifiConnectionResult که نتیجه اتصال وای فای را نشان می‌دهد

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

اتصال به شبکه

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

به یک شبکه وای‌فای متصل شوید و اتصال را بررسی کنید.

پارامترها
ssid String : ssid شبکه‌ای که قرار است به آن متصل شوید

psk String : رمز عبور WPA-PSK مورد استفاده. این رمز می‌تواند تهی (null) باشد.

urlToCheck String : یک آدرس اینترنتی مقصد برای بررسی درخواست HTTP

scanSsid boolean : آیا SSID مخفی برای این شبکه اسکن شود یا خیر

بازگشت‌ها
IWifiHelper.WifiConnectionResult WifiConnectionResult که نتیجه اتصال وای فای را نشان می‌دهد

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

غیرفعال کردن وای‌فای

public abstract boolean disableWifi ()

وضعیت وای‌فای دستگاه را غیرفعال می‌کند.

بازگشت‌ها
boolean اگر وای فای با موفقیت غیرفعال شده باشد، true

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

قطع ارتباط از شبکه

public abstract boolean disconnectFromNetwork ()

از شبکه وای‌فای فعلی جدا شوید و وای‌فای را غیرفعال کنید.

بازگشت‌ها
boolean اگر عملیات موفقیت‌آمیز بود، true .

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

فعال کردن وای فای

public abstract boolean enableWifi ()

وضعیت وای‌فای را در دستگاه فعال می‌کند.

بازگشت‌ها
boolean اگر وای فای با موفقیت فعال شده باشد، true

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

دریافت BSSID

public abstract String getBSSID ()

شناسه مجموعه سرویس پایه (BSSID) نقطه دسترسی فعلی را دریافت می‌کند.

بازگشت‌ها
String

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

آدرس آی‌پی را دریافت کنید

public abstract String getIpAddress ()

آدرس IP مرتبط با رابط وای‌فای را دریافت می‌کند. در صورت عدم موفقیت در بازیابی آدرس IP، null را برمی‌گرداند.

بازگشت‌ها
String

پرتاب‌ها
DeviceNotAvailableException

دریافت SSID

public abstract String getSSID ()

شناسه مجموعه سرویس شبکه متصل فعلی را دریافت می‌کند.

بازگشت‌ها
String

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

اطلاعات وای‌فای را دریافت کنید

public abstract Map<String, String> getWifiInfo ()

اطلاعات اتصال وای‌فای فعلی را دریافت می‌کند.

این شامل SSID، BSSID، آدرس IP، سرعت لینک و RSSI می‌شود.

بازگشت‌ها
Map<String, String> نقشه‌ای حاوی اطلاعات اتصال وای‌فای.

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

دارای IP معتبر

public abstract boolean hasValidIp ()

بازگشت‌ها
boolean اگر دستگاه آدرس IP معتبری داشته باشد، true

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

فعال بودن وای‌فای

public abstract boolean isWifiEnabled ()

بررسی کنید که آیا وای فای در حال حاضر فعال است یا خیر.

بازگشت‌ها
boolean

پرتاب‌ها
DeviceNotAvailableException

حذف همه شبکه‌ها

public abstract boolean removeAllNetworks ()

تمام شبکه‌های شناخته‌شده را حذف می‌کند.

بازگشت‌ها
boolean

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

شروع مانیتور

public abstract boolean startMonitor (long interval, 
                String urlToCheck)

نظارت بر اتصال شبکه را آغاز می‌کند.

پارامترها
interval long : فاصله زمانی بین بررسی‌های اتصال.

urlToCheck String : یک URL برای بررسی اتصال.

بازگشت‌ها
boolean اگر عملیات موفقیت‌آمیز بود، true .

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

مانیتور توقف

public abstract List<Long> stopMonitor ()

نظارت بر اتصال شبکه را متوقف می‌کند.

این همچنین تاریخچه تأخیر را از آخرین فراخوانی IWifiHelper.startMonitor(long,String) برمی‌گرداند.

بازگشت‌ها
List<Long> تاریخچه تأخیر.

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

منتظر آی‌پی

public abstract boolean waitForIp (long timeout)

صبر کنید تا یک آدرس IP به آداپتور وای فای اختصاص داده شود.

پارامترها
timeout long : چقدر باید منتظر ماند

بازگشت‌ها
boolean اگر آدرس IP قبل از timeout اختصاص داده شده باشد، true و در غیر این صورت false

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

waitForWifiDisabled

public abstract boolean waitForWifiDisabled (long timeout)

صبر کنید تا isWifiEnabled() ‎ نادرست شود.

پارامترها
timeout long : مدت زمان انتظار بر حسب میلی‌ثانیه

بازگشت‌ها
boolean اگر وای‌فای قبل از تایم‌اوت غیرفعال شده باشد، true و در غیر این صورت false .

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

waitForWifiDisabled

public abstract boolean waitForWifiDisabled ()

منتظر بمانید تا isWifiEnabled() با یک timeout پیش‌فرض، false شود.

بازگشت‌ها
boolean اگر وای‌فای قبل از تایم‌اوت غیرفعال شده باشد، true و در غیر این صورت false .

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

waitForWifiEnabled

public abstract boolean waitForWifiEnabled (long timeout)

صبر کنید تا isWifiEnabled() درست شود.

پارامترها
timeout long : مدت زمان انتظار بر حسب میلی‌ثانیه

بازگشت‌ها
boolean اگر وای‌فای قبل از تایم‌اوت فعال بوده باشد، true و در غیر این صورت false .

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

waitForWifiEnabled

public abstract boolean waitForWifiEnabled ()

منتظر بمانید تا isWifiEnabled() با یک timeout پیش‌فرض، مقدار true پیدا کند.

بازگشت‌ها
boolean اگر وای‌فای قبل از تایم‌اوت فعال بوده باشد، true و در غیر این صورت false .

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

waitForWifiState

public abstract boolean waitForWifiState (WifiState... expectedStates)

منتظر می‌ماند تا یکی از حالت‌های وای‌فای مورد انتظار رخ دهد.

پارامترها
expectedStates WifiState : یک یا چند وضعیت وای‌فای قابل انتظار

بازگشت‌ها
boolean اگر یکی از حالت‌های مورد انتظار رخ داده باشد، true . اگر هیچ یک از حالت‌ها قبل از رسیدن به زمان انقضا رخ نداده باشند، false

پرتاب‌ها
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException