Pasar al contenido principal
Volver a plugins
@capgo/capacitor-wifi
Tutoriales
@capgo/capacitor-wifi

WiFi

Administra la conectividad de WiFi para tu aplicación Capacitor

Guía

Tutorial de WiFi

Probar en dispositivo

Descargar la aplicación Capgo, luego escanea el código QR code.

Enlace QR de vista previa del plugin de WiFi code

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é se expone con 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 envía el tráfico por defecto a través de la red. 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 - Obtener una lista de redes WiFi disponibles desde la última escaneo. Solo disponible en Android.

Ejemplo de uso

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.

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

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

connect

Conéctese 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 hospedados localmente o en dispositivos). 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

Desconéctese de la red Wi-Fi actual. En iOS, solo desconecta de las redes que se agregaron a través de este plugin.

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

Si está utilizando Usando @capgo/capacitor-wifi para planificar la consola y las operaciones de API, conecte con @capgo/capacitor-wifi para el detalle de implementación en @capgo/capacitor-wifi, Inicio para el detalle de implementación en Inicio, API Vista general para el detalle de implementación en API Vista general, Introducción para el detalle de implementación en Introducción, y API Claves para el detalle de implementación en API Claves.