Allez directement au contenu principal
@capgo/capacitor-wi-fi APIs de dispositifs Open source

Wi-Fi plugin Capacitor

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

Installer

bun add @capgo/capacitor-wifi bunx cap sync
npm, pnpm ou yarn
  • npm install @capgo/capacitor-wifi
  • pnpm add @capgo/capacitor-wifi
  • yarn add @capgo/capacitor-wifi

Guide

Comment utiliser le WiFi dans Capacitor

Tester sur appareil

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

App Store Google Play
Lien QR de prévisualisation du plugin Wi-Fi code

Utilisation de @capgo/capacitor-wifi

Plugin Wi-Fi pour gérer la connectivité Wi-Fi 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 au dispositif. 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 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éconnecte 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 Wi-Fi système avec le réseau prérempli. Sur iOS, cela se connecte directement au réseau.

import { CapacitorWifi, NetworkSecurityType } 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éfinir autoRouteTraffic sur true pour lier le trafic de l'application au réseau connecté (utile pour les APs hôte local/par 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 se déconnecte uniquement des réseaux ajoutés via ce plugin.

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

await CapacitorWifi.disconnect();

getAvailableNetworks

Obtenir une 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 Utilisation de @capgo/capacitor-wifi pour planifier l'interface de bord et les opérations API, la connecter 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, Vue d'ensemble de API pour les détails d'implémentation dans Vue d'ensemble de API, Introduction pour les détails d'implémentation dans Introduction, et Clés de API pour les détails d'implémentation dans Clés de API.

FAQ

Questions fréquentes sur le plugin WiFi

Comment installer le plugin WiFi dans une application Capacitor?

Exécutez « bun add @capgo/capacitor-wifi » (ou « npm install @capgo/capacitor-wifi »), puis exécutez « bunx cap sync » afin que les projets iOS et Android prennent en compte le code natif. Importez-l’à partir de « @capgo/capacitor-wifi » dans votre application code.

Fonctionne-t-il avec React, Vue et Angular @capgo/capacitor-wifi ?

Oui. Le Wi-Fi est un paquet Capacitor, il fonctionne donc avec tout framework web qui tourne à l'intérieur Capacitor, y compris Ionic, React, Vue, Angular, Svelte et JavaScript pur.

Quelle version Capacitor est prise en charge par @capgo/capacitor-wifi ?

Les plugins Capgo suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à votre version majeure de Capacitor (par exemple, plugin v8 avec Capacitor 8). La table de compatibilité dans le README de GitHub liste les versions maintenues.

Le Wi-Fi @capgo/capacitor-wifi est-il gratuit et open source ?

Oui. Le code source code est public sur GitHub à https://github.com/Cap-go/capacitor-wifi/ et le paquet est gratuit pour l'installer depuis npm. Les rapports de bogues et les demandes de mise à jour sont les bienvenus.

Peut-on mettre à jour code qui utilise Wi-Fi sans passer par une revue de l'App Store ?

L'installation ou la mise à niveau du plugin change la version native de code, elle nécessite donc une nouvelle mise à jour de l'application. Après cela, les modifications JavaScript, HTML et CSS qui appellent le plugin peuvent être déployées instantanément avec les mises à jour Capgo.

APIs de dispositifs

Plugins connexes

Explorer tous les plugins →

Envoyer les modifications WiFi sans attendre la revue de l'application

Une fois le plugin dans votre magasin de build, Capgo les mises à jour en temps réel poussent vos modifications JavaScript, HTML et CSS chez les utilisateurs en quelques minutes.

Commencez par Capgo