Để 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 uses AI technology to translate content into your preferred language. AI translations can contain errors.

WifiHelper

public class WifiHelper
extends Object implements IWifiHelper

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

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

Tóm tắt

Hằng số
`String`	`INSTRUMENTATION_PKG`

Hàm khởi tạo công khai
`WifiHelper(ITestDevice device)`
`WifiHelper(ITestDevice device, String wifiUtilApkPath)`
`WifiHelper(ITestDevice device, String wifiUtilApkPath, boolean doSetup)` Hàm khởi tạo thay thế có thể bỏ qua bước thiết lập apk Wi-Fi.
`WifiHelper(ITestDevice device, String wifiUtilApkPath, boolean doSetup, boolean useV2)` Hàm khởi tạo để chỉ định có sử dụng trình trợ giúp wifi mới phiên bản 2 hay không.

Phương thức công khai
`boolean`	`addOpenNetwork(String ssid)` Thêm mạng bảo mật mở được xác định bằng ssid.
`boolean`	`addOpenNetwork(String ssid, boolean scanSsid)` Thêm mạng bảo mật mở được xác định bằng ssid.
`boolean`	`addWpaPskNetwork(String ssid, String psk)` Thêm mạng bảo mật WPA-PSK do ssid xác định.
`boolean`	`addWpaPskNetwork(String ssid, String psk, boolean scanSsid)` Thêm mạng bảo mật WPA-PSK do ssid xác định.
`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.
`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.
`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.
`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.
`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.
`boolean`	`disableWifi()` Tắt trạng thái Wi-Fi trên thiết bị.
`boolean`	`disconnectFromNetwork()` Ngắt kết nối khỏi mạng Wi-Fi hiện tại và tắt Wi-Fi.
`boolean`	`enableWifi()` Cho phép trạng thái Wi-Fi trên thiết bị.
`static File`	`extractWifiUtilApk()` Phương thức trợ giúp để trích xuất apk tiện ích wifi từ đường dẫn lớp
`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.
`String`	`getIpAddress()` Lấy địa chỉ IP được liên kết với giao diện Wi-Fi.
`String`	`getSSID()` Lấy mã định danh của bộ dịch vụ của mạng hiện đang kết nối.
`Map<String, String>`	`getWifiInfo()` Lấy thông tin về kết nối Wi-Fi hiện tại.
`boolean`	`hasValidIp()`
`boolean`	`isWifiEnabled()` Kiểm tra xem Wi-Fi hiện có đang bật hay không.
`boolean`	`removeAllNetworks()` Xoá tất cả các mạng đã biết.
`boolean`	`startMonitor(long interval, String urlToCheck)` Bắt đầu giám sát kết nối mạng.
`List<Long>`	`stopMonitor()` Dừng giám sát kết nối mạng.
`boolean`	`waitForIp(long timeout)` Chờ cho đến khi địa chỉ IP được chỉ định cho bộ chuyển đổi Wi-Fi.
`boolean`	`waitForWifiDisabled(long timeout)` Chờ `isWifiEnabled()` có giá trị false.
`boolean`	`waitForWifiDisabled()` Chờ `isWifiEnabled()` có giá trị false với thời gian chờ mặc định.
`boolean`	`waitForWifiEnabled(long timeout)` Chờ `isWifiEnabled()` là true.
`boolean`	`waitForWifiEnabled()` Chờ `isWifiEnabled()` là true với thời gian chờ mặc định.
`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.

Hằng số

INSTRUMENTATION_PKG

public static final String INSTRUMENTATION_PKG

Giá trị không đổi: "com.android.tradefed.utils.wifi"

Hàm khởi tạo công khai

WifiHelper

public WifiHelper (ITestDevice device)

Tham số
`device`	`ITestDevice`

Gửi
`DeviceNotAvailableException`

WifiHelper

public WifiHelper (ITestDevice device, 
                String wifiUtilApkPath)

Tham số
`device`	`ITestDevice`
`wifiUtilApkPath`	`String`

Gửi
`DeviceNotAvailableException`

WifiHelper

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

Hàm khởi tạo thay thế có thể bỏ qua bước thiết lập apk Wi-Fi.

Tham số
`device`	`ITestDevice`
`wifiUtilApkPath`	`String`
`doSetup`	`boolean`

Gửi
`DeviceNotAvailableException`

WifiHelper

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

Hàm khởi tạo để chỉ định có sử dụng trình trợ giúp Wi-Fi mới phiên bản 2 hay không. Các thao tác phiên bản 2 không cần cài đặt apk tiện ích Wi-Fi.

Tham số
`device`	`ITestDevice`
`wifiUtilApkPath`	`String`
`doSetup`	`boolean`
`useV2`	`boolean`

Gửi
`DeviceNotAvailableException`

Phương thức công khai

addOpenNetwork

public 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
`DeviceNotAvailableException`

addOpenNetwork

public 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
`DeviceNotAvailableException`

addWpaPskNetwork

public 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
`DeviceNotAvailableException`

addWpaPskNetwork

public 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
`DeviceNotAvailableException`

checkConnectivity

public 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
`DeviceNotAvailableException`

cleanUp

public 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
`DeviceNotAvailableException`

connectToNetwork

public 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
`DeviceNotAvailableException`

connectToNetwork

public 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
`DeviceNotAvailableException`

connectToNetwork

public 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
`DeviceNotAvailableException`

disableWifi

public 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
`DeviceNotAvailableException`

disconnectFromNetwork

public 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
`DeviceNotAvailableException`

enableWifi

public 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
`DeviceNotAvailableException`

extractWifiUtilApk

public static File extractWifiUtilApk ()

Phương thức trợ giúp để trích xuất apk tiện ích wifi từ đường dẫn lớp

Giá trị trả về
`File`

Gửi
`IOException`

getBSSID

public 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
`DeviceNotAvailableException`

getIpAddress

public 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 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
`DeviceNotAvailableException`

getWifiInfo

public 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
`DeviceNotAvailableException`

hasValidIp

public boolean hasValidIp ()

Giá trị trả về
`boolean`

Gửi
`DeviceNotAvailableException`

isWifiEnabled

public 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 boolean removeAllNetworks ()

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

Giá trị trả về
`boolean`

Gửi
`DeviceNotAvailableException`

startMonitor

public 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
`DeviceNotAvailableException`

stopMonitor

public 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
`DeviceNotAvailableException`

waitForIp

public 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
`DeviceNotAvailableException`

waitForWifiDisabled

public 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
`DeviceNotAvailableException`

waitForWifiDisabled

public 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
`DeviceNotAvailableException`

waitForWifiEnabled

public 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
`DeviceNotAvailableException`

waitForWifiEnabled

public 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
`DeviceNotAvailableException`

waitForWifiState

public 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
`DeviceNotAvailableException`