Saltar al contenido principal
Volver a plugins
@capgo/capacitor-wifi
Tutoriales
por github.com/Cap-go

WiFi

Administrar la conectividad WiFi para tu aplicación Capacitor

Guía

Tutoriales de WiFi

Usando @capgo/capacitor-wifi

Plugin de WiFi para la gestión de la conectividad WiFi del dispositivo.

Instalar

bun add @capgo/capacitor-wifi
bunx cap sync

¿Qué Esta Pluga Exposa

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

Ejemplo de Uso

addNetwork

Muestra un diálogo del sistema para agregar una red Wi-Fi a la dispositivo. En Android SDK 30+, esto abre la configuración de Wi-Fi del sistema con la red prellenada. En iOS, esto conecta a la red directamente.

import { CapacitorWifi } 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 rutea el trafico por defecto. Establezca autoRouteTraffic a true para vincular el trafico de la aplicación a la red conectada (útil para APs locales/almacenados en 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

Desconecta de la red Wi-Fi actual. En iOS, solo desconecta de redes que se agregaron a través de esta pluga.

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

await CapacitorWifi.disconnect();

getAvailableNetworks

Obtenga 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.

Siga adelante desde Usando @capgo/capacitor-wifi

Si está utilizando Usando @capgo/capacitor-wifi para planificar la consola de dashboard y operaciones de API, conecte con @capgo/capacitor-wifi para obtener detalles de implementación en @capgo/capacitor-wifi, Inicio de Sesión para los detalles de implementación en Getting Started, API Resumen para los detalles de implementación en API Resumen, Introducción para los detalles de implementación en Introducción, y API Claves for the implementation detail in API Keys.