Saltar al contenido principal
@capgo/capacitor-wifi API de dispositivos Código abierto

WiFi plugin Capacitor

Gestiona la conectividad WiFi de tu app Capacitor

Instalar

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

Guía

Cómo usar WiFi en Capacitor

Probar en el dispositivo

Descarga la app Capgo y escanea el QR code.

QR de vista previa del plugin WiFi code

Uso de @capgo/capacitor-wifi

Plugin WiFi para gestionar la conectividad WiFi del dispositivo.

Instalar

bun add @capgo/capacitor-wifi
bunx cap sync

Lo que expone este plugin

  • addNetwork - Muestra un diálogo del sistema para añadir una red Wi-Fi al dispositivo. En Android SDK 30+, esto abre la configuración de Wi-Fi del sistema con la red prellenada. En iOS, se conecta directamente a la red.
  • connect - Se conecta a una red Wi-Fi. En Android, esto crea una conexión temporal que no enruta el tráfico a través de la red por defecto. Establece autoRouteTraffic en true para vincular el tráfico de la app a la red conectada (útil para APs locales o alojadas en el dispositivo). Para una conexión persistente en Android, usa addNetwork() en su lugar. En iOS, esto crea una conexión persistente.
  • disconnect - Desconecta de la red Wi-Fi actual. En iOS, solo se desconecta de las redes que se hayan añadido mediante este plugin.
  • getAvailableNetworks - Obtiene una lista de redes Wi-Fi disponibles del último escaneo. Solo disponible en Android.

Ejemplo de uso

addNetwork

Muestra un diálogo del sistema para añadir una red Wi-Fi al dispositivo. En Android SDK 30+, esto abre los ajustes de Wi-Fi del sistema con la red ya rellenada. En iOS, se conecta directamente a la red.

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

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

connect

Conecta a una red Wi-Fi. En Android, esto crea una conexión temporal que no enruta el tráfico a través de la red por defecto. Establece autoRouteTraffic en true para vincular el tráfico de la app a la red conectada (útil para APs locales o alojados en el dispositivo). Para una conexión persistente en Android, usa addNetwork() en su lugar. En iOS, esto crea una conexión persistente.

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 desconecta de la red Wi-Fi actual. En iOS, solo se desconecta de las redes que se añadieron mediante este plugin.

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

await CapacitorWifi.disconnect();

getAvailableNetworks

Obtiene una lista de redes Wi-Fi disponibles del último escaneo. Solo disponible en Android.

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

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

Referencia completa

Continúa desde Usando @capgo/capacitor-wifi

Si estás usando Uso de @capgo/capacitor-wifi para planificar las operaciones del dashboard y de API, conéctalo con @capgo/capacitor-wifi para el detalle de la implementación en @capgo/capacitor-wifi, Primeros pasos para los detalles de implementación en Primeros pasos, Resumen de API para los detalles de implementación en API Overview, Introducción para los detalles de implementación en Introducción, y Claves de API para los detalles de implementación en API Keys.

FAQ

FAQ del plugin WiFi

¿Cómo instalo el plugin WiFi en una app de Capacitor?

Ejecuta "bun add @capgo/capacitor-wifi" (o "npm install @capgo/capacitor-wifi"), luego ejecuta "bunx cap sync" para que los proyectos de iOS y Android reciban el código nativo code. Impórtalo desde "@capgo/capacitor-wifi" en el code de tu app.

¿Funciona @capgo/capacitor-wifi con React, Vue y Angular?

Sí. WiFi es un paquete de Capacitor, por lo que funciona con cualquier framework web que se ejecute dentro de Capacitor, incluyendo Ionic, React, Vue, Angular, Svelte y JavaScript puro.

¿Qué versión de Capacitor soporta @capgo/capacitor-wifi?

Los plugins de Capgo siguen la versión mayor de Capacitor: usa la versión mayor del plugin que coincida con la versión mayor de tu Capacitor (por ejemplo, el plugin v8 con Capacitor 8). La tabla de compatibilidad del README de GitHub lista las versiones mantenidas.

¿Es @capgo/capacitor-wifi gratuito y de código abierto?

Sí. El code está publicado en GitHub en https://github.com/Cap-go/capacitor-wifi/ y el paquete es gratuito para instalar desde npm. Se aceptan informes de errores y pull requests.

¿Puedo actualizar code que usa WiFi sin una revisión de la App Store?

Instalar o actualizar el plugin cambia el code nativo, así que requiere un nuevo build para la tienda. Después, los cambios de JavaScript, HTML y CSS que llamen al plugin se pueden publicar al instante con las live updates de Capgo.

Publica cambios de WiFi sin esperar la revisión de la app

Una vez que el plugin esté en tu store build, Capgo live updates envía tus cambios de JavaScript, HTML y CSS a los usuarios en minutos.

Empieza con Capgo