connect

连接指定的wifi。如果要连接的wifi是已配置过的(已保存有密码且密码正确，getConfiguredNetworks方法可获取)，则只需传入ssid，不需传入pwd和capabilities；如果要连接的wifi是没配置过的无密码保护类型的wifi，则只需传入ssid和capabilities，不需传入pwd。

connect({params},callback(ret))

param

ssid:

• 类型：字符串
• 描述：(必选)wifi的ssid(wifi名字)

pwd:

• 类型：字符串
• 描述：wifi密码。如果要连接的wifi是已配置过的(已保存有密码且密码正确)，或者是无密码的wifi，则该参数可不传，反之则要传入该参数

capabilities:

• 类型：字符串

• 描述：密码保护类型；需要与要连接的wifi保护类型一致，如果要连接的wifi是已配置过的(已保存有密码且密码正确)，则该参数可不传，反之则要传入该参数(没配置过的无密码保护类型的wifi也要传入该参数)。当要传入该参数时，有两种方法获取该参数：

1.第一种方式：

可从上面的scanWifis方法返回的列表中获取。

2.第二种方式：

直接传入密码保护类型(前提是开发者知道wifi的密码保护类型)，传入的密码保护类型要与wifi实际的密码保护类型一致(可通过登录路由器查询)，直接传入的取值范围如下：

1、"NOPASS" (无密码)；

2、"WEP"（wep保护类型）；

3、"WPA" (wpa保护类型) 。

callback(ret)

ret:

• 类型：JSON对象
• 描述：返回连接是否成功
• 内部字段：

{
    "result": 1,   //int类型，是否连接成功 ，取值范围如下：
                   //0    连接失败,5秒内未连接成功则认为连接失败，
                   //      开发者也可以自己判断wifi连接是否成功，方法:使用addNetChangedListener，当网络状态发生变化时使用
                   //     方法getCurWifiInfo获取当前wifi名字判断,若连接不成功，监听到的网络状态为手机流量网络或无网络。
                   //1    连接成功
}

示例代码

var wifi = api.require('wifiMgr');
//param = {ssid:"wifi_love",pwd:"2016102828",capabilities:"WEP"};//未连接过的wifi，直接传入capabilities方式。
//param = {ssid:"wifi_love",pwd:"2016102828",capabilities:"[WPA-PSK-CCMP][WPA2-PSK-CCMP][ESS]"};//未连接过的wifi，从上面的scanWifis方法返回的列表中获取capabilities。
  param = {ssid:"wifi_love"};//已配置过的(已保存有密码且密码正确)
//param = {ssid:"wifi_love",capabilities:"WPA"};//无密码的wifi
wifi.connect(param, function(ret, err){
     alert(JSON.stringify(ret));
     });

补充说明

此接口仅支持Android平台

可用性

Android系统

可提供的1.0.0及更高版本