Saltar al contenido

@capgo/capacitor-wifi

Gestiona la conectividad WiFi de tu app Capacitor

Gestiona la conectividad WiFi de tu app Capacitor

Comienza con addNetwork() y los demás métodos principales detallados 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+, 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.
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 del sistema con la red ya rellenada. En iOS, se conecta directamente a la red.
connectSe 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.
disconnectSe desconecta de la red Wi-Fi actual. En iOS, solo se desconecta de las redes que se añadieron mediante este plugin.
getAvailableNetworksObtiene una lista de redes Wi-Fi disponibles del último escaneo. Solo disponible en Android.
getIpAddressObtiene la dirección IP actual del dispositivo. Disponible en Android y iOS.
getRssiObtiene el indicador de intensidad de la señal recibida (RSSI) de la red actual en dBm. Solo disponible en Android.
getSsidObtiene el identificador de conjunto de servicios (SSID) de la red actual. Disponible en Android y iOS.
getWifiInfoObtiene 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.
isEnabledComprueba si el Wi-Fi está activado en el dispositivo. Solo disponible en Android.
startScanComienza 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.
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 de 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 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.