connect

連接指定的wifi。如果要連接的wifi是已配置過的(已保存有密碼且密碼正確，getConfiguredNetworks方法可獲取)，則只需傳入ssid，不需傳入pwd和capabilities；如果要連接的wifi是沒配置過的無密碼保護(hù)類型的wifi，則只需傳入ssid和capabilities，不需傳入pwd。

connect({params},callback(ret))

param

ssid:

• 類型：字符串
• 描述：(必選)wifi的ssid(wifi名字)

pwd:

• 類型：字符串
• 描述：wifi密碼。如果要連接的wifi是已配置過的(已保存有密碼且密碼正確)，或者是無密碼的wifi，則該參數(shù)可不傳，反之則要傳入該參數(shù)

capabilities:

• 類型：字符串

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

1.第一種方式：

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

2.第二種方式：

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

1、"NOPASS" (無密碼)；

2、"WEP"（wep保護(hù)類型）；

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

callback(ret)

ret:

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

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

補(bǔ)充說明

此接口僅支持Android平臺(tái)

可用性

Android系統(tǒng)

可提供的1.0.0及更高版本