Saltar al contenido principal

Guía

Tutoriales de WiFi

Probar en dispositivo

Descargue la aplicación Capgo, luego escane 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 Wi-Fi al dispositivo. En Android SDK 30+, esto abre la configuración de Wi-Fi del sistema con la red prellenada. En iOS, esto conecta directamente a la red.
  • connect - Conectar 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 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 Wi-Fi actual. En iOS, solo desconecta de las redes que se agregaron a través de este plugin.
  • getAvailableNetworks - Obtener una lista de redes Wi-Fi disponibles desde la última escaneo. Solo disponible en Android.

Uso de Ejemplo

addNetwork

Mostrar un diálogo del sistema para agregar 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, 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

Siga adelante desde Usando @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.