跳过主内容
返回插件
@capgo/capacitor-wifi
教程
@capgo/capacitor-wifi

WiFi

管理您的Capacitor应用的WiFi连接

指南

WiFi教程

在设备上测试

下载Capgo应用程序,然后扫描QRcode。

WiFi插件预览二维码code

使用@capgo/capacitor-wifi

管理设备WiFi连接的WiFi插件。

安装

bun add @capgo/capacitor-wifi
bunx cap sync

此插件暴露的内容

  • addNetwork - 在设备上显示一个系统对话框,添加一个Wi-Fi网络。 在Android SDK 30+上,这会打开系统Wi-Fi设置,网络预填充。 在iOS上,这会直接连接到网络。
  • connect - 连接到Wi-Fi网络。 在Android上,这会创建一个临时连接,除非设置autoRouteTraffic为true,否则不会将流量绑定到连接的网络(适用于本地/设备托管AP)。 在Android上,使用addNetwork()创建一个持久连接。 在iOS上,这会创建一个持久连接。
  • disconnect - 从当前Wi-Fi网络断开连接。 在iOS上,只断开了通过此插件添加的网络。
  • getAvailableNetworks - 获取上一次扫描后可用的Wi-Fi网络列表。 只在Android上可用。

示例使用

addNetwork

在设备上显示一个系统对话框,添加一个Wi-Fi网络。 在Android SDK 30+上,这会打开系统Wi-Fi设置,网络预填充。 在iOS上,这会直接连接到网络。

import { CapacitorWifi } from '@capgo/capacitor-wifi';

await CapacitorWifi.addNetwork({
  ssid: 'MyNetwork',
  password: 'mypassword',
  isHiddenSsid: false,
  securityType: NetworkSecurityType.WPA2_PSK
});

connect

连接到 Wi-Fi 网络。 在 Android 上,这会创建一个临时连接,除非设置了 autoRouteTraffic 为 true,否则不会将流量路由到网络中。 如果要绑定应用程序流量到连接的网络(适用于本地/设备托管 AP),请设置 autoRouteTraffic 为 true。 在 Android 上,使用 addNetwork() 代替可以创建持久连接。 在 iOS 上,这会创建一个持久连接。

import { CapacitorWifi } from '@capgo/capacitor-wifi';

await CapacitorWifi.connect({
  ssid: 'MyNetwork',
  password: 'mypassword',
  autoRouteTraffic: true // Android only: route app traffic through this network
});

disconnect

断开当前 Wi-Fi 网络。 在 iOS 上,只断开通过此插件添加的网络。

import { CapacitorWifi } from '@capgo/capacitor-wifi';

await CapacitorWifi.disconnect();

getAvailableNetworks

获取上一次扫描中可用的 Wi-Fi 网络列表。 只在 Android 上可用。

import { CapacitorWifi } from '@capgo/capacitor-wifi';

const { networks } = await CapacitorWifi.getAvailableNetworks();
networks.forEach(network => {
  console.log(`SSID: ${network.ssid}, Signal: ${network.rssi} dBm`);
});

完整参考

继续使用 @capgo/capacitor-wifi

如果您正在使用 使用 @capgo/capacitor-wifi 规划仪表板和 API 操作时,请将其连接到 @capgo/capacitor-wifi 对于 @capgo/capacitor-wifi 的实现细节 开始使用 对于开始使用的实现细节 API 介绍 对于API 介绍的实现细节 __CAPGO_KEEP_0__ 简介 对于__CAPGO_KEEP_0__ 简介的实现细节 API Keys 为您的 API 应用提供动力