Langsung ke konten

@capgo/capacitor-wifi

Kelola konektivitas WiFi untuk aplikasi Capacitor Anda

Kelola konektivitas WiFi untuk aplikasi Capacitor Anda

Mulai dengan addNetwork() dan metode inti lainnya yang tercantum di bawah ini.

PlatformDukunganCatatan
iOSYaNative
AndroidYaNative
WebTidakLindungi dengan Capacitor.getPlatform()
  • addNetwork - Menampilkan dialog sistem untuk menambahkan jaringan Wi-Fi ke perangkat. Di Android SDK 30+, ini membuka pengaturan Wi-Fi sistem dengan jaringan yang sudah terisi. Di iOS, ini langsung terhubung ke jaringan tersebut.
  • connect - Menghubungkan ke jaringan Wi-Fi. Pada Android, ini membuat koneksi sementara yang secara default tidak merutekan trafik melalui jaringan tersebut. Atur autoRouteTraffic ke true untuk mengikat trafik aplikasi ke jaringan yang terhubung (berguna untuk AP lokal/yang di-host perangkat). Untuk koneksi persisten di Android, gunakan addNetwork() sebagai gantinya. Pada iOS, ini membuat koneksi persisten.
  • disconnect - Memutus koneksi dari jaringan Wi-Fi saat ini. Di iOS, hanya memutus koneksi dari jaringan yang ditambahkan lewat plugin ini.
  • getAvailableNetworks - Mendapatkan daftar jaringan Wi-Fi yang tersedia dari pemindaian terakhir. Hanya tersedia di Android.
MetodeDeskripsi
addNetworkTampilkan dialog sistem untuk menambahkan jaringan Wi-Fi ke perangkat. Pada Android SDK 30+, ini membuka pengaturan Wi-Fi sistem dengan jaringan yang sudah terisi. Pada iOS, ini langsung terhubung ke jaringan tersebut.
connectHubungkan ke jaringan Wi-Fi. Di Android, ini membuat koneksi sementara yang secara default tidak merutekan trafik melalui jaringan tersebut. Atur autoRouteTraffic ke true untuk mengikat trafik aplikasi ke jaringan yang terhubung (berguna untuk AP lokal/yang di-host di perangkat). Untuk koneksi persisten di Android, gunakan addNetwork(). Di iOS, ini membuat koneksi persisten.
disconnectPutuskan koneksi dari jaringan Wi-Fi saat ini. Pada iOS, hanya memutuskan koneksi dari jaringan yang ditambahkan melalui plugin ini.
getAvailableNetworksDapatkan daftar jaringan Wi-Fi yang tersedia dari pemindaian terakhir. Hanya tersedia di Android.
getIpAddressDapatkan alamat IP perangkat saat ini. Tersedia di Android dan iOS.
getRssiDapatkan received signal strength indicator (RSSI) dari jaringan saat ini dalam dBm. Hanya tersedia di Android.
getSsidDapatkan service set identifier (SSID) dari jaringan saat ini. Tersedia di Android dan iOS.
getWifiInfoDapatkan informasi lengkap tentang jaringan WiFi yang sedang terhubung. Metode ini menyediakan info jaringan secara detail termasuk SSID, BSSID, alamat IP, frekuensi, link speed, dan kekuatan sinyal dalam satu panggilan. Di iOS, beberapa field mungkin tidak tersedia dan akan bernilai undefined.
isEnabledCek apakah Wi-Fi aktif di perangkat. Hanya tersedia di Android.
startScanMulai scanning jaringan Wi-Fi. Hanya tersedia di Android. Hasil dikirim melalui event listener ‘networksScanned’. Catatan: Bisa gagal karena throttling sistem atau masalah hardware.
checkPermissionsCek status izin akses lokasi saat ini. Izin lokasi diperlukan untuk operasi Wi-Fi di kedua platform.
requestPermissionsMinta izin lokasi ke user. Izin lokasi diperlukan untuk operasi Wi-Fi di kedua platform.
addListenerTambahkan listener untuk event ‘networksScanned’. Hanya tersedia di Android. Event ini dipicu saat hasil scan Wi-Fi sudah tersedia.
removeAllListenersHapus semua listener plugin ini.
getPluginVersionDapatkan versi plugin native.

Referensi ini disinkronkan dari src/definitions.ts di capacitor-wifi.

Jika Anda menggunakan @capgo/capacitor-wifi untuk merencanakan pekerjaan plugin native, hubungkan dengan Menggunakan @capgo/capacitor-wifi untuk kapabilitas native saat menggunakan @capgo/capacitor-wifi, Direktori Plugin Capgo untuk alur kerja produk di Direktori Plugin Capgo, Plugin Capacitor oleh Capgo untuk detail implementasi pada Capacitor Plugins oleh Capgo Menambahkan atau Memperbarui Plugin untuk detail implementasi di Menambahkan atau Memperbarui Plugin, dan Alternatif Plugin Ionic Enterprise untuk alur kerja produk dalam Alternatif Plugin Ionic Enterprise.