WifiHelper

public class WifiHelper
extends Object implements IWifiHelper

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

Class helper untuk memanipulasi layanan Wi-Fi di perangkat.

Ringkasan

Konstanta

String INSTRUMENTATION_PKG

Konstruktor publik

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

Konstruktor alternatif yang dapat melewati penyiapan APK Wi-Fi.

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

Konstruktor untuk menentukan apakah akan menggunakan helper Wi-Fi v2 baru.

Metode publik

boolean addOpenNetwork(String ssid)

Menambahkan jaringan keamanan terbuka yang diidentifikasi oleh ssid.

boolean addOpenNetwork(String ssid, boolean scanSsid)

Menambahkan jaringan keamanan terbuka yang diidentifikasi oleh ssid.

boolean addWpaPskNetwork(String ssid, String psk)

Menambahkan jaringan keamanan WPA-PSK yang diidentifikasi oleh ssid.

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

Menambahkan jaringan keamanan WPA-PSK yang diidentifikasi oleh ssid.

boolean checkConnectivity(String urlToCheck)

Memeriksa konektivitas dengan mengirimkan permintaan HTTP ke URL yang diberikan.

void cleanUp()

Bersihkan resource dan penginstalan paket bantuan Wi-Fi.

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

Menghubungkan ke jaringan Wi-Fi dan memeriksa konektivitas.

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

Menghubungkan ke jaringan Wi-Fi dan memeriksa konektivitas.

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

Menghubungkan ke jaringan Wi-Fi dan memeriksa konektivitas.

boolean disableWifi()

Menonaktifkan status Wi-Fi di perangkat.

boolean disconnectFromNetwork()

Putuskan koneksi dari jaringan Wi-Fi saat ini dan nonaktifkan Wi-Fi.

boolean enableWifi()

Mengaktifkan status Wi-Fi di perangkat.

static File extractWifiUtilApk()

Metode helper untuk mengekstrak APK utilitas Wi-Fi dari classpath

String getBSSID()

Mendapatkan basic service set identifier (BSSID) dari titik akses saat ini.

String getIpAddress()

Mendapatkan alamat IP yang terkait dengan antarmuka Wi-Fi.

String getSSID()

Mendapatkan service set identifier dari jaringan yang saat ini terhubung.

Map<String, String> getWifiInfo()

Mendapatkan informasi koneksi Wi-Fi saat ini.

boolean hasValidIp()

boolean isWifiEnabled()

Periksa apakah Wi-Fi saat ini diaktifkan.

boolean removeAllNetworks()

Menghapus semua jaringan yang diketahui.

boolean startMonitor(long interval, String urlToCheck)

Memulai pemantauan konektivitas jaringan.

List<Long> stopMonitor()

Menghentikan pemantauan konektivitas jaringan.

boolean waitForIp(long timeout)

Tunggu hingga alamat IP ditetapkan ke adaptor Wi-Fi.

boolean waitForWifiDisabled(long timeout)

Tunggu hingga isWifiEnabled() bernilai salah.

boolean waitForWifiDisabled()

Menunggu hingga isWifiEnabled() bernilai salah (false) dengan waktu tunggu default.

boolean waitForWifiEnabled(long timeout)

Tunggu hingga isWifiEnabled() bernilai benar (true).

boolean waitForWifiEnabled()

Menunggu hingga isWifiEnabled() bernilai benar dengan waktu tunggu default.

boolean waitForWifiState(WifiState... expectedStates)

Menunggu hingga salah satu status Wi-Fi yang diharapkan terjadi.

Konstanta

INSTRUMENTATION_PKG

public static final String INSTRUMENTATION_PKG

Nilai Konstanta: "com.android.tradefed.utils.wifi"

Konstruktor publik

WifiHelper

public WifiHelper (ITestDevice device)

Parameter
device ITestDevice

Menampilkan
DeviceNotAvailableException

WifiHelper

public WifiHelper (ITestDevice device, 
                String wifiUtilApkPath)

Parameter
device ITestDevice

wifiUtilApkPath String

Menampilkan
DeviceNotAvailableException

WifiHelper

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

Konstruktor alternatif yang dapat melewati penyiapan APK Wi-Fi.

Parameter
device ITestDevice

wifiUtilApkPath String

doSetup boolean

Menampilkan
DeviceNotAvailableException

WifiHelper

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

Konstruktor untuk menentukan apakah akan menggunakan helper Wi-Fi v2 baru. Operasi v2 tidak perlu menginstal APK utilitas Wi-Fi.

Parameter
device ITestDevice

wifiUtilApkPath String

doSetup boolean

useV2 boolean

Menampilkan
DeviceNotAvailableException

Metode publik

addOpenNetwork

public boolean addOpenNetwork (String ssid)

Menambahkan jaringan keamanan terbuka yang diidentifikasi oleh ssid.

Untuk terhubung ke jaringan Wi-Fi, profil jaringan harus dibuat di konfigurasi wpa_supplicant terlebih dahulu. Tindakan ini akan memanggil wpa_cli untuk menambahkan jaringan keamanan terbuka yang diidentifikasi oleh ssid.

Parameter
ssid String: SSID jaringan yang akan ditambahkan.
Hasil
boolean true jika jaringan berhasil ditambahkan, false jika tidak.
Menampilkan
DeviceNotAvailableException

addOpenNetwork

public boolean addOpenNetwork (String ssid, 
                boolean scanSsid)

Menambahkan jaringan keamanan terbuka yang diidentifikasi oleh ssid.

Untuk terhubung ke jaringan Wi-Fi, profil jaringan harus dibuat di konfigurasi wpa_supplicant terlebih dahulu. Tindakan ini akan memanggil wpa_cli untuk menambahkan jaringan keamanan terbuka yang diidentifikasi oleh ssid.

Parameter
ssid String: SSID jaringan yang akan ditambahkan.
scanSsid boolean: apakah akan memindai SSID tersembunyi untuk jaringan ini.
Hasil
boolean true jika jaringan berhasil ditambahkan, false jika tidak.
Menampilkan
DeviceNotAvailableException

addWpaPskNetwork

public boolean addWpaPskNetwork (String ssid, 
                String psk)

Menambahkan jaringan keamanan WPA-PSK yang diidentifikasi oleh ssid.

Parameter
ssid String: SSID jaringan yang akan ditambahkan.
psk String: frasa sandi WPA-PSK yang akan digunakan
Hasil
boolean true jika jaringan berhasil ditambahkan, false jika tidak.
Menampilkan
DeviceNotAvailableException

addWpaPskNetwork

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

Menambahkan jaringan keamanan WPA-PSK yang diidentifikasi oleh ssid.

Parameter
ssid String: SSID jaringan yang akan ditambahkan.
psk String: frasa sandi WPA-PSK yang akan digunakan
scanSsid boolean: apakah akan memindai SSID tersembunyi untuk jaringan ini.
Hasil
boolean true jika jaringan berhasil ditambahkan, false jika tidak.
Menampilkan
DeviceNotAvailableException

checkConnectivity

public boolean checkConnectivity (String urlToCheck)

Memeriksa konektivitas dengan mengirimkan permintaan HTTP ke URL yang diberikan.

Parameter
urlToCheck String: URL tujuan untuk pemeriksaan permintaan HTTP
Hasil
boolean true jika perangkat lulus pemeriksaan konektivitas.
Menampilkan
DeviceNotAvailableException

cleanUp

public void cleanUp ()

Bersihkan resource dan penginstalan paket bantuan Wi-Fi. Metode ini hanya boleh dipanggil jika Wi-Fi tidak lagi diperlukan untuk pemanggilan karena perangkat akan kehilangan koneksi Wi-Fi saat helper di-uninstal.

Menampilkan
DeviceNotAvailableException

connectToNetwork

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

Menghubungkan ke jaringan Wi-Fi dan memeriksa konektivitas.

Parameter
ssid String: SSID jaringan yang akan dihubungkan
psk String: frasa sandi WPA-PSK yang akan digunakan. Nilainya boleh null.
urlToCheck String: URL tujuan untuk pemeriksaan permintaan HTTP
Hasil
boolean true jika perangkat lulus pemeriksaan konektivitas.
Menampilkan
DeviceNotAvailableException

connectToNetwork

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

Menghubungkan ke jaringan Wi-Fi dan memeriksa konektivitas.

Parameter
ssid String: SSID jaringan yang akan dihubungkan
psk String: frasa sandi WPA-PSK yang akan digunakan. Nilainya boleh null.
urlToCheck String: URL tujuan untuk pemeriksaan permintaan HTTP
scanSsid boolean: apakah akan memindai SSID tersembunyi untuk jaringan ini
defaultType String: Jenis jaringan default untuk melakukan penggantian jika jenis jaringan SSID tidak ditentukan
Hasil
IWifiHelper.WifiConnectionResult WifiConnectionResult yang merepresentasikan hasil koneksi Wi-Fi
Menampilkan
DeviceNotAvailableException

connectToNetwork

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

Menghubungkan ke jaringan Wi-Fi dan memeriksa konektivitas.

Parameter
ssid String: SSID jaringan yang akan dihubungkan
psk String: frasa sandi WPA-PSK yang akan digunakan. Nilainya boleh null.
urlToCheck String: URL tujuan untuk pemeriksaan permintaan HTTP
scanSsid boolean: apakah akan memindai SSID tersembunyi untuk jaringan ini
Hasil
IWifiHelper.WifiConnectionResult WifiConnectionResult yang merepresentasikan hasil koneksi Wi-Fi
Menampilkan
DeviceNotAvailableException

disableWifi

public boolean disableWifi ()

Menonaktifkan status Wi-Fi di perangkat.

Hasil
boolean true jika Wi-Fi berhasil dinonaktifkan
Menampilkan
DeviceNotAvailableException

disconnectFromNetwork

public boolean disconnectFromNetwork ()

Putuskan koneksi dari jaringan Wi-Fi saat ini dan nonaktifkan Wi-Fi.

Hasil
boolean true jika operasi berhasil.
Menampilkan
DeviceNotAvailableException

enableWifi

public boolean enableWifi ()

Mengaktifkan status Wi-Fi di perangkat.

Hasil
boolean true jika Wi-Fi berhasil diaktifkan
Menampilkan
DeviceNotAvailableException

extractWifiUtilApk

public static File extractWifiUtilApk ()

Metode helper untuk mengekstrak APK utilitas Wi-Fi dari classpath

Hasil
File

Menampilkan
IOException

getBSSID

public String getBSSID ()

Mendapatkan basic service set identifier (BSSID) dari titik akses saat ini.

Hasil
String

Menampilkan
DeviceNotAvailableException

getIpAddress

public String getIpAddress ()

Mendapatkan alamat IP yang terkait dengan antarmuka Wi-Fi. Menampilkan null jika terjadi kegagalan saat mengambil alamat IP.

Hasil
String

Menampilkan
DeviceNotAvailableException

getSSID

public String getSSID ()

Mendapatkan service set identifier dari jaringan yang saat ini terhubung.

Hasil
String

Menampilkan
DeviceNotAvailableException

getWifiInfo

public Map<String, String> getWifiInfo ()

Mendapatkan informasi koneksi Wi-Fi saat ini.

Hal ini mencakup SSID, BSSID, alamat IP, kecepatan link, dan RSSI.

Hasil
Map<String, String> peta yang berisi informasi koneksi Wi-Fi.
Menampilkan
DeviceNotAvailableException

hasValidIp

public boolean hasValidIp ()

Hasil
boolean

Menampilkan
DeviceNotAvailableException

isWifiEnabled

public boolean isWifiEnabled ()

Periksa apakah Wi-Fi saat ini diaktifkan.

Hasil
boolean

Menampilkan
DeviceNotAvailableException

removeAllNetworks

public boolean removeAllNetworks ()

Menghapus semua jaringan yang diketahui.

Hasil
boolean

Menampilkan
DeviceNotAvailableException

startMonitor

public boolean startMonitor (long interval, 
                String urlToCheck)

Memulai pemantauan konektivitas jaringan.

Parameter
interval long: interval antara pemeriksaan konektivitas.
urlToCheck String: URL untuk memeriksa konektivitas.
Hasil
boolean true jika operasi berhasil.
Menampilkan
DeviceNotAvailableException

stopMonitor

public List<Long> stopMonitor ()

Menghentikan pemantauan konektivitas jaringan.

Metode ini juga menampilkan histori latensi sejak panggilan IWifiHelper.startMonitor(long,String) terakhir.

Hasil
List<Long> histori latensi.
Menampilkan
DeviceNotAvailableException

waitForIp

public boolean waitForIp (long timeout)

Tunggu hingga alamat IP ditetapkan ke adaptor Wi-Fi.

Parameter
timeout long: berapa lama harus menunggu
Hasil
boolean true jika alamat IP ditetapkan sebelum waktu tunggu, false jika tidak
Menampilkan
DeviceNotAvailableException

waitForWifiDisabled

public boolean waitForWifiDisabled (long timeout)

Tunggu hingga isWifiEnabled() bernilai salah.

Parameter
timeout long: waktu dalam md untuk menunggu
Hasil
boolean true jika wifi dinonaktifkan sebelum waktu tunggu, false jika tidak.
Menampilkan
DeviceNotAvailableException

waitForWifiDisabled

public boolean waitForWifiDisabled ()

Menunggu hingga isWifiEnabled() bernilai salah (false) dengan waktu tunggu default.

Hasil
boolean true jika wifi dinonaktifkan sebelum waktu tunggu, false jika tidak.
Menampilkan
DeviceNotAvailableException

waitForWifiEnabled

public boolean waitForWifiEnabled (long timeout)

Tunggu hingga isWifiEnabled() bernilai benar (true).

Parameter
timeout long: waktu dalam md untuk menunggu
Hasil
boolean true jika Wi-Fi diaktifkan sebelum waktu tunggu, false jika tidak.
Menampilkan
DeviceNotAvailableException

waitForWifiEnabled

public boolean waitForWifiEnabled ()

Menunggu hingga isWifiEnabled() bernilai benar dengan waktu tunggu default.

Hasil
boolean true jika Wi-Fi diaktifkan sebelum waktu tunggu, false jika tidak.
Menampilkan
DeviceNotAvailableException

waitForWifiState

public boolean waitForWifiState (WifiState... expectedStates)

Menunggu hingga salah satu status Wi-Fi yang diharapkan terjadi.

Parameter
expectedStates WifiState: satu atau beberapa status Wi-Fi yang diharapkan
Hasil
boolean true jika salah satu status yang diharapkan terjadi. false jika tidak ada status yang terjadi sebelum waktu tunggu tercapai
Menampilkan
DeviceNotAvailableException