Petunjuk
Tutorial WiFi
Menggunakan @capgo/capacitor-wifi
Plugin WiFi untuk mengelola koneksi WiFi perangkat.
Pasang
bun add @capgo/capacitor-wifi
bunx cap sync
Apa yang Dibuka oleh Plugin ini
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 diisi. Pada iOS, ini menghubungkan ke jaringan secara langsung.connect- Hubungkan ke jaringan Wi-Fi. Pada Android, ini membuat koneksi sementara yang tidak mengarahkan lalu lintas melalui jaringan secara default. Atur autoRouteTraffic menjadi true untuk mengikat lalu lintas aplikasi ke jaringan yang terhubung (bermanfaat untuk AP lokal/host perangkat). Untuk koneksi yang persisten pada Android, gunakan addNetwork() sebaliknya. Pada iOS, ini membuat koneksi yang persisten.disconnect- Lepas dari jaringan Wi-Fi yang sedang terhubung. Pada iOS, hanya lepas dari jaringan yang ditambahkan melalui plugin ini.getAvailableNetworks- Dapatkan daftar jaringan Wi-Fi yang tersedia dari sken terakhir. Hanya tersedia pada 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 diisi. Pada iOS, ini menghubungkan ke jaringan secara langsung.
import { CapacitorWifi } from '@capgo/capacitor-wifi';
await CapacitorWifi.addNetwork({
ssid: 'MyNetwork',
password: 'mypassword',
isHiddenSsid: false,
securityType: NetworkSecurityType.WPA2_PSK
});
connect
Hubungkan ke jaringan Wi-Fi. Pada Android, ini membuat koneksi sementara yang tidak mengarahkan lalu lintas aplikasi ke jaringan secara default. Atur autoRouteTraffic menjadi true untuk mengikat lalu lintas aplikasi ke jaringan yang terhubung (bermanfaat untuk AP lokal/host perangkat). Untuk koneksi yang persisten pada Android, gunakan addNetwork() sebaliknya. 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 yang sedang aktif. 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 sken terakhir. Hanya tersedia pada 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/
- Dokumen: /docs/plugins/wifi/