wifiConfig

connectWifi removeWifi getConfiguredWifis

概述

本模块封装了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及更高版本