Guía
Cómo usar WiFi en Capacitor
Uso de @capgo/capacitor-wifi
Plugin de 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+, abre los ajustes de Wi-Fi con la red precargada. En iOS, se conecta directamente a la red.connect- Conecta a una red Wi-Fi. En Android, crea una conexión temporal que no enruta el tráfico por la red por defecto. Usa autoRouteTraffic en true para vincular el tráfico de la app a la red (útil para APs locales). Para una conexión persistente en Android, usa addNetwork(). En iOS, crea una conexión persistente.disconnect- Desconecta de la red Wi-Fi actual. En iOS, solo desconecta de las redes añadidas mediante este plugin.getAvailableNetworks- Obtén 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 con la red precargada. 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
Conéctate a una red Wi-Fi. En Android, crea una conexión temporal que no redirige el tráfico por la red por defecto. Configura autoRouteTraffic en true para vincular el tráfico de la app a la red conectada (útil para APs locales o del dispositivo). Para una conexión persistente en Android, usa addNetwork(). En iOS, 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éctate de la red Wi-Fi actual. En iOS, solo se desconecta de las redes añadidas mediante este plugin.
import { CapacitorWifi } from '@capgo/capacitor-wifi';
await CapacitorWifi.disconnect();
getAvailableNetworks
Obtén 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
- GitHub: https://github.com/Cap-go/capacitor-wifi/
- Docs: /docs/plugins/wifi/
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 por los detalles de 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 por los detalles de implementación en la Introducción, y Claves de API por los detalles de implementación en las Keys de API.