Resumen
Sección titulada “Resumen”Gestiona la conectividad WiFi de tu app Capacitor
Empieza con addNetwork() y los demás métodos principales listados abajo.
Soporte de plataformas
Sección titulada “Compatibilidad de plataformas”| Plataforma | Soporte | Notas |
|---|---|---|
| iOS | Sí | Nativo |
| Android | Sí | Nativo |
| Web | No | Protege con Capacitor.getPlatform() |
Funcionalidades principales
Sección titulada “Funcionalidades principales”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 ya rellenada. En iOS, se conecta directamente a la red.connect- Conéctate a una red Wi-Fi. En Android, crea una conexión temporal que, por defecto, no enruta el tráfico por la red. Establece autoRouteTraffic en true para vincular el tráfico de la app a la red conectada (útil para APs locales o alojados en el dispositivo). Para una conexión persistente en Android, usa addNetwork() en su lugar. En iOS, crea una conexión persistente.disconnect- Desconéctate de la red Wi-Fi actual. En iOS, solo se desconecta de las redes añadidas mediante este plugin.getAvailableNetworks- Obtén una lista de las redes Wi-Fi disponibles del último escaneo. Solo disponible en Android.
API pública
Sección titulada “API pública”| Método | Descripción |
|---|---|
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. |
connect | Conecta con 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 conectada (útil para APs locales). Para una conexión persistente en Android, usa addNetwork(). En iOS, crea una conexión persistente. |
disconnect | Desconecta la red Wi-Fi actual. En iOS, solo desconecta las redes que se añadieron mediante este plugin. |
getAvailableNetworks | Obtén una lista de las redes Wi-Fi disponibles del último escaneo. Solo disponible en Android. |
getIpAddress | Obtén la dirección IP actual del dispositivo. Disponible tanto en Android como en iOS. |
getRssi | Obtén el indicador de intensidad de señal recibida (RSSI) de la red actual en dBm. Solo disponible en Android. |
getSsid | Obtén el identificador de conjunto de servicios (SSID) de la red actual. Disponible tanto en Android como en iOS. |
getWifiInfo | Obtén información detallada de la red WiFi conectada. Este método ofrece datos como SSID, BSSID, IP, frecuencia, velocidad de enlace y potencia de señal en una sola llamada. En iOS, algunos campos podrían no estar disponibles y devolverán undefined. |
isEnabled | Comprueba si el Wi-Fi está activado en el dispositivo. Solo disponible en Android. |
startScan | Comienza el escaneo de redes Wi-Fi. Solo disponible en Android. Los resultados se reciben mediante el listener del evento ‘networksScanned’. Nota: Puede fallar por throttling del sistema o problemas de hardware. |
checkPermissions | Comprueba el estado actual de los permisos de ubicación. Se requiere permiso de ubicación para las operaciones de Wi-Fi en ambas plataformas. |
requestPermissions | Solicita permisos de ubicación al usuario. Se requiere permiso de ubicación para las operaciones de Wi-Fi en ambas plataformas. |
addListener | Añade un listener para el evento ‘networksScanned’. Solo disponible en Android. Este evento se dispara cuando los resultados del escaneo Wi-Fi están disponibles. |
removeAllListeners | Elimina todos los listeners de este plugin. |
getPluginVersion | Obtén la versión del plugin nativo. |
Fuente de verdad
Sección titulada “Fuente de verdad”Esta referencia se sincroniza desde src/definitions.ts en capacitor-wifi.
Continúa desde @capgo/capacitor-wifi
Sección titulada “Continúa desde @capgo/capacitor-wifi”Si estás usando @capgo/capacitor-wifi para planificar el trabajo del plugin nativo, conéctalo con Uso de @capgo/capacitor-wifi para la funcionalidad nativa en Uso de @capgo/capacitor-wifi, Directorio de plugins de Capgo para el flujo de trabajo de productos en el Capgo Plugin Directory, Plugins de Capacitor por Capgo para los detalles de implementación en Plugins de Capacitor por Capgo, Añadir o actualizar plugins para el detalle de implementación en Agregar o actualizar plugins, y Alternativas a los plugins de Ionic Enterprise para el flujo de trabajo del producto en Alternativas a plugins de Ionic Enterprise.