connectWifi

来自于:开发者立即使用

getMacAddress getIpAddress getBssid getFrequency getHiddenSsid getLinkSpeed getNetworkId getRssi getSsid getSupplicantState

概述

connectWifi模块封装了安卓手机获取当前连接wifi相关信息功能,使用此模块可实现对安卓手机当前连接wifi的mac地址、ip地址、Ssid等相关信息获取。暂仅支持 android 平台。(当连接wifi时,获取的是wifi网络ip地址,数据流量是获取的是手机本地的ip地址)

getMacAddress

得到mac地址

getMacAddress(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. macAddress: //mac地址
  3. }

示例代码

  1. var connectWifi= api.require('connectWifi');
  2. connectWifi.getMacAddress(function (ret, err) {
  3. if (ret) {
  4. console.log(JSON.stringify(ret));
  5. alert("macAddress=" + ret.macAddress);
  6. } else {
  7. console.log(JSON.stringify(err));
  8. alert('错误:' + JSON.stringify(err.msg));
  9. }
  10. });

补充说明

返回的数据是mac地址。

可用性

Android系统

可提供的1.0.0及更高版本

getIpAddress

得到ip地址

getIpAddress(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. ipAddress: //ip地址
  3. }

示例代码

  1. var connectWifi= api.require('connectWifi');
  2. connectWifi.getIpAddress(function (ret, err) {
  3. if (ret) {
  4. console.log(JSON.stringify(ret));
  5. alert("ipAddress=" + ret.ipAddress);
  6. } else {
  7. console.log(JSON.stringify(err));
  8. alert('错误:' + JSON.stringify(err.msg));
  9. }
  10. });

补充说明

返回的数据是ip地址。

可用性

Android系统

可提供的1.0.0及更高版本

getBssid

得到BSSID的值

getBssid(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. BSSID: //基本服务集标识符
  3. }

示例代码

  1. var connectWifi= api.require('connectWifi');
  2. connectWifi.getBssid(function (ret, err) {
  3. if (ret) {
  4. console.log(JSON.stringify(ret));
  5. alert("BSSID=" + ret.BSSID);
  6. } else {
  7. console.log(JSON.stringify(err));
  8. alert('错误:' + JSON.stringify(err.msg));
  9. }
  10. });

补充说明

返回数据是BSSID的值。

可用性

Android系统

可提供的1.0.0及更高版本

getFrequency

得到频率

getFrequency(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. frequency: //频率
  3. }

示例代码

  1. var connectWifi= api.require('connectWifi');
  2. connectWifi.getFrequency(function (ret, err) {
  3. if (ret) {
  4. console.log(JSON.stringify(ret));
  5. alert("frequency=" + ret.frequency);
  6. } else {
  7. console.log(JSON.stringify(err));
  8. alert('错误:' + JSON.stringify(err.msg));
  9. }
  10. });

补充说明

返回的数据是频率。

可用性

Android系统

可提供的1.0.0及更高版本

getHiddenSsid

得到hiddenSSID的值

getHiddenSsid(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. hiddenSSID: //是否有SSID(true/false)
  3. }

示例代码

  1. var connectWifi= api.require('connectWifi');
  2. connectWifi.getHiddenSsid(function (ret, err) {
  3. if (ret) {
  4. console.log(JSON.stringify(ret));
  5. alert("hiddenSSID=" + ret.hiddenSSID);
  6. } else {
  7. console.log(JSON.stringify(err));
  8. alert('错误:' + JSON.stringify(err.msg));
  9. }
  10. });

补充说明

返回的数据是hiddenSSID的值。

可用性

Android系统

可提供的1.0.0及更高版本

getLinkSpeed

得到链接速度

getLinkSpeed(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. linkSpeed: //链接速度
  3. }

示例代码

  1. var connectWifi= api.require('connectWifi');
  2. connectWifi.getLinkSpeed(function (ret, err) {
  3. if (ret) {
  4. console.log(JSON.stringify(ret));
  5. alert("linkSpeed=" + ret.linkSpeed);
  6. } else {
  7. console.log(JSON.stringify(err));
  8. alert('错误:' + JSON.stringify(err.msg));
  9. }
  10. });

补充说明

返回的数据是链接速度。

可用性

Android系统

可提供的1.0.0及更高版本

getNetworkId

得到网络ID

getNetworkId(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. networkId: //网络的ID
  3. }

示例代码

  1. var connectWifi= api.require('connectWifi');
  2. connectWifi.getNetworkId(function (ret, err) {
  3. if (ret) {
  4. console.log(JSON.stringify(ret));
  5. alert("networkId=" + ret.networkId);
  6. } else {
  7. console.log(JSON.stringify(err));
  8. alert('错误:' + JSON.stringify(err.msg));
  9. }
  10. });

补充说明

返回的数据是网络ID。

可用性

Android系统

可提供的1.0.0及更高版本

getRssi

得到网络的接收信号强度

getRssi(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. Rssi: //网络的接收信号强度
  3. }

示例代码

  1. var connectWifi= api.require('connectWifi');
  2. connectWifi.getRssi(function (ret, err) {
  3. if (ret) {
  4. console.log(JSON.stringify(ret));
  5. alert("Rssi=" + ret.Rssi);
  6. } else {
  7. console.log(JSON.stringify(err));
  8. alert('错误:' + JSON.stringify(err.msg));
  9. }
  10. });

补充说明

返回的数据是网络的接收信号强度(单位为dBm)。

可用性

Android系统

可提供的1.0.0及更高版本

getSsid

得到网络的服务集标识符

getSsid(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. SSID: //网络的服务集标识符
  3. }

示例代码

  1. var connectWifi= api.require('connectWifi');
  2. connectWifi.getSsid(function (ret, err) {
  3. if (ret) {
  4. console.log(JSON.stringify(ret));
  5. alert("SSID=" + ret.SSID);
  6. } else {
  7. console.log(JSON.stringify(err));
  8. alert('错误:' + JSON.stringify(err.msg));
  9. }
  10. });

补充说明

返回的数据是网络的服务集标识符。

可用性

Android系统

可提供的1.0.0及更高版本

getSupplicantState

得到请求者与接入点协商的详细状态

getSupplicantState(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. supplicantState: //请求者与接入点协商的详细状态
  3. }

示例代码

  1. var connectWifi= api.require('connectWifi');
  2. connectWifi.getSupplicantState(function (ret, err) {
  3. if (ret) {
  4. console.log(JSON.stringify(ret));
  5. alert("supplicantState=" + ret.supplicantState);
  6. } else {
  7. console.log(JSON.stringify(err));
  8. alert('错误:' + JSON.stringify(err.msg));
  9. }
  10. });

补充说明

返回的数据是请求者与接入点协商的详细状态。

可用性

Android系统

可提供的1.0.0及更高版本