@falconeta/电容-wifi-连接

你喜欢插件吗?

如果你愿意或愿意贡献, 随便给我买杯咖啡吧! 我将感激一切, 即使它是咖啡 或者只是对我的作品的善意评论, 因为这对我很有帮助.

说明

用于连接设备 trhought Wifi 的插件, 以及前缀

安装

npm install @falconeta/capacitor-wifi-connect
npx cap sync

示例用途

import { CapacitorWifiConnect } from "@falconeta/capacitor-wifi-connect";

  async secureConnect() {
    let { value } = await CapacitorWifiConnect.checkPermission();
    if (value === 'prompt') {
      const data = await CapacitorWifiConnect.requestPermission();
      value = data.value;
    }
    if (value === 'granted') {
      CapacitorWifiConnect.secureConnect({
        ssid: 'SSID',
        password: 'PWD',
      }).then((data) => alert(data.value));
    } else {
      throw new Error('permission denied');
    }
  }

iOS 函数

对于功能,您需要注意以下内容:

• 连接/ 断接只为 iOS11+ 工作

• 前缀Connect/securePrefixConnect 只为iOS13+工作

• 无法在模拟器中运行, 因此在使用 xCode 构建时需要附加一个实际设备

• 将确保您在 XCode 工程中添加“ Hotspot 配置” 和“ Wifi Information ” 功能

• 将确保这些许可在信息中描述。 列表

  <key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
  <string>...</string>
  <key>NSLocationAlwaysUsageDescription</key>
  <string>...</string>
  <key>NSLocationWhenInUseUsageDescription</key>
  <string>...</string>

API 密码

• checkPermission()
• requestPermission()
• disconnect()
• getSSIDs()
• getAppSSID()
• getDeviceSSID()
• connect(...)
• prefixConnect(...)
• secureConnect(...)
• securePrefixConnect(...)
• 类型异名
• 数字

检查

checkPermission() => Promise<{ value: PermissionState; }>

用于检查应用程序是否具有自动化或不使用定位能力的方法.

回返情况: Promise<{ value: PermissionState; }>

自: 1.0.0 (单位:千美元)

请求( )

requestPermission() => Promise<{ value: PermissionState; }>

(如果授权状况迅速)使用定位能力的自动化方法.

回返情况: Promise<{ value: PermissionState; }>

自: 1.0.0 (单位:千美元)

断开( )

disconnect() => Promise<{ value: boolean; }>

如果网络被连接到使用一种连接方法,则断开wifi网络的方法.

回返情况: Promise<{ value: boolean; }>

自: 1.0.0 (单位:千美元)

获取SSIDs ()

getSSIDs() => Promise<{ value: string[]; status: ConnectState; }>

只有安德鲁德 返回应用程序连接的当前 SSID 警告:应用限制为每2分钟4次扫描

回返情况: Promise<{ value: string[]; status: ConnectState; }>

自: 5.1.0 国家

获取 AppSSID ()

getAppSSID() => Promise<{ value: string; status: ConnectState; }>

返回应用程序连接的当前 SSID

回返情况: Promise<{ value: string; status: ConnectState; }>

自: 5.1.0 国家

获取DEViceSSID ()

getDeviceSSID() => Promise<{ value: string; status: ConnectState; }>

iOS QQ 14,Android QQ9: roid

返回设备连接的当前 SSID

回返情况: Promise<{ value: string; status: ConnectState; }>

自: 5.1.0 国家

连接(...)

connect(options: { ssid: string; saveNetwork?: boolean; }) => Promise<{ value: ConnectState; }>

方法试图连接到明确匹配 ssid 参数的wifi 警告(Warning):默认情况下在iOS上启用了已保存的Network,无法禁用由于苹果的bug. ()https://forums.developer.apple.com/forums/thread/700612 互联网档案馆的存檔,存档日期2014-12-22(中文(简体) )

回返情况: Promise<{ value: ConnectState; }>

自: 1.0.0 (单位:千美元)

前缀 Connect (...)

prefixConnect(options: { ssid: string; saveNetwork?: boolean; }) => Promise<{ value: ConnectState; }>

方法尝试与最近的wifi网络连接,与 ssidPrefix 参数相匹配. 警告(Warning):默认情况下在iOS上启用了已保存的Network,无法禁用由于苹果的bug. ()https://forums.developer.apple.com/forums/thread/700612 互联网档案馆的存檔,存档日期2014-12-22(中文(简体) )

回返情况: Promise<{ value: ConnectState; }>

自: 1.0.0 (单位:千美元)

安全连接(...)

secureConnect(options: { ssid: string; password: string; saveNetwork?: boolean; isWep?: boolean; }) => Promise<{ value: ConnectState; }>

方法试图连接到明确匹配 ssid 参数的wifi. 如果密码不匹配, 或 IsWep 参数设置不正确, 这将失败 . Android不支持WEP网络. 警告(Warning):默认情况下在iOS上启用了已保存的Network,无法禁用由于苹果的bug. ()https://forums.developer.apple.com/forums/thread/700612 互联网档案馆的存檔,存档日期2014-12-22(中文(简体) )

回返情况: Promise<{ value: ConnectState; }>

自: 1.0.0 (单位:千美元)

安全前缀Connect(...)

securePrefixConnect(options: { ssid: string; password: string; saveNetwork?: boolean; isWep?: boolean; }) => Promise<{ value: ConnectState; }>

方法尝试连接到最近的 与 ssidPrefix 参数相匹配的 ssid 前缀的wifi 网络. 如果密码不匹配, 或为Wep 参数, 此选项将失败 设置不正确。 Android不支持WEP网络. 警告(Warning):默认情况下在iOS上启用了已保存的Network,无法禁用由于苹果的bug. ()https://forums.developer.apple.com/forums/thread/700612 互联网档案馆的存檔,存档日期2014-12-22(中文(简体) )

回返情况: Promise<{ value: ConnectState; }>

自: 1.0.0 (单位:千美元)

类型异名

权限状态

'prompt' | 'prompt-with-rationale' | 'granted' | 'denied'

数字

连接国