ตั้งแต่ปี 2026 เป็นต้นไป เราจะเผยแพร่ซอร์สโค้ดไปยัง AOSP ในไตรมาสที่ 2 และ 4 เพื่อให้สอดคล้องกับโมเดลการพัฒนาแบบ Trunk Stable และรับประกันความเสถียรของแพลตฟอร์มสำหรับระบบนิเวศ หากต้องการสร้างและมีส่วนร่วมใน AOSP ให้ใช้ android-latest-release android-latest-release สาขา Manifest จะอ้างอิงถึงรุ่นล่าสุดที่พุชไปยัง AOSP เสมอ ดูข้อมูลเพิ่มเติมได้ที่การเปลี่ยนแปลงใน AOSP

Google ใช้เทคโนโลยี AI เพื่อแปลเนื้อหาเป็นภาษาที่คุณต้องการ การแปลโดย AI อาจมีข้อผิดพลาด

IWifiHelper

public interface IWifiHelper

com.android.tradefed.device.IWifiHelper

คลาสย่อยทางอ้อมที่ทราบ

WifiHelper

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

อินเทอร์เฟซ Helper สำหรับจัดการบริการ Wi-Fi ในอุปกรณ์

สรุป

เมธอดสาธารณะ
`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()` รับ Service Set Identifier ของเครือข่ายที่เชื่อมต่ออยู่ในปัจจุบัน
`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()` เป็นเท็จ
`abstract boolean`	`waitForWifiDisabled()` รอให้ `isWifiEnabled()` เป็นเท็จโดยมีระยะหมดเวลาเริ่มต้น
`abstract boolean`	`waitForWifiEnabled(long timeout)` รอให้ `isWifiEnabled()` เป็นจริง
`abstract boolean`	`waitForWifiEnabled()` รอให้ `isWifiEnabled()` เป็นจริงโดยมีระยะหมดเวลาเริ่มต้น
`abstract boolean`	`waitForWifiState(WifiState... expectedStates)` รอจนกว่าสถานะ Wi-Fi ที่คาดไว้จะเกิดขึ้น

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

addOpenNetwork

public abstract boolean addOpenNetwork (String ssid)

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

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

พารามิเตอร์
`ssid`	`String`: SSID ของเครือข่ายที่จะเพิ่ม

การคืนสินค้า
`boolean`	`true` หากเพิ่มเครือข่ายสำเร็จ หรือ `false` หากไม่สำเร็จ

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

addOpenNetwork

public abstract boolean addOpenNetwork (String ssid, 
                boolean scanSsid)

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

พารามิเตอร์
`ssid`	`String`: SSID ของเครือข่ายที่จะเพิ่ม
`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`: SSID ของเครือข่ายที่จะเพิ่ม
`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`: SSID ของเครือข่ายที่จะเพิ่ม
`psk`	`String`: พาสเฟรส WPA-PSK ที่จะใช้
`scanSsid`	`boolean`: ระบุว่าจะสแกนหา SSID ที่ซ่อนไว้สำหรับเครือข่ายนี้หรือไม่

การคืนสินค้า
`boolean`	`true` หากเพิ่มเครือข่ายสำเร็จ หรือ `false` หากไม่สำเร็จ

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

checkConnectivity

public abstract boolean checkConnectivity (String urlToCheck)

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

พารามิเตอร์
`urlToCheck`	`String`: URL ปลายทางสำหรับการตรวจสอบคำขอ HTTP

การคืนสินค้า
`boolean`	`true` หากอุปกรณ์ผ่านการตรวจสอบการเชื่อมต่อ

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

cleanUp

public abstract void cleanUp ()

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

ส่ง
	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 ที่จะใช้ ซึ่งอาจเป็นค่าว่าง
`urlToCheck`	`String`: URL ปลายทางสำหรับการตรวจสอบคำขอ HTTP

การคืนสินค้า
`boolean`	`true` หากอุปกรณ์ผ่านการตรวจสอบการเชื่อมต่อ

ส่ง
	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 ที่จะใช้ ซึ่งอาจเป็นค่าว่าง
`urlToCheck`	`String`: URL ปลายทางสำหรับการตรวจสอบคำขอ HTTP
`scanSsid`	`boolean`: ระบุว่าจะสแกนหา SSID ที่ซ่อนไว้สำหรับเครือข่ายนี้หรือไม่
`defaultType`	`String`: ประเภทเครือข่ายเริ่มต้นที่จะใช้เป็นข้อมูลสำรองหากไม่สามารถกำหนดประเภทเครือข่ายของ SSID ได้

การคืนสินค้า
`IWifiHelper.WifiConnectionResult`	WifiConnectionResult แสดงผลการเชื่อมต่อ Wi-Fi

ส่ง
	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 ที่จะใช้ ซึ่งอาจเป็นค่าว่าง
`urlToCheck`	`String`: URL ปลายทางสำหรับการตรวจสอบคำขอ HTTP
`scanSsid`	`boolean`: ระบุว่าจะสแกนหา SSID ที่ซ่อนไว้สำหรับเครือข่ายนี้หรือไม่

การคืนสินค้า
`IWifiHelper.WifiConnectionResult`	WifiConnectionResult แสดงผลการเชื่อมต่อ Wi-Fi

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

disableWifi

public abstract boolean disableWifi ()

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

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

disconnectFromNetwork

public abstract boolean disconnectFromNetwork ()

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

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

enableWifi

public abstract boolean enableWifi ()

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

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBSSID

public abstract String getBSSID ()

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

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

ดูเพิ่มเติม:

http://developer.android.com/reference/android/net/wifi/WifiInfo.html#getSSID()

getIpAddress

public abstract String getIpAddress ()

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

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

ส่ง
`DeviceNotAvailableException`

getSSID

public abstract String getSSID ()

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

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

ดูเพิ่มเติม:

http://developer.android.com/reference/android/net/wifi/WifiInfo.html#getSSID()

getWifiInfo

public abstract Map<String, String> getWifiInfo ()

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

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

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

hasValidIp

public abstract boolean hasValidIp ()

การคืนสินค้า
`boolean`	`true` หากอุปกรณ์มีที่อยู่ IP ที่ถูกต้อง

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isWifiEnabled

public abstract boolean isWifiEnabled ()

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

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

ส่ง
`DeviceNotAvailableException`

removeAllNetworks

public abstract boolean removeAllNetworks ()

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

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

startMonitor

public abstract boolean startMonitor (long interval, 
                String urlToCheck)

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

พารามิเตอร์
`interval`	`long`: ช่วงเวลาระหว่างการตรวจสอบการเชื่อมต่อ
`urlToCheck`	`String`: URL ที่ใช้ตรวจสอบการเชื่อมต่อ

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

stopMonitor

public abstract List<Long> stopMonitor ()

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

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

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForIp

public abstract boolean waitForIp (long timeout)

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

พารามิเตอร์
`timeout`	`long`: ระยะเวลาที่ต้องรอ

การคืนสินค้า
`boolean`	`true` หากมีการกำหนดที่อยู่ IP ก่อนหมดเวลา `false` มิฉะนั้น

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForWifiDisabled

public abstract boolean waitForWifiDisabled (long timeout)

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

พารามิเตอร์
`timeout`	`long`: เวลาเป็นมิลลิวินาทีที่รอ

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForWifiDisabled

public abstract boolean waitForWifiDisabled ()

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

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForWifiEnabled

public abstract boolean waitForWifiEnabled (long timeout)

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

พารามิเตอร์
`timeout`	`long`: เวลาเป็นมิลลิวินาทีที่รอ

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForWifiEnabled

public abstract boolean waitForWifiEnabled ()

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

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

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForWifiState

public abstract boolean waitForWifiState (WifiState... expectedStates)

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

พารามิเตอร์
`expectedStates`	`WifiState`: สถานะ Wi-Fi อย่างน้อย 1 รายการที่คาดไว้

การคืนสินค้า
`boolean`	`true` หากเกิดสถานะที่คาดไว้ `false` if none of the states occurred before timeout is reached

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`