Guía
Tutorial de WiFi
Usando @capgo/capacitor-wifi
Plugin de WiFi para administrar la conectividad WiFi del dispositivo.
Instalar
bun add @capgo/capacitor-wifi
bunx cap sync
¿Qué se expone con este plugin?
addNetwork- Muestra 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.connect- Conecta 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/almacenados en dispositivos). 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 este plugin.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 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 } 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 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/almacenados 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
Desconecta de la red Wi-Fi actual. En iOS, solo desconecta de 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
- GitHub: https://github.com/Cap-go/capacitor-wifi/
- Documentación: /docs/plugins/wifi/
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 rápido para el detalle de implementación en Getting Started, API Resumen para el detalle de implementación en API Resumen, Introducción para el detalle de implementación en Introducción, y API Claves para el detalle de implementación en API Claves.