Saltar al contenido

@capgo/capacitor-wifi

Gestiona la conectividad WiFi de tu app Capacitor

Gestiona la conectividad WiFi de tu app Capacitor

Empieza con addNetwork() y los demás métodos principales listados abajo.

PlataformaSoporteNotas
iOSSíNativo
AndroidSíNativo
WebNoProtege con Capacitor.getPlatform()
  • 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.
MétodoDescripción
addNetworkMuestra 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.
connectConecta 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.
disconnectDesconecta la red Wi-Fi actual. En iOS, solo desconecta las redes que se añadieron mediante este plugin.
getAvailableNetworksObtén una lista de las redes Wi-Fi disponibles del último escaneo. Solo disponible en Android.
getIpAddressObtén la dirección IP actual del dispositivo. Disponible tanto en Android como en iOS.
getRssiObtén el indicador de intensidad de señal recibida (RSSI) de la red actual en dBm. Solo disponible en Android.
getSsidObtén el identificador de conjunto de servicios (SSID) de la red actual. Disponible tanto en Android como en iOS.
getWifiInfoObté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.
isEnabledComprueba si el Wi-Fi está activado en el dispositivo. Solo disponible en Android.
startScanComienza 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.
checkPermissionsComprueba el estado actual de los permisos de ubicación. Se requiere permiso de ubicación para las operaciones de Wi-Fi en ambas plataformas.
requestPermissionsSolicita permisos de ubicación al usuario. Se requiere permiso de ubicación para las operaciones de Wi-Fi en ambas plataformas.
addListenerAñ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.
removeAllListenersElimina todos los listeners de este plugin.
getPluginVersionObtén la versión del plugin nativo.

Esta referencia se sincroniza desde src/definitions.ts en 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.