Aller directement au contenu principal
Capgo logo
Retour aux plugins
@capgo/capacitor-wifi
Tutoriel
par github.com/Cap-go

Wi-Fi

Gérez la connectivité Wi-Fi pour votre application Capacitor

Téléchargements/semaine

15.0k

GitHub étoiles

8

Guide

Tutoriel sur le WiFi

Utilisation de @capgo/capacitor-wifi

Plugin WiFi pour la gestion de la connectivité WiFi du dispositif.

Installer

bun add @capgo/capacitor-wifi
bunx cap sync

Ce que ce plugin expose

  • addNetwork - Affiche un dialogue système pour ajouter un réseau Wi-Fi à l'appareil. Sur Android SDK 30+, cela ouvre les paramètres Wi-Fi système avec le réseau pré-rempli. Sur iOS, cela se connecte directement au réseau.
  • connect - Se connecte à un réseau Wi-Fi. Sur Android, cela crée une connexion temporaire qui n'envoie pas les données par défaut par le réseau. Définissez autoRouteTraffic sur true pour lier le trafic de l'application au réseau connecté (utile pour les AP locaux/accueillant les appareils). Pour une connexion persistante sur Android, utilisez addNetwork() à la place. Sur iOS, cela crée une connexion persistante.
  • disconnect - Se déconnecte du réseau Wi-Fi actuel. Sur iOS, cela ne se déconnecte que des réseaux ajoutés via ce plugin.
  • getAvailableNetworks - Récupère la liste des réseaux Wi-Fi disponibles à partir de la dernière scan. Disponible uniquement sur Android.

Exemple d'utilisation

addNetwork

Affiche un dialogue système pour ajouter un réseau Wi-Fi à l'appareil. Sur Android SDK 30+, cela ouvre les paramètres Wi-Fi système avec le réseau pré-rempli. Sur iOS, cela se connecte directement au réseau.

import { CapacitorWifi } from '@capgo/capacitor-wifi';

await CapacitorWifi.addNetwork({
  ssid: 'MyNetwork',
  password: 'mypassword',
  isHiddenSsid: false,
  securityType: NetworkSecurityType.WPA2_PSK
});

connect

Se connecte à un réseau Wi-Fi. Sur Android, cela crée une connexion temporaire qui n'envoie pas les données par défaut par le réseau. Définissez autoRouteTraffic sur true pour lier le trafic de l'application au réseau connecté (utile pour les AP locaux/accueillant les appareils). Pour une connexion persistante sur Android, utilisez addNetwork() à la place. Sur iOS, cela crée une connexion persistante.

import { CapacitorWifi } from '@capgo/capacitor-wifi';

await CapacitorWifi.connect({
  ssid: 'MyNetwork',
  password: 'mypassword',
  autoRouteTraffic: true // Android only: route app traffic through this network
});

disconnect

Se déconnecte du réseau Wi-Fi actuel. Sur iOS, cela ne se déconnecte que des réseaux ajoutés via ce plugin.

import { CapacitorWifi } from '@capgo/capacitor-wifi';

await CapacitorWifi.disconnect();

getAvailableNetworks

Obtenez la liste des réseaux Wi-Fi disponibles à partir de la dernière scan. Disponible uniquement sur Android.

import { CapacitorWifi } from '@capgo/capacitor-wifi';

const { networks } = await CapacitorWifi.getAvailableNetworks();
networks.forEach(network => {
  console.log(`SSID: ${network.ssid}, Signal: ${network.rssi} dBm`);
});

Référence complète

Continuez à partir de l'utilisation de @capgo/capacitor-wifi

Si vous utilisez L'utilisation de @capgo/capacitor-wifi pour planifier le tableau de bord et les opérations API, connectez-le avec @capgo/capacitor-wifi pour les détails d'implémentation dans @capgo/capacitor-wifi, Démarrage pour les détails d'implémentation dans Getting Started, API Aperçu pour les détails d'implémentation dans API Aperçu, Introduction pour les détails d'implémentation dans Introduction, et API Clés pour les détails d'implémentation dans API Clés.