WifiHelper

public class WifiHelper
extends Object implements IWifiHelper

java.lang.Object
   ↳ com.android.tradefed.device.WifiHelper

คลาส Helper สำหรับจัดการบริการ Wi-Fi ในอุปกรณ์

สรุป

ค่าคงที่

String INSTRUMENTATION_PKG

เครื่องมือสร้างสาธารณะ

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

ตัวสร้างทางเลือกที่ข้ามการตั้งค่า apk ของ Wi-Fi ได้

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

ตัวสร้างเพื่อระบุว่าจะใช้ตัวช่วย Wi-Fi เวอร์ชัน 2 ใหม่หรือไม่

เมธอดสาธารณะ

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 ไปยัง URL ที่ระบุ

void cleanUp()

ล้างข้อมูลทรัพยากรและแพ็กเกจการติดตั้งตัวช่วย Wi-Fi

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

เชื่อมต่อกับเครือข่าย Wi-Fi และตรวจสอบการเชื่อมต่อ

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

เชื่อมต่อกับเครือข่าย Wi-Fi และตรวจสอบการเชื่อมต่อ

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

เชื่อมต่อกับเครือข่าย Wi-Fi และตรวจสอบการเชื่อมต่อ

boolean disableWifi()

ปิดใช้สถานะ Wi-Fi ในอุปกรณ์

boolean disconnectFromNetwork()

ยกเลิกการเชื่อมต่อจากเครือข่าย Wi-Fi ปัจจุบันและปิดใช้ Wi-Fi

boolean enableWifi()

เปิดใช้สถานะ Wi-Fi ในอุปกรณ์

static File extractWifiUtilApk()

เมธอด Helper เพื่อดึง APK ของยูทิลิตี Wi-Fi จากเส้นทางคลาส

String getBSSID()

รับตัวระบุชุดบริการพื้นฐาน (BSSID) ของจุดเข้าถึงปัจจุบัน

String getIpAddress()

รับที่อยู่ IP ที่เชื่อมโยงกับอินเทอร์เฟซ Wi-Fi

String getSSID()

รับ Service Set Identifier ของเครือข่ายที่เชื่อมต่ออยู่ในปัจจุบัน

Map<String, String> getWifiInfo()

รับข้อมูลการเชื่อมต่อ Wi-Fi ปัจจุบัน

boolean hasValidIp()

boolean isWifiEnabled()

ตรวจสอบว่าได้เปิดใช้ Wi-Fi อยู่หรือไม่

boolean removeAllNetworks()

นำเครือข่ายที่รู้จักทั้งหมดออก

boolean startMonitor(long interval, String urlToCheck)

เริ่มการตรวจสอบการเชื่อมต่อเครือข่าย

List<Long> stopMonitor()

หยุดการตรวจสอบการเชื่อมต่อเครือข่าย

boolean waitForIp(long timeout)

รอจนกว่าจะมีการกำหนดที่อยู่ IP ให้กับอะแดปเตอร์ Wi-Fi

boolean waitForWifiDisabled(long timeout)

รอให้ isWifiEnabled() เป็นเท็จ

boolean waitForWifiDisabled()

รอให้ isWifiEnabled() เป็นเท็จโดยมีระยะหมดเวลาเริ่มต้น

boolean waitForWifiEnabled(long timeout)

รอให้ isWifiEnabled() เป็นจริง

boolean waitForWifiEnabled()

รอให้ isWifiEnabled() เป็นจริงโดยมีระยะหมดเวลาเริ่มต้น

boolean waitForWifiState(WifiState... expectedStates)

รอจนกว่าสถานะ Wi-Fi ที่คาดไว้จะเกิดขึ้น

ค่าคงที่

INSTRUMENTATION_PKG

public static final String INSTRUMENTATION_PKG

ค่าคงที่: "com.android.tradefed.utils.wifi"

เครื่องมือสร้างสาธารณะ

WifiHelper

public WifiHelper (ITestDevice device)

พารามิเตอร์
device ITestDevice

ส่ง
DeviceNotAvailableException

WifiHelper

public WifiHelper (ITestDevice device, 
                String wifiUtilApkPath)

พารามิเตอร์
device ITestDevice

wifiUtilApkPath String

ส่ง
DeviceNotAvailableException

WifiHelper

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

ตัวสร้างทางเลือกที่ข้ามการตั้งค่า apk ของ Wi-Fi ได้

พารามิเตอร์
device ITestDevice

wifiUtilApkPath String

doSetup boolean

ส่ง
DeviceNotAvailableException

WifiHelper

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

ตัวสร้างเพื่อระบุว่าจะใช้ตัวช่วย Wi-Fi เวอร์ชัน 2 ใหม่หรือไม่ การดำเนินการในเวอร์ชัน 2 ไม่จำเป็นต้อง ติดตั้ง APK ของยูทิลิตี Wi-Fi

พารามิเตอร์
device ITestDevice

wifiUtilApkPath String

doSetup boolean

useV2 boolean

ส่ง
DeviceNotAvailableException

เมธอดสาธารณะ

addOpenNetwork

public boolean addOpenNetwork (String ssid)

เพิ่มเครือข่ายความปลอดภัยแบบเปิดที่ระบุโดย ssid

หากต้องการเชื่อมต่อเครือข่าย Wi-Fi คุณต้องสร้างโปรไฟล์เครือข่ายในการกำหนดค่า wpa_supplicant ก่อน ซึ่งจะเรียกใช้ wpa_cli เพื่อเพิ่มเครือข่ายที่ไม่มีการรักษาความปลอดภัยซึ่งระบุโดย ssid

พารามิเตอร์
ssid String: SSID ของเครือข่ายที่จะเพิ่ม
การคืนสินค้า
boolean true หากเพิ่มเครือข่ายสำเร็จ หรือ false หากไม่สำเร็จ
ส่ง
DeviceNotAvailableException

addOpenNetwork

public boolean addOpenNetwork (String ssid, 
                boolean scanSsid)

เพิ่มเครือข่ายความปลอดภัยแบบเปิดที่ระบุโดย ssid

หากต้องการเชื่อมต่อเครือข่าย Wi-Fi คุณต้องสร้างโปรไฟล์เครือข่ายในการกำหนดค่า wpa_supplicant ก่อน ซึ่งจะเรียกใช้ wpa_cli เพื่อเพิ่มเครือข่ายที่ไม่มีการรักษาความปลอดภัยซึ่งระบุโดย ssid

พารามิเตอร์
ssid String: SSID ของเครือข่ายที่จะเพิ่ม
scanSsid boolean: ระบุว่าจะสแกนหา SSID ที่ซ่อนไว้สำหรับเครือข่ายนี้หรือไม่
การคืนสินค้า
boolean true หากเพิ่มเครือข่ายสำเร็จ หรือ false หากไม่สำเร็จ
ส่ง
DeviceNotAvailableException

addWpaPskNetwork

public boolean addWpaPskNetwork (String ssid, 
                String psk)

เพิ่มเครือข่ายความปลอดภัย WPA-PSK ที่ระบุโดย ssid

พารามิเตอร์
ssid String: SSID ของเครือข่ายที่จะเพิ่ม
psk String: พาสเฟรส WPA-PSK ที่จะใช้
การคืนสินค้า
boolean true หากเพิ่มเครือข่ายสำเร็จ หรือ false หากไม่สำเร็จ
ส่ง
DeviceNotAvailableException

addWpaPskNetwork

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

เพิ่มเครือข่ายความปลอดภัย WPA-PSK ที่ระบุโดย ssid

พารามิเตอร์
ssid String: SSID ของเครือข่ายที่จะเพิ่ม
psk String: พาสเฟรส WPA-PSK ที่จะใช้
scanSsid boolean: ระบุว่าจะสแกนหา SSID ที่ซ่อนไว้สำหรับเครือข่ายนี้หรือไม่
การคืนสินค้า
boolean true หากเพิ่มเครือข่ายสำเร็จ หรือ false หากไม่สำเร็จ
ส่ง
DeviceNotAvailableException

checkConnectivity

public boolean checkConnectivity (String urlToCheck)

ตรวจสอบการเชื่อมต่อโดยส่งคำขอ HTTP ไปยัง URL ที่ระบุ

พารามิเตอร์
urlToCheck String: URL ปลายทางสำหรับการตรวจสอบคำขอ HTTP
การคืนสินค้า
boolean true หากอุปกรณ์ผ่านการตรวจสอบการเชื่อมต่อ
ส่ง
DeviceNotAvailableException

cleanUp

public void cleanUp ()

ล้างข้อมูลทรัพยากรและติดตั้งแพ็กเกจ Wifi Helper ควรเรียกใช้ฟังก์ชันนี้เฉพาะเมื่อไม่จำเป็นต้องใช้ Wi-Fi สำหรับการเรียกใช้แล้ว เนื่องจากอุปกรณ์จะสูญเสียการเชื่อมต่อ Wi-Fi เมื่อถอนการติดตั้งโปรแกรมช่วยเหลือ

ส่ง
DeviceNotAvailableException

connectToNetwork

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

เชื่อมต่อกับเครือข่าย Wi-Fi และตรวจสอบการเชื่อมต่อ

พารามิเตอร์
ssid String: SSID ของเครือข่ายที่จะเชื่อมต่อ
psk String: พาสเฟรส WPA-PSK ที่จะใช้ ซึ่งอาจเป็นค่าว่าง
urlToCheck String: URL ปลายทางสำหรับการตรวจสอบคำขอ HTTP
การคืนสินค้า
boolean true หากอุปกรณ์ผ่านการตรวจสอบการเชื่อมต่อ
ส่ง
DeviceNotAvailableException

connectToNetwork

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

เชื่อมต่อกับเครือข่าย Wi-Fi และตรวจสอบการเชื่อมต่อ

พารามิเตอร์
ssid String: SSID ของเครือข่ายที่จะเชื่อมต่อ
psk String: พาสเฟรส WPA-PSK ที่จะใช้ ซึ่งอาจเป็นค่าว่าง
urlToCheck String: URL ปลายทางสำหรับการตรวจสอบคำขอ HTTP
scanSsid boolean: ระบุว่าจะสแกนหา SSID ที่ซ่อนไว้สำหรับเครือข่ายนี้หรือไม่
defaultType String: ประเภทเครือข่ายเริ่มต้นที่จะใช้เป็นข้อมูลสำรองหากไม่สามารถกำหนดประเภทเครือข่ายของ SSID ได้
การคืนสินค้า
IWifiHelper.WifiConnectionResult WifiConnectionResult แสดงผลการเชื่อมต่อ Wi-Fi
ส่ง
DeviceNotAvailableException

connectToNetwork

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

เชื่อมต่อกับเครือข่าย Wi-Fi และตรวจสอบการเชื่อมต่อ

พารามิเตอร์
ssid String: SSID ของเครือข่ายที่จะเชื่อมต่อ
psk String: พาสเฟรส WPA-PSK ที่จะใช้ ซึ่งอาจเป็นค่าว่าง
urlToCheck String: URL ปลายทางสำหรับการตรวจสอบคำขอ HTTP
scanSsid boolean: ระบุว่าจะสแกนหา SSID ที่ซ่อนไว้สำหรับเครือข่ายนี้หรือไม่
การคืนสินค้า
IWifiHelper.WifiConnectionResult WifiConnectionResult แสดงผลการเชื่อมต่อ Wi-Fi
ส่ง
DeviceNotAvailableException

disableWifi

public boolean disableWifi ()

ปิดใช้สถานะ Wi-Fi ในอุปกรณ์

การคืนสินค้า
boolean true หากปิดใช้ Wi-Fi สำเร็จ
ส่ง
DeviceNotAvailableException

disconnectFromNetwork

public boolean disconnectFromNetwork ()

ยกเลิกการเชื่อมต่อจากเครือข่าย Wi-Fi ปัจจุบันและปิดใช้ Wi-Fi

การคืนสินค้า
boolean true หากการดำเนินการสำเร็จ
ส่ง
DeviceNotAvailableException

enableWifi

public boolean enableWifi ()

เปิดใช้สถานะ Wi-Fi ในอุปกรณ์

การคืนสินค้า
boolean true หากเปิดใช้ Wi-Fi เรียบร้อยแล้ว
ส่ง
DeviceNotAvailableException

extractWifiUtilApk

public static File extractWifiUtilApk ()

เมธอด Helper เพื่อดึง APK ของยูทิลิตี Wi-Fi จากเส้นทางคลาส

การคืนสินค้า
File

ส่ง
IOException

getBSSID

public String getBSSID ()

รับตัวระบุชุดบริการพื้นฐาน (BSSID) ของจุดเข้าถึงปัจจุบัน

การคืนสินค้า
String

ส่ง
DeviceNotAvailableException

getIpAddress

public String getIpAddress ()

รับที่อยู่ IP ที่เชื่อมโยงกับอินเทอร์เฟซ Wi-Fi แสดงผล null หากดึงข้อมูลที่อยู่ IP ไม่สำเร็จ

การคืนสินค้า
String

ส่ง
DeviceNotAvailableException

getSSID

public String getSSID ()

รับ Service Set Identifier ของเครือข่ายที่เชื่อมต่ออยู่ในปัจจุบัน

การคืนสินค้า
String

ส่ง
DeviceNotAvailableException

getWifiInfo

public Map<String, String> getWifiInfo ()

รับข้อมูลการเชื่อมต่อ Wi-Fi ปัจจุบัน

ซึ่งรวมถึง SSID, BSSID, ที่อยู่ IP, ความเร็วลิงก์ และ RSSI

การคืนสินค้า
Map<String, String> แผนที่ที่มีข้อมูลการเชื่อมต่อ Wi-Fi
ส่ง
DeviceNotAvailableException

hasValidIp

public boolean hasValidIp ()

การคืนสินค้า
boolean

ส่ง
DeviceNotAvailableException

isWifiEnabled

public boolean isWifiEnabled ()

ตรวจสอบว่าได้เปิดใช้ Wi-Fi อยู่หรือไม่

การคืนสินค้า
boolean

ส่ง
DeviceNotAvailableException

removeAllNetworks

public boolean removeAllNetworks ()

นำเครือข่ายที่รู้จักทั้งหมดออก

การคืนสินค้า
boolean

ส่ง
DeviceNotAvailableException

startMonitor

public boolean startMonitor (long interval, 
                String urlToCheck)

เริ่มการตรวจสอบการเชื่อมต่อเครือข่าย

พารามิเตอร์
interval long: ช่วงเวลาระหว่างการตรวจสอบการเชื่อมต่อ
urlToCheck String: URL ที่ใช้ตรวจสอบการเชื่อมต่อ
การคืนสินค้า
boolean true หากการดำเนินการสำเร็จ
ส่ง
DeviceNotAvailableException

stopMonitor

public List<Long> stopMonitor ()

หยุดการตรวจสอบการเชื่อมต่อเครือข่าย

นอกจากนี้ ยังแสดงประวัติเวลาในการตอบสนองตั้งแต่การโทรครั้งล่าสุด IWifiHelper.startMonitor(long,String) อีกด้วย

การคืนสินค้า
List<Long> ประวัติเวลาในการตอบสนอง
ส่ง
DeviceNotAvailableException

waitForIp

public boolean waitForIp (long timeout)

รอจนกว่าจะมีการกำหนดที่อยู่ IP ให้กับอะแดปเตอร์ Wi-Fi

พารามิเตอร์
timeout long: ระยะเวลาที่ต้องรอ
การคืนสินค้า
boolean true หากมีการกำหนดที่อยู่ IP ก่อนหมดเวลา false มิฉะนั้น
ส่ง
DeviceNotAvailableException

waitForWifiDisabled

public boolean waitForWifiDisabled (long timeout)

รอให้ isWifiEnabled() เป็นเท็จ

พารามิเตอร์
timeout long: เวลาเป็นมิลลิวินาทีที่รอ
การคืนสินค้า
boolean true หากปิดใช้ Wi-Fi ก่อนหมดเวลา false ไม่เช่นนั้น
ส่ง
DeviceNotAvailableException

waitForWifiDisabled

public boolean waitForWifiDisabled ()

รอให้ isWifiEnabled() เป็นเท็จโดยมีระยะหมดเวลาเริ่มต้น

การคืนสินค้า
boolean true หากปิดใช้ Wi-Fi ก่อนหมดเวลา false ไม่เช่นนั้น
ส่ง
DeviceNotAvailableException

waitForWifiEnabled

public boolean waitForWifiEnabled (long timeout)

รอให้ isWifiEnabled() เป็นจริง

พารามิเตอร์
timeout long: เวลาเป็นมิลลิวินาทีที่รอ
การคืนสินค้า
boolean true หากเปิดใช้ Wi-Fi ก่อนหมดเวลา false ไม่เช่นนั้น
ส่ง
DeviceNotAvailableException

waitForWifiEnabled

public boolean waitForWifiEnabled ()

รอให้ isWifiEnabled() เป็นจริงโดยมีระยะหมดเวลาเริ่มต้น

การคืนสินค้า
boolean true หากเปิดใช้ Wi-Fi ก่อนหมดเวลา false ไม่เช่นนั้น
ส่ง
DeviceNotAvailableException

waitForWifiState

public boolean waitForWifiState (WifiState... expectedStates)

รอจนกว่าสถานะ Wi-Fi ที่คาดไว้จะเกิดขึ้น

พารามิเตอร์
expectedStates WifiState: สถานะ Wi-Fi อย่างน้อย 1 รายการที่คาดไว้
การคืนสินค้า
boolean true หากเกิดสถานะที่คาดไว้ false if none of the states occurred before timeout is reached
ส่ง
DeviceNotAvailableException