codecamp

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及更高版本

getConfiguredNetworks
disConnect
温馨提示
下载编程狮App,免费阅读超1000+编程语言教程
取消
确定
目录

端API

设备访问

ipAddress

wifiSSID

smartConfigCheyw

无标题文章

前端框架

云API

开发工具

关闭

MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }