Guía
Tutorial de WiFi
Usando @capgo/capacitor-wifi
Plugin de WiFi para la gestión de la conectividad WiFi del dispositivo.
Instalar
bun add @capgo/capacitor-wifi
bunx cap sync
¿Qué se expone con este plugin?
addNetwork- Mostrar un diálogo del sistema para agregar una red WiFi al dispositivo. En Android SDK 30+, esto abre la configuración de WiFi del sistema con la red prellenada. En iOS, esto conecta directamente a la red.connect- Conectar a una red WiFi. En Android, esto crea una conexión temporal que no envía el tráfico por defecto a través de la red. Establezca autoRouteTraffic en true para vincular el tráfico de la aplicación a la red conectada (útil para APs locales/host de dispositivos). Para una conexión persistente en Android, utilice addNetwork() en su lugar. En iOS, esto crea una conexión persistente.disconnect- Desconectar de la red WiFi actual. En iOS, solo desconecta de las redes que se agregaron a través de este plugin.getAvailableNetworks- Obtener una lista de redes WiFi disponibles desde la última escaneo. Solo disponible en Android.
Ejemplo de uso
addNetwork
Mostrar un diálogo del sistema para agregar una red WiFi al dispositivo. En Android SDK 30+, esto abre la configuración de WiFi 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
Conéctese 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 hospedados localmente o 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
Desconéctese de la red Wi-Fi actual. En iOS, solo desconecta de las 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 Using @capgo/capacitor-wifi
Si está utilizando Usando @capgo/capacitor-wifi para planificar la consola y las operaciones de API, conecte con @capgo/capacitor-wifi para el detalle de implementación en @capgo/capacitor-wifi, Inicio para el detalle de implementación en Inicio, API Vista general para el detalle de implementación en API Vista general, Introducción para el detalle de implementación en Introducción, y API Claves para el detalle de implementación en API Claves.