Saltar al contenido principal
@capgo/capacitor-wifi Dispositivos de API Fuente abierta

WiFi plugin de Capacitor

Administrar la conectividad WiFi para tu aplicación 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 dispositivo

Descargue la aplicación Capgo, luego escane la QR code.

Vista previa del plugin de WiFi QR code

Usando @capgo/capacitor-wifi

Plugin de WiFi para gestionar la conectividad WiFi del dispositivo.

Instalar

bun add @capgo/capacitor-wifi
bunx cap sync

¿Qué expone este plugin?

  • addNetwork - Mostrar un diálogo del sistema para agregar una red WiFi al dispositivo. En Android SDK 30+, esto abre la configuración de WiFi del sistema con la red prellenada. En iOS, esto conecta directamente a la red.
  • connect - Conectar a una red WiFi. En Android, esto crea una conexión temporal que no rutea el tráfico por defecto. Establezca autoRouteTraffic en true para vincular el tráfico de la aplicación a la red conectada (útil para APs locales/host de dispositivos). Para una conexión persistente en Android, utilice addNetwork() en su lugar. En iOS, esto crea una conexión persistente.
  • disconnect - Desconectar de la red WiFi actual. En iOS, solo desconecta de las redes que se agregaron a través de este plugin.
  • getAvailableNetworks - Obtiene una lista de redes Wi-Fi disponibles desde la última escaneo. Solo disponible en Android.

Uso de ejemplo

addNetwork

Mostrar un diálogo del sistema para agregar 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, esto 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

Conectar a una red Wi-Fi. En Android, esto crea una conexión temporal que no rutea el tráfico por defecto. Establezca autoRouteTraffic en true para vincular el tráfico de la aplicación a la red conectada (útil para APs locales/host de dispositivo). Para una conexión persistente en Android, utilice 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

Desconectar de la red Wi-Fi actual. En iOS, solo desconecta de redes que se agregaron mediante este plugin.

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

await CapacitorWifi.disconnect();

getAvailableNetworks

Obtiene una lista de redes Wi-Fi disponibles desde la última 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

Sigue adelante desde Usando @capgo/capacitor-wifi

Si estás utilizando Usando @capgo/capacitor-wifi para planificar la consola y las operaciones de API, conectarlo con @capgo/capacitor-wifi para los detalles de implementación en @capgo/capacitor-wifi, Getting Started para los detalles de implementación en Inicio, Resumen de API para los detalles de implementación en Resumen de API, Introducción para los detalles de implementación en Introducción, y Claves de API Para los detalles de implementación en API Claves.

FAQ

FAQ sobre el plugin de WiFi

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

Ejecuta "bun add @capgo/capacitor-wifi" (o "npm install @capgo/capacitor-wifi"), luego ejecuta "bunx cap sync" para que los proyectos iOS y Android capturen el code nativo. Importa desde "@capgo/capacitor-wifi" en tu aplicación code.

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

Sí. El paquete WiFi es un paquete 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 Capgo siguen la versión mayor de Capacitor: utilice la versión mayor del plugin que coincida con la versión mayor de Capacitor (por ejemplo, plugin v8 con Capacitor 8). La tabla de compatibilidad en el README de GitHub lista las versiones mantenidas.

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

Sí. El código fuente de code está disponible 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 solicitudes de cambios.

¿Puedo actualizar code que utiliza WiFi sin una revisión de la Tienda de Aplicaciones?

Instalar o actualizar el plugin cambia el code nativo, por lo que necesita una nueva compilación de la tienda. Después de eso, los cambios en JavaScript, HTML y CSS que llaman al plugin pueden enviar directamente con Capgo actualizaciones en vivo.

Envía cambios de WiFi sin esperar a la revisión de la aplicación

Una vez que el plugin esté en tu tienda de construcción, Capgo actualizaciones en vivo envían cambios en JavaScript, HTML y CSS a los usuarios en minutos.

Comienza con Capgo