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 对象

内部字段：

{
    macAddress:    //mac地址
}

示例代码

var connectWifi=  api.require('connectWifi');
connectWifi.getMacAddress(function (ret, err) {
    if (ret) {
        console.log(JSON.stringify(ret));
        alert("macAddress=" + ret.macAddress);
    } else {
        console.log(JSON.stringify(err));
        alert('错误:' + JSON.stringify(err.msg));
    }
});

补充说明

返回的数据是mac地址。

可用性

Android系统

可提供的1.0.0及更高版本

getIpAddress

得到ip地址

getIpAddress(callback(ret, err))

callback(ret, err)

ret：

  • 类型：JSON 对象

内部字段：

{
    ipAddress:    //ip地址
}

示例代码

var connectWifi= api.require('connectWifi');
connectWifi.getIpAddress(function (ret, err) {
    if (ret) {
        console.log(JSON.stringify(ret));
        alert("ipAddress=" + ret.ipAddress);
    } else {
        console.log(JSON.stringify(err));
        alert('错误:' + JSON.stringify(err.msg));
    }
});

补充说明

返回的数据是ip地址。

可用性

Android系统

可提供的1.0.0及更高版本

getBssid

得到BSSID的值

getBssid(callback(ret, err))

callback(ret, err)

ret：

  • 类型：JSON 对象

内部字段：

{
    BSSID:    //基本服务集标识符
}

示例代码

var connectWifi= api.require('connectWifi');
connectWifi.getBssid(function (ret, err) {
    if (ret) {
        console.log(JSON.stringify(ret));
        alert("BSSID=" + ret.BSSID);
    } else {
        console.log(JSON.stringify(err));
        alert('错误:' + JSON.stringify(err.msg));
    }
});

补充说明

返回数据是BSSID的值。

可用性

Android系统

可提供的1.0.0及更高版本

getFrequency

得到频率

getFrequency(callback(ret, err))

callback(ret, err)

ret：

  • 类型：JSON 对象

内部字段：


{
    frequency:     //频率

}

示例代码

var connectWifi= api.require('connectWifi');
connectWifi.getFrequency(function (ret, err) {
    if (ret) {
        console.log(JSON.stringify(ret));
        alert("frequency=" + ret.frequency);
    } else {
        console.log(JSON.stringify(err));
        alert('错误:' + JSON.stringify(err.msg));
    }
});

补充说明

返回的数据是频率。

可用性

Android系统

可提供的1.0.0及更高版本

getHiddenSsid

得到hiddenSSID的值

getHiddenSsid(callback(ret, err))

callback(ret, err)

ret：

  • 类型：JSON 对象

内部字段：


{
    hiddenSSID:     //是否有SSID（true/false）

}

示例代码

var connectWifi= api.require('connectWifi');
connectWifi.getHiddenSsid(function (ret, err) {
    if (ret) {
        console.log(JSON.stringify(ret));
        alert("hiddenSSID=" + ret.hiddenSSID);
    } else {
        console.log(JSON.stringify(err));
        alert('错误:' + JSON.stringify(err.msg));
    }
});

补充说明

返回的数据是hiddenSSID的值。

可用性

Android系统

可提供的1.0.0及更高版本

getLinkSpeed

得到链接速度

getLinkSpeed(callback(ret, err))

callback(ret, err)

ret：

  • 类型：JSON 对象

内部字段：


{
    linkSpeed:     //链接速度

}

示例代码

var connectWifi= api.require('connectWifi');
connectWifi.getLinkSpeed(function (ret, err) {
    if (ret) {
        console.log(JSON.stringify(ret));
        alert("linkSpeed=" + ret.linkSpeed);
    } else {
        console.log(JSON.stringify(err));
        alert('错误:' + JSON.stringify(err.msg));
    }
});

补充说明

返回的数据是链接速度。

可用性

Android系统

可提供的1.0.0及更高版本

getNetworkId

得到网络ID

getNetworkId(callback(ret, err))

callback(ret, err)

ret：

  • 类型：JSON 对象

内部字段：


{
    networkId:     //网络的ID

}

示例代码

var connectWifi= api.require('connectWifi');
connectWifi.getNetworkId(function (ret, err) {
    if (ret) {
        console.log(JSON.stringify(ret));
        alert("networkId=" + ret.networkId);
    } else {
        console.log(JSON.stringify(err));
        alert('错误:' + JSON.stringify(err.msg));
    }
});

补充说明

返回的数据是网络ID。

可用性

Android系统

可提供的1.0.0及更高版本

getRssi

得到网络的接收信号强度

getRssi(callback(ret, err))

callback(ret, err)

ret：

  • 类型：JSON 对象

内部字段：


{
    Rssi:     //网络的接收信号强度

}

示例代码

var connectWifi= api.require('connectWifi');
connectWifi.getRssi(function (ret, err) {
    if (ret) {
        console.log(JSON.stringify(ret));
        alert("Rssi=" + ret.Rssi);
    } else {
        console.log(JSON.stringify(err));
        alert('错误:' + JSON.stringify(err.msg));
    }
});

补充说明

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

可用性

Android系统

可提供的1.0.0及更高版本

getSsid

得到网络的服务集标识符

getSsid(callback(ret, err))

callback(ret, err)

ret：

  • 类型：JSON 对象

内部字段：


{
    SSID:     //网络的服务集标识符

}

示例代码

var connectWifi= api.require('connectWifi');
connectWifi.getSsid(function (ret, err) {
    if (ret) {
        console.log(JSON.stringify(ret));
        alert("SSID=" + ret.SSID);
    } else {
        console.log(JSON.stringify(err));
        alert('错误:' + JSON.stringify(err.msg));
    }
});

补充说明

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

可用性

Android系统

可提供的1.0.0及更高版本

getSupplicantState

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

getSupplicantState(callback(ret, err))

callback(ret, err)

ret：

  • 类型：JSON 对象

内部字段：


{
    supplicantState:     //请求者与接入点协商的详细状态

}

示例代码

var connectWifi= api.require('connectWifi');
connectWifi.getSupplicantState(function (ret, err) {
    if (ret) {
        console.log(JSON.stringify(ret));
        alert("supplicantState=" + ret.supplicantState);
    } else {
        console.log(JSON.stringify(err));
        alert('错误:' + JSON.stringify(err.msg));
    }
});

补充说明

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

可用性

Android系统

可提供的1.0.0及更高版本