wifiConfig

概述

本插件封装了iOS原生应用内进行wifi连接的功能,多应用于物联网设备配网连接热点的场景。仅支持iOS11.0以上的系统。

配置证书 在 iOS 平台上使用本功能,证书须勾选 Hotspot 功能。

配置 entitlement 文件

iOS 上使用本插件前,需要先配置一个 entitlement 文件。配置方法参考论坛帖子:https://community.apicloud.com/bbs/forum.php?mod=viewthread&tid=47691

配送参数如下:

  <key>Hotspot Configuration</key>
  <true/>

插件接口

connectWifi

连接wifi

connectWifi({params}, callback(ret, err))

params

ssid:

  • 类型:字符串
  • 描述:要连接的wifi名称

passphrase:

  • 类型:字符串
  • 描述:要连接的wifi密码

isWEP:

  • 类型:整型
  • 描述:wifi加密方式,1表示WEP方式,0表示WPA/WPA2方式

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    code: 0   //数字类型;
              //错误码:
              //0(连接成功或失败)
              //1(已连接该wifi)
              //2(发生错误)
}

示例代码

var wifiConfig = api.require('wifiConfig');
wifiConfig.connectWifi({
    ssid: 'SunshineBigBoy',
    passphrase: 'app123456',
    isWEP: 0
},function(ret, err){
    api.toast({
        msg: ret.code,
        location: 'middle'
    });
});

可用性

iOS系统

可提供的1.0.0及更高版本

removeWifi

移除连接过的wifi

removeWifi({params}, callback(ret, err))

params

ssid:

  • 类型:字符串
  • 描述:要移除的wifi名称

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    code: 0   //数字类型;
              //错误码:
              //0(移除成功)
              //1(移除失败)
}

示例代码

var wifiConfig = api.require('wifiConfig');
demo.removeWifi({
    ssid: 'SunshineBigBoy'
},function(ret, err){
    api.toast({
        msg: ret.code,
        location: 'middle'
    });
});

可用性

iOS系统

可提供的1.0.0及更高版本

getConfiguredWifis

获取连接过的wifi列表

getConfiguredWifis({params}, callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    configuredWifis: []   //wifi列表
}

示例代码

var wifiConfig = api.require('wifiConfig');
demo.getConfiguredWifis({
   
},function(ret, err){
    api.toast({
        msg: ret.configuredWifis.length,
        location: 'middle'
    });
});

可用性

iOS系统

可提供的1.0.0及更高版本

是否仍需要帮助? 请保持联络!
最后更新于 2024/02/29