کمک‌کننده‌ی وای‌فای

public class WifiHelper
extends Object implements IWifiHelper

شیء جاوا
↳ com.android.tradefed.device.WifiHelper

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

خلاصه

ثابت‌ها

String INSTRUMENTATION_PKG

سازندگان عمومی

WifiHelper ( ITestDevice device)
WifiHelper ( ITestDevice device, String wifiUtilApkPath)
WifiHelper ( ITestDevice device, String wifiUtilApkPath, boolean doSetup)

سازنده‌ی جایگزین که می‌تواند از تنظیمات فایل apk وای‌فای صرف‌نظر کند.

WifiHelper ( ITestDevice device, String wifiUtilApkPath, boolean doSetup, boolean useV2)

سازنده‌ای برای مشخص کردن اینکه آیا از new wifi helper نسخه ۲ استفاده شود یا خیر.

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

boolean addOpenNetwork (String ssid)

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

boolean addOpenNetwork (String ssid, boolean scanSsid)

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

boolean addWpaPskNetwork (String ssid, String psk)

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

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

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

boolean checkConnectivity (String urlToCheck)

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

void cleanUp ()

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

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

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

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

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

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

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

boolean disableWifi ()

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

boolean disconnectFromNetwork ()

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

boolean enableWifi ()

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

static File extractWifiUtilApk ()

روش کمکی برای استخراج فایل apk برنامه wifi از classpath

String getBSSID ()

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

String getIpAddress ()

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

String getSSID ()

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

Map<String, String> getWifiInfo ()

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

boolean hasValidIp ()

boolean isWifiEnabled ()

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

boolean removeAllNetworks ()

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

boolean startMonitor (long interval, String urlToCheck)

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

List<Long> stopMonitor ()

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

boolean waitForIp (long timeout)

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

boolean waitForWifiDisabled (long timeout)

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

boolean waitForWifiDisabled ()

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

boolean waitForWifiEnabled (long timeout)

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

boolean waitForWifiEnabled ()

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

boolean waitForWifiState ( WifiState... expectedStates)

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

ثابت‌ها

ابزار دقیق_PKG 

public static final String INSTRUMENTATION_PKG

مقدار ثابت: "com.android.tradefed.utils.wifi"

سازندگان عمومی

کمک‌کننده‌ی وای‌فای 

public WifiHelper (ITestDevice device)

پارامترها
device ITestDevice

پرتاب‌ها
DeviceNotAvailableException

کمک‌کننده‌ی وای‌فای 

public WifiHelper (ITestDevice device, 
                String wifiUtilApkPath)

پارامترها
device ITestDevice

wifiUtilApkPath String

پرتاب‌ها
DeviceNotAvailableException

کمک‌کننده‌ی وای‌فای 

public WifiHelper (ITestDevice device, 
                String wifiUtilApkPath, 
                boolean doSetup)

سازنده‌ی جایگزین که می‌تواند از تنظیمات فایل apk وای‌فای صرف‌نظر کند.

پارامترها
device ITestDevice

wifiUtilApkPath String

doSetup boolean

پرتاب‌ها
DeviceNotAvailableException

کمک‌کننده‌ی وای‌فای 

public WifiHelper (ITestDevice device, 
                String wifiUtilApkPath, 
                boolean doSetup, 
                boolean useV2)

سازنده برای مشخص کردن اینکه آیا از new wifi helper نسخه ۲ استفاده شود یا خیر. عملیات نسخه ۲ نیازی به نصب فایل apk برنامه wifi util ندارند.

پارامترها
device ITestDevice

wifiUtilApkPath String

doSetup boolean

useV2 boolean

پرتاب‌ها
DeviceNotAvailableException

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

addOpenNetwork 

public boolean addOpenNetwork (String ssid)

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

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

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

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

پرتاب‌ها
DeviceNotAvailableException

addOpenNetwork 

public boolean addOpenNetwork (String ssid, 
                boolean scanSsid)

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

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

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

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

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

پرتاب‌ها
DeviceNotAvailableException

addWpaPskNetwork 

public boolean addWpaPskNetwork (String ssid, 
                String psk)

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

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

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

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

پرتاب‌ها
DeviceNotAvailableException

addWpaPskNetwork 

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

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

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

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

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

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

پرتاب‌ها
DeviceNotAvailableException

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

public boolean checkConnectivity (String urlToCheck)

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

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

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

پرتاب‌ها
DeviceNotAvailableException

پاکسازی 

public void cleanUp ()

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

پرتاب‌ها
DeviceNotAvailableException

اتصال به شبکه 

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

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

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

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

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

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

پرتاب‌ها
DeviceNotAvailableException

اتصال به شبکه 

public 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 که نتیجه اتصال وای فای را نشان می‌دهد

پرتاب‌ها
DeviceNotAvailableException

اتصال به شبکه 

public 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 که نتیجه اتصال وای فای را نشان می‌دهد

پرتاب‌ها
DeviceNotAvailableException

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

public boolean disableWifi ()

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

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

پرتاب‌ها
DeviceNotAvailableException

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

public boolean disconnectFromNetwork ()

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

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

پرتاب‌ها
DeviceNotAvailableException

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

public boolean enableWifi ()

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

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

پرتاب‌ها
DeviceNotAvailableException

استخراج WifiUtilApk 

public static File extractWifiUtilApk ()

روش کمکی برای استخراج فایل apk برنامه wifi از classpath

بازگشت‌ها
File

پرتاب‌ها
IOException

دریافت BSSID 

public String getBSSID ()

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

بازگشت‌ها
String

پرتاب‌ها
DeviceNotAvailableException

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

public String getIpAddress ()

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

بازگشت‌ها
String

پرتاب‌ها
DeviceNotAvailableException

دریافت SSID 

public String getSSID ()

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

بازگشت‌ها
String

پرتاب‌ها
DeviceNotAvailableException

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

public Map<String, String> getWifiInfo ()

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

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

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

پرتاب‌ها
DeviceNotAvailableException

دارای IP معتبر 

public boolean hasValidIp ()

بازگشت‌ها
boolean

پرتاب‌ها
DeviceNotAvailableException

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

public boolean isWifiEnabled ()

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

بازگشت‌ها
boolean

پرتاب‌ها
DeviceNotAvailableException

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

public boolean removeAllNetworks ()

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

بازگشت‌ها
boolean

پرتاب‌ها
DeviceNotAvailableException

شروع مانیتور 

public boolean startMonitor (long interval, 
                String urlToCheck)

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

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

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

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

پرتاب‌ها
DeviceNotAvailableException

مانیتور توقف 

public List<Long> stopMonitor ()

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

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

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

پرتاب‌ها
DeviceNotAvailableException

منتظر آی‌پی 

public boolean waitForIp (long timeout)

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

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

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

پرتاب‌ها
DeviceNotAvailableException

waitForWifiDisabled 

public boolean waitForWifiDisabled (long timeout)

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

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

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

پرتاب‌ها
DeviceNotAvailableException

waitForWifiDisabled 

public boolean waitForWifiDisabled ()

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

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

پرتاب‌ها
DeviceNotAvailableException

waitForWifiEnabled 

public boolean waitForWifiEnabled (long timeout)

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

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

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

پرتاب‌ها
DeviceNotAvailableException

waitForWifiEnabled 

public boolean waitForWifiEnabled ()

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

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

پرتاب‌ها
DeviceNotAvailableException

waitForWifiState 

public boolean waitForWifiState (WifiState... expectedStates)

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

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

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

پرتاب‌ها
DeviceNotAvailableException