自 2025 年 3 月 27 日起，我們建議您使用 android-latest-release 而非 aosp-main 建構及貢獻 AOSP。詳情請參閱「Android 開放原始碼計畫變更」。

本頁面由 Cloud Translation API 翻譯而成。

WifiHelper

public class WifiHelper
extends Object

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

用於在裝置上操控 Wi-Fi 服務的輔助類別。

摘要

欄位
`public static final String`	`INSTRUMENTATION_PKG`

公用建構函式
`WifiHelper(ITestDevice device)`
`WifiHelper(ITestDevice device, String wifiUtilApkPath)`
`WifiHelper(ITestDevice device, String wifiUtilApkPath, boolean doSetup)` 可略過 Wi-Fi APK 設定的替代建構函式。
`WifiHelper(ITestDevice device, String wifiUtilApkPath, boolean doSetup, boolean useV2)` 建構函式，用於指定是否要使用新的 Wi-Fi Helper 2.0。

公用方法
`boolean`	`addOpenNetwork(String ssid)`
`boolean`	`addOpenNetwork(String ssid, boolean scanSsid)`
`boolean`	`addWpaPskNetwork(String ssid, String psk)`
`boolean`	`addWpaPskNetwork(String ssid, String psk, boolean scanSsid)`
`boolean`	`checkConnectivity(String urlToCheck)`
`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()` 輔助方法，可從類別路徑中擷取 wifi util apk
`String`	`getBSSID()`
`String`	`getIpAddress()`
`String`	`getSSID()`
	`getWifiInfo()`
`boolean`	`hasValidIp()`
`boolean`	`isWifiEnabled()`
`boolean`	`removeAllNetworks()`
`boolean`	`startMonitor(long interval, String urlToCheck)`
	`stopMonitor()`
`boolean`	`waitForIp(long timeout)`
`boolean`	`waitForWifiDisabled(long timeout)`
`boolean`	`waitForWifiDisabled()`
`boolean`	`waitForWifiEnabled(long timeout)`
`boolean`	`waitForWifiEnabled()`
`boolean`	`waitForWifiState(WifiState... expectedStates)`

欄位

INSTRUMENTATION_PKG

public static final String INSTRUMENTATION_PKG

公用建構函式

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)

可略過 Wi-Fi APK 設定的替代建構函式。

參數
`device`	`ITestDevice`
`wifiUtilApkPath`	`String`
`doSetup`	`boolean`

擲回
`DeviceNotAvailableException`

WifiHelper

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

建構函式，可指定是否要使用新的 Wi-Fi Helper v2。v2 作業不需要安裝 Wi-Fi util apk。

參數
`device`	`ITestDevice`
`wifiUtilApkPath`	`String`
`doSetup`	`boolean`
`useV2`	`boolean`

擲回
`DeviceNotAvailableException`

公用方法

addOpenNetwork

public boolean addOpenNetwork (String ssid)

參數
`ssid`	`String`

傳回
`boolean`

擲回
`DeviceNotAvailableException`

addOpenNetwork

public boolean addOpenNetwork (String ssid, 
                boolean scanSsid)

參數
`ssid`	`String`
`scanSsid`	`boolean`

傳回
`boolean`

擲回
`DeviceNotAvailableException`

addWpaPskNetwork

public boolean addWpaPskNetwork (String ssid, 
                String psk)

參數
`ssid`	`String`
`psk`	`String`

傳回
`boolean`

擲回
`DeviceNotAvailableException`

addWpaPskNetwork

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

參數
`ssid`	`String`
`psk`	`String`
`scanSsid`	`boolean`

傳回
`boolean`

擲回
`DeviceNotAvailableException`

checkConnectivity

public boolean checkConnectivity (String urlToCheck)

參數
`urlToCheck`	`String`

傳回
`boolean`

擲回
`DeviceNotAvailableException`

cleanUp

public void cleanUp ()

擲回
`DeviceNotAvailableException`

connectToNetwork

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

參數
`ssid`	`String`
`psk`	`String`
`urlToCheck`	`String`

傳回
`boolean`

擲回
`DeviceNotAvailableException`

connectToNetwork

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

參數
`ssid`	`String`
`psk`	`String`
`urlToCheck`	`String`
`scanSsid`	`boolean`
`defaultType`	`String`

傳回
`IWifiHelper.WifiConnectionResult`

擲回
`DeviceNotAvailableException`

connectToNetwork

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

參數
`ssid`	`String`
`psk`	`String`
`urlToCheck`	`String`
`scanSsid`	`boolean`

傳回
`IWifiHelper.WifiConnectionResult`

擲回
`DeviceNotAvailableException`

disableWifi

public boolean disableWifi ()

傳回
`boolean`

擲回
`DeviceNotAvailableException`

disconnectFromNetwork

public boolean disconnectFromNetwork ()

傳回
`boolean`

擲回
`DeviceNotAvailableException`

enableWifi

public boolean enableWifi ()

傳回
`boolean`

擲回
`DeviceNotAvailableException`

extractWifiUtilApk

public static File extractWifiUtilApk ()

從類別路徑中擷取 wifi util apk 的輔助方法

傳回
`File`

getBSSID

public String getBSSID ()

傳回
`String`

擲回
`DeviceNotAvailableException`

getIpAddress

public String getIpAddress ()

傳回
`String`

擲回
`DeviceNotAvailableException`

getSSID

public String getSSID ()

傳回
`String`

擲回
`DeviceNotAvailableException`

getWifiInfo

public  getWifiInfo ()

傳回

擲回
`DeviceNotAvailableException`

hasValidIp

public boolean hasValidIp ()

傳回
`boolean`

擲回
`DeviceNotAvailableException`

isWifiEnabled

public boolean isWifiEnabled ()

傳回
`boolean`

擲回
`DeviceNotAvailableException`

removeAllNetworks

public boolean removeAllNetworks ()

傳回
`boolean`

擲回
`DeviceNotAvailableException`

startMonitor

public boolean startMonitor (long interval, 
                String urlToCheck)

參數
`interval`	`long`
`urlToCheck`	`String`

傳回
`boolean`

擲回
`DeviceNotAvailableException`

stopMonitor

public  stopMonitor ()

傳回

擲回
`DeviceNotAvailableException`

waitForIp

public boolean waitForIp (long timeout)

參數
`timeout`	`long`

傳回
`boolean`

擲回
`DeviceNotAvailableException`

waitForWifiDisabled

public boolean waitForWifiDisabled (long timeout)

參數
`timeout`	`long`

傳回
`boolean`

擲回
`DeviceNotAvailableException`

waitForWifiDisabled

public boolean waitForWifiDisabled ()

傳回
`boolean`

擲回
`DeviceNotAvailableException`

waitForWifiEnabled

public boolean waitForWifiEnabled (long timeout)

參數
`timeout`	`long`

傳回
`boolean`

擲回
`DeviceNotAvailableException`

waitForWifiEnabled

public boolean waitForWifiEnabled ()

傳回
`boolean`

擲回
`DeviceNotAvailableException`

waitForWifiState

public boolean waitForWifiState (WifiState... expectedStates)

參數
`expectedStates`	`WifiState`

傳回
`boolean`

擲回
`DeviceNotAvailableException`