跳过内容
Capgo - 实时更新 Capacitor 应用程序 Capgo

开始

GitHub

安装

标题为“安装”的部分

您可以使用我们的AI辅助设置来安装插件。使用以下命令将Capgo技能添加到您的AI工具中：

终端窗口
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

然后使用以下提示：

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-wifi` plugin in my project.

如果您更喜欢手动设置，请按照以下命令安装插件并遵循以下平台特定的说明：

终端窗口
bun add @capgo/capacitor-wifi
bunx cap sync

导入

导入部分
import { CapacitorWifi } from '@capgo/capacitor-wifi';

API概述

API概述部分

addNetwork

添加网络

Show a system dialog to add a Wi-Fi network to the device. On Android SDK 30+, this opens the system Wi-Fi settings with the network pre-filled. On iOS, this connects to the network directly.

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，绑定应用流量到已连接的网络（适用于本地/设备托管APs）。 在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`);
});

getIpAddress

Section titled “getIpAddress”

获取设备当前的IP地址。 可在Android和iOS上使用。

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


const { ipAddress } = await CapacitorWifi.getIpAddress();
console.log('IP Address:', ipAddress);

getRssi

Section titled “getRssi”

获取当前网络的接收信号强度指标（RSSI）值。 仅在Android上可用。

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


const { rssi } = await CapacitorWifi.getRssi();
console.log('Signal strength:', rssi, 'dBm');

getSsid

Section titled “getSsid”

获取当前网络的服务集标识符（SSID）。 可在Android和iOS上使用。

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


const { ssid } = await CapacitorWifi.getSsid();
console.log('Connected to:', ssid);

getWifiInfo

Section titled “getWifiInfo”

获取当前连接的Wi-Fi网络的详细信息。 本方法提供了网络信息，包括SSID、BSSID、IP地址、频率、链路速度和信号强度。 在iOS上，某些字段可能不可用，会返回undefined。

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


const info = await CapacitorWifi.getWifiInfo();
console.log('Network:', info.ssid);
console.log('BSSID:', info.bssid);
console.log('IP:', info.ip);
console.log('Frequency:', info.frequency, 'MHz');
console.log('Speed:', info.linkSpeed, 'Mbps');
console.log('Signal:', info.signalStrength);

isEnabled

Section titled “isEnabled”

检查设备上的 Wi-Fi 是否已启用。 仅在 Android 上可用。

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


const { enabled } = await CapacitorWifi.isEnabled();
console.log('WiFi is', enabled ? 'enabled' : 'disabled');

startScan

Section titled “startScan”

开始扫描附近的 Wi-Fi 网络。 仅在 Android 上可用。 结果将通过 ‘networksScanned’ 事件监听器传递。 注意：可能由于系统限制或硬件问题而失败。

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


await CapacitorWifi.addListener('networksScanned', () => {
  console.log('Scan completed');
});
await CapacitorWifi.startScan();

checkPermissions

Section titled “checkPermissions”

检查设备当前的位置访问权限。 位置权限对于 Android 和 iOS 平台上的 Wi-Fi 操作都是必需的。

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


const status = await CapacitorWifi.checkPermissions();
console.log('Location permission:', status.location);

requestPermissions

Section titled “requestPermissions”

向用户请求位置权限。 位置权限对于 Android 和 iOS 平台上的 Wi-Fi 操作都是必需的。

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


const status = await CapacitorWifi.requestPermissions();
if (status.location === 'granted') {
  console.log('Permission granted');
}

类型参考

类型参考

AddNetworkOptions

网络添加选项

添加网络选项

export interface AddNetworkOptions {
  /**
   * The SSID of the network to add
   *
   * @since 7.0.0
   */
  ssid: string;


  /**
   * The password for the network (optional for open networks)
   *
   * @since 7.0.0
   */
  password?: string;


  /**
   * Whether the network is hidden (Android only)
   *
   * @since 7.0.0
   * @default false
   */
  isHiddenSsid?: boolean;


  /**
   * The security type of the network (Android only)
   *
   * @since 7.0.0
   * @default NetworkSecurityType.WPA2_PSK
   */
  securityType?: NetworkSecurityType;
}

ConnectOptions

连接网络选项

连接网络选项

export interface ConnectOptions {
  /**
   * The SSID of the network to connect to
   *
   * @since 7.0.0
   */
  ssid: string;


  /**
   * The password for the network (optional for open networks)
   *
   * @since 7.0.0
   */
  password?: string;


  /**
   * Whether the network is hidden (Android only)
   *
   * @since 7.0.0
   * @default false
   */
  isHiddenSsid?: boolean;


  /**
   * Whether to automatically route app traffic through the connected Wi-Fi network (Android only)
   * When enabled, it binds the app process to the connected network using ConnectivityManager.bindProcessToNetwork()
   * This is useful for connecting to local/device-hosted APs (e.g., ESP32, IoT devices) that don't have internet access.
   *
   * @since 7.0.0
   * @default false
   */
  autoRouteTraffic?: boolean;
}

DisconnectOptions

断开网络选项

断开网络选项

export interface DisconnectOptions {
  /**
   * The SSID of the network to disconnect from (optional)
   *
   * @since 7.0.0
   */
  ssid?: string;
}

GetAvailableNetworksResult

获取可用网络结果

getAvailableNetworks() 的结果。

export interface GetAvailableNetworksResult {
  /**
   * List of available networks
   *
   * @since 7.0.0
   */
  networks: Network[];
}

GetIpAddressResult

标题：获取 IP 地址结果

getIpAddress() 的结果。

export interface GetIpAddressResult {
  /**
   * The device's IP address
   *
   * @since 7.0.0
   */
  ipAddress: string;
}

GetRssiResult

标题：获取 RSSI 结果

getRssi() 的结果。

export interface GetRssiResult {
  /**
   * The signal strength in dBm
   *
   * @since 7.0.0
   */
  rssi: number;
}

GetSsidResult

标题：获取 SSID 结果

getSsid() 的结果。

export interface GetSsidResult {
  /**
   * The SSID of the current network
   *
   * @since 7.0.0
   */
  ssid: string;
}

WifiInfo

标题：Wi-Fi 信息

__CAPGO_KEEP_0__

export interface WifiInfo {
  /**
   * The SSID (network name) of the current network
   *
   * @since 7.0.0
   */
  ssid: string;


  /**
   * The BSSID (MAC address) of the access point.
   * Not available on iOS.
   *
   * @since 7.0.0
   */
  bssid?: string;


  /**
   * The device's IP address on the network
   *
   * @since 7.0.0
   */
  ip: string;


  /**
   * The network frequency in MHz.
   * Not available on iOS.
   *
   * @since 7.0.0
   */
  frequency?: number;


  /**
   * The connection speed in Mbps.
   * Not available on iOS.
   *
   * @since 7.0.0
   */
  linkSpeed?: number;


  /**
   * The signal strength (0-100).
   * Calculated from RSSI on Android.
   * Not available on iOS.
   *
   * @since 7.0.0
   */
  signalStrength?: number;
}

IsEnabledResult

《IsEnabledResult》

isEnabled() 的结果

export interface IsEnabledResult {
  /**
   * Whether Wi-Fi is enabled
   *
   * @since 7.0.0
   */
  enabled: boolean;
}

PermissionStatus

《PermissionStatus》

权限状态

export interface PermissionStatus {
  /**
   * Location permission state
   *
   * @since 7.0.0
   */
  location: PermissionState;
}

RequestPermissionsOptions

《RequestPermissionsOptions》

请求权限的选项

export interface RequestPermissionsOptions {
  /**
   * Permissions to request
   *
   * @since 7.0.0
   */
  permissions?: 'location'[];
}

NetworkSecurityType

《NetworkSecurityType》

网络安全类型。

export enum NetworkSecurityType {
  /**
   * Open network with no security
   *
   * @since 7.0.0
   */
  OPEN = 0,


  /**
   * WEP security
   *
   * @since 7.0.0
   */
  WEP = 1,


  /**
   * WPA/WPA2 Personal (PSK)
   *
   * @since 7.0.0
   */
  WPA2_PSK = 2,


  /**
   * WPA/WPA2/WPA3 Enterprise (EAP)
   *
   * @since 7.0.0
   */
  EAP = 3,


  /**
   * WPA3 Personal (SAE)
   *
   * @since 7.0.0
   */
  SAE = 4,


  /**
   * WPA3 Enterprise
   *
   * @since 7.0.0
   */
  WPA3_ENTERPRISE = 5,


  /**
   * WPA3 Enterprise 192-bit mode
   *
   * @since 7.0.0
   */
  WPA3_ENTERPRISE_192_BIT = 6,


  /**
   * Passpoint network
   *
   * @since 7.0.0
   */
  PASSPOINT = 7,


  /**
   * Enhanced Open (OWE)
   *
   * @since 7.0.0
   */
  OWE = 8,


  /**
   * WAPI PSK
   *
   * @since 7.0.0
   */
  WAPI_PSK = 9,


  /**
   * WAPI Certificate
   *
   * @since 7.0.0
   */
  WAPI_CERT = 10,
}

真实数据来源

真实数据来源

该页面是从插件生成的。 src/definitions.ts当公共 API 上游更改时，请重新运行同步。

从 Getting Started 继续

从 Getting Started 继续

如果您正在使用 Getting Started 来规划仪表板和 API 操作，请将其连接到 使用 @capgo/capacitor-wifi 为使用 @capgo/capacitor-wifi 的原生能力 API 概述 为 API 概述 的实现细节 介绍 为介绍 的实现细节 API 密钥 为 API 密钥 的实现细节, 和 设备 为设备 的实现细节。