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，則該參數(shù)可不傳，反之則要傳入該參數(shù)

capabilities:

• 類型：字符串

• 描述：密碼保護類型；需要與要連接的wifi保護類型一致，如果要連接的wifi是已配置過的(已保存有密碼且密碼正確)，則該參數(shù)可不傳，反之則要傳入該參數(shù)(沒配置過的無密碼保護類型的wifi也要傳入該參數(shù))。當要傳入該參數(shù)時，有兩種方法獲取該參數(shù)：

1.第一種方式：

可從上面的scanWifis方法返回的列表中獲取。

2.第二種方式：

直接傳入密碼保護類型(前提是開發(fā)者知道wifi的密碼保護類型)，傳入的密碼保護類型要與wifi實際的密碼保護類型一致(可通過登錄路由器查詢)，直接傳入的取值范圍如下：

1、"NOPASS" (無密碼)；

2、"WEP"（wep保護類型）；

3、"WPA" (wpa保護類型) 。

callback(ret)

ret:

• 類型：JSON對象
• 描述：返回連接是否成功
• 內(nèi)部字段：

{
    "result": 1,   //int類型，是否連接成功 ，取值范圍如下：
                   //0    連接失敗,5秒內(nèi)未連接成功則認為連接失敗，
                   //      開發(fā)者也可以自己判斷wifi連接是否成功，方法:使用addNetChangedListener，當網(wǎng)絡狀態(tài)發(fā)生變化時使用
                   //     方法getCurWifiInfo獲取當前wifi名字判斷,若連接不成功，監(jiān)聽到的網(wǎng)絡狀態(tài)為手機流量網(wǎng)絡或無網(wǎng)絡。
                   //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系統(tǒng)

可提供的1.0.0及更高版本