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 برمیگرداند. |
addOpenNetwork
public abstract boolean addOpenNetwork (String ssid,
boolean scanSsid) شبکه امنیتی باز شناسایی شده توسط ssid را اضافه میکند.
برای اتصال به هر شبکه وایفای، ابتدا باید یک پروفایل شبکه در پیکربندی wpa_supplicant ایجاد شود. این کار wpa_cli را برای اضافه کردن شبکه امنیتی باز که توسط ssid شناسایی شده است، فراخوانی میکند.
| پارامترها |
|---|
ssid | String : شناسه شبکهای که قرار است اضافه شود. |
scanSsid | boolean : آیا SSID مخفی برای این شبکه اسکن شود یا خیر. |
| بازگشتها |
|---|
boolean | اگر شبکه با موفقیت اضافه شده باشد، true و در غیر این صورت false برمیگرداند. |
addWpaPskNetwork
public abstract boolean addWpaPskNetwork (String ssid,
String psk) شبکه امنیتی WPA-PSK که توسط ssid شناسایی میشود را اضافه میکند.
| پارامترها |
|---|
ssid | String : شناسه شبکهای که قرار است اضافه شود. |
psk | String : عبارت عبور WPA-PSK مورد استفاده |
| بازگشتها |
|---|
boolean | اگر شبکه با موفقیت اضافه شده باشد، true و در غیر این صورت false برمیگرداند. |
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 برمیگرداند. |
اتصال را بررسی کنید
public abstract boolean checkConnectivity (String urlToCheck)
با ارسال درخواست HTTP به آدرس اینترنتی داده شده، اتصال را بررسی میکند.
| پارامترها |
|---|
urlToCheck | String : یک آدرس اینترنتی مقصد برای بررسی درخواست HTTP |
| بازگشتها |
|---|
boolean | اگر دستگاه از بررسی اتصال عبور کند، true . |
پاکسازی
public abstract void cleanUp ()
منابع را پاکسازی کنید و بستهی کمکی wifi را نصب کنید. این فقط زمانی باید فراخوانی شود که دیگر نیازی به Wifi برای فراخوانی نباشد، زیرا دستگاه هنگام حذف کمکی، اتصال wifi را از دست میدهد.
اتصال به شبکه
public abstract boolean connectToNetwork (String ssid,
String psk,
String urlToCheck) به یک شبکه وایفای متصل شوید و اتصال را بررسی کنید.
| پارامترها |
|---|
ssid | String : ssid شبکهای که قرار است به آن متصل شوید |
psk | String : رمز عبور WPA-PSK مورد استفاده. این رمز میتواند تهی (null) باشد. |
urlToCheck | String : یک آدرس اینترنتی مقصد برای بررسی درخواست HTTP |
| بازگشتها |
|---|
boolean | اگر دستگاه از بررسی اتصال عبور کند، true . |
اتصال به شبکه
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، به آن برمیگردد. |
اتصال به شبکه
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 مخفی برای این شبکه اسکن شود یا خیر |
غیرفعال کردن وایفای
public abstract boolean disableWifi ()
وضعیت وایفای دستگاه را غیرفعال میکند.
| بازگشتها |
|---|
boolean | اگر وای فای با موفقیت غیرفعال شده باشد، true |
قطع ارتباط از شبکه
public abstract boolean disconnectFromNetwork ()
از شبکه وایفای فعلی جدا شوید و وایفای را غیرفعال کنید.
| بازگشتها |
|---|
boolean | اگر عملیات موفقیتآمیز بود، true . |
فعال کردن وای فای
public abstract boolean enableWifi ()
وضعیت وایفای را در دستگاه فعال میکند.
| بازگشتها |
|---|
boolean | اگر وای فای با موفقیت فعال شده باشد، true |
دریافت BSSID
public abstract String getBSSID ()
شناسه مجموعه سرویس پایه (BSSID) نقطه دسترسی فعلی را دریافت میکند.
آدرس آیپی را دریافت کنید
public abstract String getIpAddress ()
آدرس IP مرتبط با رابط وایفای را دریافت میکند. در صورت عدم موفقیت در بازیابی آدرس IP، null را برمیگرداند.
دریافت SSID
public abstract String getSSID ()
شناسه مجموعه سرویس شبکه متصل فعلی را دریافت میکند.
اطلاعات وایفای را دریافت کنید
public abstract Map<String, String> getWifiInfo ()
اطلاعات اتصال وایفای فعلی را دریافت میکند.
این شامل SSID، BSSID، آدرس IP، سرعت لینک و RSSI میشود.
| بازگشتها |
|---|
Map<String, String> | نقشهای حاوی اطلاعات اتصال وایفای. |
دارای IP معتبر
public abstract boolean hasValidIp ()
| بازگشتها |
|---|
boolean | اگر دستگاه آدرس IP معتبری داشته باشد، true |
فعال بودن وایفای
public abstract boolean isWifiEnabled ()
بررسی کنید که آیا وای فای در حال حاضر فعال است یا خیر.
حذف همه شبکهها
public abstract boolean removeAllNetworks ()
تمام شبکههای شناختهشده را حذف میکند.
شروع مانیتور
public abstract boolean startMonitor (long interval,
String urlToCheck)نظارت بر اتصال شبکه را آغاز میکند.
| پارامترها |
|---|
interval | long : فاصله زمانی بین بررسیهای اتصال. |
urlToCheck | String : یک URL برای بررسی اتصال. |
| بازگشتها |
|---|
boolean | اگر عملیات موفقیتآمیز بود، true . |
مانیتور توقف
public abstract List<Long> stopMonitor ()
نظارت بر اتصال شبکه را متوقف میکند.
این همچنین تاریخچه تأخیر را از آخرین فراخوانی IWifiHelper.startMonitor(long,String) برمیگرداند.
| بازگشتها |
|---|
List<Long> | تاریخچه تأخیر. |
منتظر آیپی
public abstract boolean waitForIp (long timeout)
صبر کنید تا یک آدرس IP به آداپتور وای فای اختصاص داده شود.
| پارامترها |
|---|
timeout | long : چقدر باید منتظر ماند |
| بازگشتها |
|---|
boolean | اگر آدرس IP قبل از timeout اختصاص داده شده باشد، true و در غیر این صورت false |
waitForWifiDisabled
public abstract boolean waitForWifiDisabled (long timeout)
صبر کنید تا isWifiEnabled() نادرست شود.
| پارامترها |
|---|
timeout | long : مدت زمان انتظار بر حسب میلیثانیه |
| بازگشتها |
|---|
boolean | اگر وایفای قبل از تایماوت غیرفعال شده باشد، true و در غیر این صورت false . |
waitForWifiDisabled
public abstract boolean waitForWifiDisabled ()
منتظر بمانید تا isWifiEnabled() با یک timeout پیشفرض، false شود.
| بازگشتها |
|---|
boolean | اگر وایفای قبل از تایماوت غیرفعال شده باشد، true و در غیر این صورت false . |
waitForWifiEnabled
public abstract boolean waitForWifiEnabled (long timeout)
صبر کنید تا isWifiEnabled() درست شود.
| پارامترها |
|---|
timeout | long : مدت زمان انتظار بر حسب میلیثانیه |
| بازگشتها |
|---|
boolean | اگر وایفای قبل از تایماوت فعال بوده باشد، true و در غیر این صورت false . |
waitForWifiEnabled
public abstract boolean waitForWifiEnabled ()
منتظر بمانید تا isWifiEnabled() با یک timeout پیشفرض، مقدار true پیدا کند.
| بازگشتها |
|---|
boolean | اگر وایفای قبل از تایماوت فعال بوده باشد، true و در غیر این صورت false . |
waitForWifiState
public abstract boolean waitForWifiState (WifiState... expectedStates)
منتظر میماند تا یکی از حالتهای وایفای مورد انتظار رخ دهد.
| پارامترها |
|---|
expectedStates | WifiState : یک یا چند وضعیت وایفای قابل انتظار |
| بازگشتها |
|---|
boolean | اگر یکی از حالتهای مورد انتظار رخ داده باشد، true . اگر هیچ یک از حالتها قبل از رسیدن به زمان انقضا رخ نداده باشند، false |