全部产品

network - 网络管理

更新时间:2021-04-27 11:17:23

示例代码

var network = require('network');

var net = network.openNetWorkClient();

function netinfo_print(){
    var info = net.getInfo();
    /* imsi 国际移动用户识别码 */
    console.log('net imsi is: ' + info.imsi);
    
    /* imei 国际移动设备识别码 */
    console.log('net imei is: ' + info.imei);
    
    /* iccid 集成电路卡识别码 */
    console.log('net iccid is: ' + info.iccid);
    
    /* cid 基站编号 */
    console.log('net cid is: ' + info.cid);
    
    /* lac 位置区域码 */
    console.log('net lac is: ' + info.lac);
    
    /* mcc 移动国家代码(中国的为460 */
    console.log('net mcc is: ' + info.mcc);
    
    /* mnc 移动网络号码(中国移动为00,中国联通为01) */
    console.log('net mnc is: ' + info.mnc);
    
    /* rssi 接收的信号强度值 */
    console.log('net rssi is: ' + info.rssi);
}


/** 获取网络类型
* 目前支持两种类型:wifi cellular(蜂窝网)
*/
var type = net.getType();
console.log('net type is: ' + type);

/** 获取网络状态
* 目前支持两种状态:connect disconnect(蜂窝网)
*/
var status = net.getStatus();
console.log('net status is: ' + status);

if (status == 'connect') {
    netinfo_print();
} else {
    net.on('connect', function() {
        netinfo_print();
    })
}

net.on('disconnect', function(){
    console.log('device is disconnect');
});

该接口可以用来管理网络,获取网络信息,监听网络事件等。

事件

方法

获取网络类型。

WiFi连接网络。

WiFi信息获取。

WiFi关闭。

获取网络状态。

注册网络事件回调函数。

事件:'connect'

如果是WiFi网络,WiFi网络连接成功后,会触发'connect'事件。

事件:'disconnect'

如果是WiFi网络,WiFi网络断开连接时,会触发'disconnect'事件。

network.getType()

获取网络连接类型。

返回值

  • String类型,网络类型,返回值:WiFi, 2G, 3G, 4G, 5G, unknown, none。

network.connect(Object option)

如果是WiFi网络,连接网络。非WiFi网络调用无效。

入参

Object类型,其参数有:

属性

类型

必填

描述

ssid

String

要连接热点的ssid

password

String

要连接热点的password

success

Function

调用该接口成功后的回调函数

fail

Function

调用该接口失败后的回调函数

network.getInfo()

获取网络信息。

返回值

Object类型,如果是WiFi网络, 其属性有:

属性

类型

描述

type

String

默认为'wifi'

ssid

String

已连接热点的ssid

bssid

String

已连接热点的bssid

rssi

Number

WiFi信号强度

ip

String

IP地址

返回值

Object类型,如果是Cellular网络,其属性有:

属性

类型

描述

type

String

默认为'cellular'

imei

String

国际移动设备识别码

sn

String

手机序列号

sim

Object

Integrate circuit card identity 集成电路卡识别码即SIM卡卡号,具体参数见下表

rssi

String

信号强度值

snr

String

信噪比

rsrp

String

Reference Signal Receiving Power,参考信号接收功率

rsrq

String

RSRQ(Reference Signal Receiving Quality)表示LTE参考信号接收质量

cqi

String

CQI是信道质量的信息指示,代表当前信道质量的好坏,和信道的信噪比大小相对应,取值范围0~31

sim说明

Object类型,具体属性为:

属性

类型

描述

iccid

String

Integrate circuit card identity 集成电路卡识别码即SIM卡卡号

network.disconnect()

如果是WiFi网络, 断开网络连接。

network.getStatus()

获取网络连接状态。

返回值

Object类型,具体属性为:

属性

类型

描述

status

String

网络状态,返回值:'connect', 'disconnect', 'connecting'

network.on(String event, Function callback)

注册网络事件回调函数。

入参

属性

类型

必填

描述

event

String

注册的事件名称

callback

Function

监听事件的回调函数