Passer à la navigation principale
Retour aux plugins
@capgo/capacitor-wifi
Tutoriel
@capgo/capacitor-wifi

Wi-Fi

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

Guide

Tutoriel sur le Wi-Fi

Tester sur appareil

Téléchargez l'application Capgo, puis scannez le code QR code.

Lien de prévisualisation QR du plugin Wi-Fi code

Utilisation de @capgo/capacitor-wifi

Plugin Wi-Fi pour la gestion de la connectivité Wi-Fi du dispositif.

Installer

bun add @capgo/capacitor-wifi
bunx cap sync

Ce que ce plugin expose

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

Exemple d'utilisation

addNetwork

Afficher un dialogue système pour ajouter un réseau Wi-Fi au dispositif. Sur Android SDK 30+, cela ouvre les paramètres de 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 connecter à 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 APs hôte local/ appareil). 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éconnecter 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

Obtenir 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 Utilisation @capgo/capacitor-wifi

Si vous utilisez Utilisation @capgo/capacitor-wifi pour planifier le tableau de bord et les opérations API, connectez-l’avec @capgo/capacitor-wifi pour les détails d'implémentation dans @capgo/capacitor-wifi, Prise en main pour les détails d'implémentation dans Prise en main, API Vue d'ensemble pour les détails d'implémentation dans API Vue d'ensemble, Introduction pour les détails d'implémentation dans l'Introduction, et API Clés pour les détails d'implémentation dans API Clés.