Panduan
Cara menggunakan WiFi di Capacitor
Menggunakan @capgo/capacitor-wifi
Plugin WiFi untuk Mengelola Koneksi WiFi Perangkat.
Install
bun add @capgo/capacitor-wifi
bunx cap sync
Apa yang Dibuka oleh Plugin Ini
addNetwork- Menampilkan 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 langsung terhubung ke jaringan.connect- Terhubung 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() saja. 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, NetworkSecurityType } 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 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.
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/
Teruskan dari Menggunakan @capgo/capacitor-wifi
Jika Anda menggunakan Menggunakan @capgo/capacitor-wifi untuk merencanakan dashboard dan operasi API, hubungkannya dengan @capgo/capacitor-wifi untuk detail implementasi di @capgo/capacitor-wifi, Mulai Menggunakan untuk detail implementasi di Mulai, Ringkasan API untuk detail implementasi di Ringkasan API, Pendahuluan untuk detail implementasi di Pendahuluan, dan Kunci API untuk detail implementasi di Kunci API.