Lompat ke konten utama
Kembali ke plugin
@capgo/capacitor-wifi
Tutorial
oleh github.com/Cap-go

WiFi

Kelola koneksi WiFi untuk aplikasi Capacitor Anda

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