connect

2022-06-21 14:32 更新

连接指定的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及更高版本

以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号