Gestiona la conectividad WiFi de tu app Capacitor
Comienza con addNetwork() y los demás métodos principales detallados abajo.
Soporte de plataformas
Sección titulada “Soporte 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+, esto abre la configuración de Wi-Fi del sistema con la red prellenada. En iOS, se conecta directamente a la red.connect- Se conecta a una red Wi-Fi. En Android, esto crea una conexión temporal que no enruta el tráfico a través de la red de forma predeterminada. Establece autoRouteTraffic en true para vincular el tráfico de la app a la red conectada (útil para APs locales o alojadas en el dispositivo). Para una conexión persistente en Android, usa addNetwork() en su lugar. En iOS, esto crea una conexión persistente.disconnect- Se desconecta de la red Wi-Fi actual. En iOS, solo se desconecta de las redes que se añadieron mediante este plugin.getAvailableNetworks- Obtiene una lista de redes Wi-Fi disponibles del último escaneo. Solo disponible en Android.
Público API
Sección titulada “Público API”| 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 del sistema con la red ya rellenada. En iOS, se conecta directamente a la red. |
connect | Se conecta a una red Wi-Fi. En Android, esto crea una conexión temporal que no enruta el tráfico a través de la red de forma predeterminada. 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, esto crea una conexión persistente. |
disconnect | Se desconecta de la red Wi-Fi actual. En iOS, solo se desconecta de las redes que se añadieron mediante este plugin. |
getAvailableNetworks | Obtiene una lista de redes Wi-Fi disponibles del último escaneo. Solo disponible en Android. |
getIpAddress | Obtiene la dirección IP actual del dispositivo. Disponible en Android y iOS. |
getRssi | Obtiene el indicador de intensidad de la señal recibida (RSSI) de la red actual en dBm. Solo disponible en Android. |
getSsid | Obtiene el identificador de conjunto de servicios (SSID) de la red actual. Disponible en Android y iOS. |
getWifiInfo | Obtiene información completa sobre la red Wi-Fi a la que está conectado actualmente. Este método devuelve información detallada de la red, incluyendo SSID, BSSID, dirección IP, frecuencia, velocidad de enlace e intensidad de la señal, en una sola llamada. En iOS, algunos campos pueden no estar disponibles y devolverán undefined. |
isEnabled | Comprueba si el Wi-Fi está activado en el dispositivo. Solo disponible en Android. |
startScan | Comienza a escanear 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 de 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 con plugins nativos, 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 del producto en Capgo Plugin Directory, Plugins de Capacitor por Capgo para el detalle de implementación en los Plugins de Capacitor por Capgo, Añadir o actualizar plugins para el detalle de implementación en Agregar o actualizar plugins, y Alternativas a plugins de Ionic Enterprise para el flujo de trabajo del producto en Alternativas a plugins de Ionic Enterprise.