Để phù hợp với mô hình phát triển ổn định của nhánh chính và đảm bảo tính ổn định của nền tảng cho hệ sinh thái, chúng tôi sẽ xuất bản mã nguồn lên AOSP vào quý 2 và quý 4 năm 2026. Để tạo và đóng góp cho AOSP, hãy sử dụng android-latest-release. Nhánh tệp kê khai android-latest-release sẽ luôn tham chiếu đến bản phát hành gần đây nhất được chuyển đến AOSP. Để biết thêm thông tin, hãy xem bài viết Các thay đổi đối với AOSP.

Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

IWifiHelper

public interface IWifiHelper

com.android.tradefed.device.IWifiHelper

Các lớp con gián tiếp đã biết

WifiHelper

WifiHelper Lớp trợ giúp để thao tác với các dịch vụ Wi-Fi trên thiết bị.

Giao diện trợ giúp để thao tác với các dịch vụ Wi-Fi trên thiết bị.

Tóm tắt

Phương thức công khai
`abstract boolean`	`addOpenNetwork(String ssid)` Thêm mạng bảo mật mở được xác định bằng ssid.
`abstract boolean`	`addOpenNetwork(String ssid, boolean scanSsid)` Thêm mạng bảo mật mở được xác định bằng ssid.
`abstract boolean`	`addWpaPskNetwork(String ssid, String psk)` Thêm mạng bảo mật WPA-PSK do ssid xác định.
`abstract boolean`	`addWpaPskNetwork(String ssid, String psk, boolean scanSsid)` Thêm mạng bảo mật WPA-PSK do ssid xác định.
`abstract boolean`	`checkConnectivity(String urlToCheck)` Kiểm tra khả năng kết nối bằng cách gửi yêu cầu HTTP đến URL đã cho.
`abstract void`	`cleanUp()` Dọn dẹp các tài nguyên và gói cài đặt trình trợ giúp Wi-Fi.
`abstract boolean`	`connectToNetwork(String ssid, String psk, String urlToCheck)` Kết nối với mạng Wi-Fi và kiểm tra khả năng kết nối.
`abstract IWifiHelper.WifiConnectionResult`	`connectToNetwork(String ssid, String psk, String urlToCheck, boolean scanSsid, String defaultType)` Kết nối với mạng Wi-Fi và kiểm tra khả năng kết nối.
`abstract IWifiHelper.WifiConnectionResult`	`connectToNetwork(String ssid, String psk, String urlToCheck, boolean scanSsid)` Kết nối với mạng Wi-Fi và kiểm tra khả năng kết nối.
`abstract boolean`	`disableWifi()` Tắt trạng thái Wi-Fi trên thiết bị.
`abstract boolean`	`disconnectFromNetwork()` Ngắt kết nối khỏi mạng Wi-Fi hiện tại và tắt Wi-Fi.
`abstract boolean`	`enableWifi()` Cho phép trạng thái Wi-Fi trên thiết bị.
`abstract String`	`getBSSID()` Lấy mã nhận dạng của bộ dịch vụ cơ bản (BSSID) của điểm truy cập hiện tại.
`abstract String`	`getIpAddress()` Lấy địa chỉ IP được liên kết với giao diện Wi-Fi.
`abstract String`	`getSSID()` Lấy mã định danh của bộ dịch vụ của mạng hiện đang kết nối.
`abstract Map<String, String>`	`getWifiInfo()` Lấy thông tin về kết nối Wi-Fi hiện tại.
`abstract boolean`	`hasValidIp()`
`abstract boolean`	`isWifiEnabled()` Kiểm tra xem Wi-Fi hiện có đang bật hay không.
`abstract boolean`	`removeAllNetworks()` Xoá tất cả các mạng đã biết.
`abstract boolean`	`startMonitor(long interval, String urlToCheck)` Bắt đầu giám sát kết nối mạng.
`abstract List<Long>`	`stopMonitor()` Dừng giám sát kết nối mạng.
`abstract boolean`	`waitForIp(long timeout)` Chờ cho đến khi địa chỉ IP được chỉ định cho bộ chuyển đổi Wi-Fi.
`abstract boolean`	`waitForWifiDisabled(long timeout)` Chờ `isWifiEnabled()` có giá trị false.
`abstract boolean`	`waitForWifiDisabled()` Chờ `isWifiEnabled()` có giá trị false với thời gian chờ mặc định.
`abstract boolean`	`waitForWifiEnabled(long timeout)` Chờ `isWifiEnabled()` là true.
`abstract boolean`	`waitForWifiEnabled()` Chờ `isWifiEnabled()` là true với thời gian chờ mặc định.
`abstract boolean`	`waitForWifiState(WifiState... expectedStates)` Chờ cho đến khi một trong các trạng thái Wi-Fi dự kiến xảy ra.

Phương thức công khai

addOpenNetwork

public abstract boolean addOpenNetwork (String ssid)

Thêm mạng bảo mật mở được xác định bằng ssid.

Để kết nối với bất kỳ mạng Wi-Fi nào, trước tiên, bạn phải tạo một hồ sơ mạng trong cấu hình wpa_supplicant. Thao tác này sẽ gọi wpa_cli để thêm mạng bảo mật mở do ssid xác định.

Tham số
`ssid`	`String`: ssid của mạng cần thêm.

Giá trị trả về
`boolean`	`true` nếu mạng được thêm thành công, `false` nếu không.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

addOpenNetwork

public abstract boolean addOpenNetwork (String ssid, 
                boolean scanSsid)

Thêm mạng bảo mật mở được xác định bằng ssid.

Tham số
`ssid`	`String`: ssid của mạng cần thêm.
`scanSsid`	`boolean`: có quét SSID ẩn cho mạng này hay không.

Giá trị trả về
`boolean`	`true` nếu mạng được thêm thành công, `false` nếu không.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

addWpaPskNetwork

public abstract boolean addWpaPskNetwork (String ssid, 
                String psk)

Thêm mạng bảo mật WPA-PSK do ssid xác định.

Tham số
`ssid`	`String`: ssid của mạng cần thêm.
`psk`	`String`: cụm mật khẩu WPA-PSK cần dùng

Giá trị trả về
`boolean`	`true` nếu mạng được thêm thành công, `false` nếu không.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

addWpaPskNetwork

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

Thêm mạng bảo mật WPA-PSK do ssid xác định.

Tham số
`ssid`	`String`: ssid của mạng cần thêm.
`psk`	`String`: cụm mật khẩu WPA-PSK cần dùng
`scanSsid`	`boolean`: có quét SSID ẩn cho mạng này hay không.

Giá trị trả về
`boolean`	`true` nếu mạng được thêm thành công, `false` nếu không.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

checkConnectivity

public abstract boolean checkConnectivity (String urlToCheck)

Kiểm tra khả năng kết nối bằng cách gửi yêu cầu HTTP đến URL đã cho.

Tham số
`urlToCheck`	`String`: URL đích để kiểm tra yêu cầu HTTP

Giá trị trả về
`boolean`	`true` nếu thiết bị vượt qua quy trình kiểm tra kết nối.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

cleanUp

public abstract void cleanUp ()

Dọn dẹp các tài nguyên và gói cài đặt trình trợ giúp Wi-Fi. Bạn chỉ nên gọi phương thức này khi không cần Wi-Fi cho lời gọi nữa vì thiết bị sẽ mất kết nối Wi-Fi khi bạn gỡ cài đặt trình trợ giúp.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

connectToNetwork

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

Kết nối với mạng Wi-Fi và kiểm tra khả năng kết nối.

Tham số
`ssid`	`String`: ssid của mạng cần kết nối
`psk`	`String`: cụm mật khẩu WPA-PSK cần sử dụng. Giá trị này có thể là giá trị rỗng.
`urlToCheck`	`String`: URL đích để kiểm tra yêu cầu HTTP

Giá trị trả về
`boolean`	`true` nếu thiết bị vượt qua quy trình kiểm tra kết nối.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

connectToNetwork

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

Kết nối với mạng Wi-Fi và kiểm tra khả năng kết nối.

Tham số
`ssid`	`String`: ssid của mạng cần kết nối
`psk`	`String`: cụm mật khẩu WPA-PSK cần sử dụng. Giá trị này có thể là giá trị rỗng.
`urlToCheck`	`String`: URL đích để kiểm tra yêu cầu HTTP
`scanSsid`	`boolean`: có quét SSID ẩn cho mạng này hay không
`defaultType`	`String`: Loại mạng mặc định để quay lại nếu không xác định được loại mạng của ssid

Giá trị trả về
`IWifiHelper.WifiConnectionResult`	WifiConnectionResult đại diện cho kết quả kết nối Wi-Fi

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

connectToNetwork

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

Kết nối với mạng Wi-Fi và kiểm tra khả năng kết nối.

Tham số
`ssid`	`String`: ssid của mạng cần kết nối
`psk`	`String`: cụm mật khẩu WPA-PSK cần sử dụng. Giá trị này có thể là giá trị rỗng.
`urlToCheck`	`String`: URL đích để kiểm tra yêu cầu HTTP
`scanSsid`	`boolean`: có quét SSID ẩn cho mạng này hay không

Giá trị trả về
`IWifiHelper.WifiConnectionResult`	WifiConnectionResult đại diện cho kết quả kết nối Wi-Fi

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

disableWifi

public abstract boolean disableWifi ()

Tắt trạng thái Wi-Fi trên thiết bị.

Giá trị trả về
`boolean`	`true` nếu Wi-Fi đã tắt thành công

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

disconnectFromNetwork

public abstract boolean disconnectFromNetwork ()

Ngắt kết nối khỏi mạng Wi-Fi hiện tại và tắt Wi-Fi.

Giá trị trả về
`boolean`	`true` nếu thao tác thành công.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

enableWifi

public abstract boolean enableWifi ()

Cho phép trạng thái Wi-Fi trên thiết bị.

Giá trị trả về
`boolean`	`true` nếu Wi-Fi được bật thành công

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBSSID

public abstract String getBSSID ()

Lấy mã nhận dạng của bộ dịch vụ cơ bản (BSSID) của điểm truy cập hiện tại.

Giá trị trả về
`String`

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

Xem thêm:

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

getIpAddress

public abstract String getIpAddress ()

Lấy địa chỉ IP được liên kết với giao diện Wi-Fi. Trả về null nếu không truy xuất được địa chỉ IP.

Giá trị trả về
`String`

Gửi
`DeviceNotAvailableException`

getSSID

public abstract String getSSID ()

Lấy mã định danh của bộ dịch vụ của mạng hiện đang kết nối.

Giá trị trả về
`String`

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

Xem thêm:

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

getWifiInfo

public abstract Map<String, String> getWifiInfo ()

Lấy thông tin về kết nối Wi-Fi hiện tại.

Thông tin này bao gồm SSID, BSSID, địa chỉ IP, tốc độ liên kết và RSSI.

Giá trị trả về
`Map<String, String>`	một bản đồ chứa thông tin về kết nối Wi-Fi.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

hasValidIp

public abstract boolean hasValidIp ()

Giá trị trả về
`boolean`	`true` nếu thiết bị có địa chỉ IP hợp lệ

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isWifiEnabled

public abstract boolean isWifiEnabled ()

Kiểm tra xem Wi-Fi hiện có đang bật hay không.

Giá trị trả về
`boolean`

Gửi
`DeviceNotAvailableException`

removeAllNetworks

public abstract boolean removeAllNetworks ()

Xoá tất cả các mạng đã biết.

Giá trị trả về
`boolean`

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

startMonitor

public abstract boolean startMonitor (long interval, 
                String urlToCheck)

Bắt đầu giám sát kết nối mạng.

Tham số
`interval`	`long`: khoảng thời gian giữa các lần kiểm tra kết nối.
`urlToCheck`	`String`: URL để kiểm tra kết nối.

Giá trị trả về
`boolean`	`true` nếu thao tác thành công.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

stopMonitor

public abstract List<Long> stopMonitor ()

Dừng giám sát kết nối mạng.

Thao tác này cũng trả về nhật ký độ trễ kể từ lệnh gọi IWifiHelper.startMonitor(long,String) gần đây nhất.

Giá trị trả về
`List<Long>`	nhật ký độ trễ.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForIp

public abstract boolean waitForIp (long timeout)

Chờ cho đến khi địa chỉ IP được chỉ định cho bộ chuyển đổi Wi-Fi.

Tham số
`timeout`	`long`: thời gian chờ

Giá trị trả về
`boolean`	`true` nếu địa chỉ IP được chỉ định trước khi hết thời gian chờ, `false` nếu không

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForWifiDisabled

public abstract boolean waitForWifiDisabled (long timeout)

Chờ isWifiEnabled() có giá trị false.

Tham số
`timeout`	`long`: thời gian chờ tính bằng mili giây

Giá trị trả về
`boolean`	`true` nếu wifi bị tắt trước khi hết thời gian chờ, `false` nếu không.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForWifiDisabled

public abstract boolean waitForWifiDisabled ()

Chờ isWifiEnabled() có giá trị false với thời gian chờ mặc định.

Giá trị trả về
`boolean`	`true` nếu wifi bị tắt trước khi hết thời gian chờ, `false` nếu không.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForWifiEnabled

public abstract boolean waitForWifiEnabled (long timeout)

Chờ isWifiEnabled() là true.

Tham số
`timeout`	`long`: thời gian chờ tính bằng mili giây

Giá trị trả về
`boolean`	`true` nếu Wi-Fi được bật trước khi hết thời gian chờ, `false` nếu không.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForWifiEnabled

public abstract boolean waitForWifiEnabled ()

Chờ isWifiEnabled() là true với thời gian chờ mặc định.

Giá trị trả về
`boolean`	`true` nếu Wi-Fi được bật trước khi hết thời gian chờ, `false` nếu không.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForWifiState

public abstract boolean waitForWifiState (WifiState... expectedStates)

Chờ cho đến khi một trong các trạng thái Wi-Fi dự kiến xảy ra.

Tham số
`expectedStates`	`WifiState`: một hoặc nhiều trạng thái Wi-Fi dự kiến

Giá trị trả về
`boolean`	`true` nếu một trong các trạng thái dự kiến xảy ra. `false` nếu không có trạng thái nào xảy ra trước khi hết thời gian chờ

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`