Panduan
Cara menggunakan WiFi di Capacitor
Menggunakan @capgo/capacitor-wifi
Plugin WiFi untuk mengelola konektivitas WiFi perangkat.
Instal
bun add @capgo/capacitor-wifi
bunx cap sync
Apa yang Diekspos Plugin Ini
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- Terhubung ke jaringan Wi-Fi. Di Android, ini membuat koneksi sementara yang secara default tidak merutekan trafik melalui jaringan. 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. Di 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.
Contoh Penggunaan
addNetwork
Tampilkan 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.
import { CapacitorWifi, NetworkSecurityType } from '@capgo/capacitor-wifi';
await CapacitorWifi.addNetwork({
ssid: 'MyNetwork',
password: 'mypassword',
isHiddenSsid: false,
securityType: NetworkSecurityType.WPA2_PSK
});
connect
Terhubung ke jaringan Wi-Fi. Pada Android, ini membuat koneksi sementara yang secara default tidak mengarahkan 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 yang persisten.
import { CapacitorWifi } from '@capgo/capacitor-wifi';
await CapacitorWifi.connect({
ssid: 'MyNetwork',
password: 'mypassword',
autoRouteTraffic: true // Android only: route app traffic through this network
});
disconnect
Putuskan koneksi dari jaringan Wi-Fi saat ini. Pada iOS, hanya memutuskan koneksi dari jaringan yang ditambahkan melalui plugin ini.
import { CapacitorWifi } from '@capgo/capacitor-wifi';
await CapacitorWifi.disconnect();
getAvailableNetworks
Dapatkan daftar jaringan Wi-Fi yang tersedia dari pemindaian terakhir. Hanya tersedia di Android.
import { CapacitorWifi } from '@capgo/capacitor-wifi';
const { networks } = await CapacitorWifi.getAvailableNetworks();
networks.forEach(network => {
console.log(`SSID: ${network.ssid}, Signal: ${network.rssi} dBm`);
});
Referensi Lengkap
- GitHub: https://github.com/Cap-go/capacitor-wifi/
- Dokumentasi: /docs/plugins/wifi/
Lanjutkan dari Menggunakan @capgo/capacitor-wifi
Jika Anda menggunakan Menggunakan @capgo/capacitor-wifi untuk merencanakan operasi dashboard dan API, hubungkan dengan @capgo/capacitor-wifi untuk detail implementasi di @capgo/capacitor-wifi, Panduan Memulai untuk detail implementasi di Getting Started, Ringkasan API untuk detail implementasi di API Overview, Pendahuluan untuk detail implementasi di Introduction, dan Kunci API untuk detail implementasi di API Keys.