networkAddress

概述

networkAddress 原生插件封装了网路状态的管理器,获取网络状态,连接的网络类型,网速,ping测试网络,网络地址的title;

get

获取手机网络ip

get(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    address:''        //字符类型;当前手机网络的 ip 地址 
}

示例代码

var networkAddress = api.require('networkAddress');
networkAddress.get();

可用性

iOS系统,android系统

可提供的1.0.0及更高版本

ping

获取ping某一个IP或者域名的结果,可以通过该方法判断是否可以和服务器交互.

ping({params}, callback(ret, err))

params

target:

  • 类型:字符串
  • 默认值:无
  • 描述:目标主机IP或者域名,不能为空

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

{
     status: //操作成功状态值 true表示可以ping通,false表示无法ping通。
}

err:

  • 类型:JSON 对象

内部字段:

{
       code:       //错误代码 参考错误代码
    msg:""		//错误描述
}

示例代码

var networkAddress = api.require('networkAddress');
var targethost = "www.baidu.com";
networkAddress.ping({
        target: targethost
    },function(ret, err) {
        if (ret) {
            api.alert({ msg: JSON.stringify(ret) });
        }else{
            api.alert({ msg: err.msg });
        }
    }
);

补充说明

可用性

iOS系统,android系统

可提供的1.0.0及更高版本

pingTest

执行ping测试,默认执行5次ping测试,并返回每一个的执行结果

pingTest({params}, callback(ret, err))

params

target:

  • 类型:字符串
  • 默认值:无
  • 描述:目标主机IP或者域名,不能为空

size:

  • 类型:字符串
  • 默认值:64
  • 描述:ping测试的字节数,默认为64B

time:

  • 类型:整型
  • 默认值:5
  • 描述:ping测试的次数,默认为5次

timeout:

  • 类型:整型
  • 默认值:5
  • 描述:ping测试的超时时间,默认为5毫秒

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

{
    status:true		//操作成功状态值 布尔类型	
    time: 			//返回每次ping测试的延时结果 单位为ms
    sumtime:   		//返回ping测试的总延时结果 单位为ms
    avgtime:   		//返回ping测试的平均延时结果 单位为ms
    successtimes:  //ping命令执行成功次数
    failtimes:      //ping命令执行失败次数
    pingloss:		//ping命令执行丢失包百分比 数值为					  			  failtime/(successtimes + failtimes)
    ttl:            //TTL是IPv4包头的一个8 bit字段
}

err:

  • 类型:JSON 对象

内部字段:

{
       code:       //错误代码 参考错误代码
    msg:""		//错误描述
}

示例代码

var networkAddress = api.require('networkAddress');
var targethost = "www.baidu.com";
var size = 64;
var time = 5;
var timeout = 5;
networkAddress.pingTest({
        target: targethost,
        size: size,
        time: time,
        timeout: timeout
    },
    function(ret, err) {
        if (ret) {
            if (err) {
                api.alert({ msg: "ret " + JSON.stringify(ret) + "err " + JSON.stringify(err) });
                return;
            }
            api.alert({ msg: JSON.stringify(ret) });
            return;
        }
        if (err) {
            api.alert({ msg: err.msg });
        }
    }
);

补充说明

可用性

Android系统

可提供的1.0.0及更高版本

isNetConnected

判断网络是否连接

isNetConnected(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status:''        //布尔类型;当true 成功false失败;
}

示例代码

    var netAddress = api.require('networkAddress');
        	    netAddress.isNetConnected(function(ret){
        		api.alert({
            msg: JSON.stringify(ret)
        })
        	});

可用性

iOS系统,android系统

可提供的1.0.0及更高版本

getNetworkType

获取连接的网络类型

getNetworkType(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    type:''        //字符串类型;     0: 没有网络连接, 1:wifi连接,  2: 2G ,  3: 3G , 4:4G  ,5:手机流量
}

示例代码

    var netAddress = api.require('networkAddress');
        	    netAddress.getNetworkType(function(ret){
        		api.alert({
            msg: JSON.stringify(ret)
        })
        	});

可用性

iOS系统,android系统

可提供的1.0.0及更高版本

netWorkSpeedListener

添加网速监听

netWorkSpeedListener(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    NetWorkSpeed:'',        //字符串类型;网速单位kb/s,iOS不支持此参数
    received:'',            //字符串类型;收到,网速单位kb/s,Android不支持此参数

    send:'',                //字符串类型;发送,网速单位kb/s,Android不支持此参数


}

示例代码

    var netAddress = api.require('networkAddress');
        	    netAddress.netWorkSpeedListener(function(ret){
        		//api.alert({
            msg: JSON.stringify(ret)
        })
        	});

可用性

iOS系统,android系统

可提供的1.0.0及更高版本

stopNetWorkSpeedListener

停止网速监听

stopNetWorkSpeedListener()

示例代码

var netAddress = api.require('networkAddress');
        	    netAddress.stopNetWorkSpeedListener();

可用性

iOS系统,android系统

可提供的1.0.0及更高版本

错误码

取值范围

  • 1 //请求超时
  • 2 //未知主机地址
  • 3 //错误:连接失败
  • 4 //连接中断
  • 5 //无法读出数据
  • 6 //JS传递的主机参数为空
  • 99 //其他错误 参考msg
是否仍需要帮助? 请保持联络!
最后更新于 2023/01/18