Saltar al contenido principal

Guía

Tutoriales de WiFi

Probar en dispositivo

Descargar la aplicación Capgo, luego escanea el código QR code.

Enlace QR de vista previa del plugin de WiFi code

Usando @capgo/capacitor-wifi

Plugin de WiFi para gestionar la conectividad WiFi del dispositivo.

Instalar

bun add @capgo/capacitor-wifi
bunx cap sync

¿Qué Exposiciones 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 trafico por defecto a través de la red. Establecer autoRouteTraffic en true para vincular el trafico de la aplicación a la red conectada (útil para APs locales/host de dispositivo). 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 redes que se agregaron a través de este plugin.
  • getAvailableNetworks - Obtener una lista de redes WiFi disponibles desde el último escaneo. Solo disponible en Android.

Uso de Ejemplo

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 de anfitrión local/dispositivo). 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 mediante 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

Siga adelante desde Using @capgo/capacitor-wifi

Si está utilizando Usando @capgo/capacitor-wifi para planificar la consola de dashboard y API operaciones, 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 Resumen para el detalle de implementación en API Resumen, Introducción para el detalle de implementación en Introducción, y API Claves para el detalle de implementación en API Claves.