Lompat ke konten utama
Kembali ke plugin
@capgo/capacitor-wifi
Tutorial
@capgo/capacitor-wifi

WiFi

Manajemen Koneksi WiFi untuk aplikasi Capacitor Anda

Panduan

Tutorial WiFi

Tes di perangkat

Unduh aplikasi Capgo terlebih dahulu, lalu scan kode QR code.

Pratinjau tautan QR plugin WiFi code

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 WiFi ke perangkat. Pada Android SDK 30+, ini membuka pengaturan WiFi sistem dengan jaringan yang sudah diisi. Pada iOS, ini langsung terhubung ke jaringan.
  • connect - Terhubung ke jaringan WiFi. 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 WiFi saat ini. Pada iOS, hanya lepas dari jaringan yang ditambahkan melalui plugin ini.
  • getAvailableNetworks - Dapatkan daftar jaringan WiFi yang tersedia dari skanner terakhir. Hanya tersedia pada Android.

Penggunaan Contoh

addNetwork

Menampilkan dialog sistem untuk menambahkan jaringan WiFi ke perangkat. Pada Android SDK 30+, ini membuka pengaturan WiFi sistem dengan jaringan yang sudah diisi. Pada iOS, ini langsung terhubung ke jaringan.

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 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() alih-alih. 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 skanner 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

Teruskan dari Menggunakan @capgo/capacitor-wifi

Jika Anda menggunakan Menggunakan @capgo/capacitor-wifi untuk merencanakan dashboard dan API operasi, hubungkan dengan @capgo/capacitor-wifi untuk detail implementasi di @capgo/capacitor-wifi, Pemula untuk detail implementasi di Pemula, Ringkasan API untuk detail implementasi di Ringkasan API, Pendahuluan untuk detail implementasi di Pendahuluan, dan Kunci API untuk detail implementasi di Kunci API.