Net


概述

网络相关接口。网络操作均为异步操作,所有函数执行均无返回值,需要事件中处理相关网络事件。


常量

网络事件

当收到msg.NET_EVENT消息时,消息内容中的"event"为以下内容:

  • Net.ERROR
  • Net.READY
  • Net.CONN_OK
  • Net.CONN_FAIL
  • Net.CONN_CLOSE
  • Net.SEND_OK
  • Net.SEND_FAIL
  • Net.RECV
常量 说明 消息内容
Net.ERROR 发生错误
Net.READY 网络准备就绪
Net.CONN_OK 连接服务器成功 id:连接id
Net.CONN_FAIL 连接服务器失败 id:连接id
Net.CONN_CLOSE 连接服务器关闭 id:连接id
Net.SEND_OK 发送成功 id:连接id
Net.SEND_FAIL 发送失败 id:连接id
Net.RECV 收到数据 id:连接id
data:收到的数据,类型为bytes

函数

init

网络初始化。

  • Net.init([ap [,username [,password]]])
参数 必选 类型 说明
ap false String 运营商的AP名称,最多32字节,忽略则使用CMNET
username false String 用户名,最多32字节
passwrd false String 密码,最多32字节
return null 无返回值

connect

连接服务器。模块可以启动4个连接。

  • Net.connect(id, addr, port)
参数 必选 类型 说明
id true int 连接id,范围为0-3
addr true String 服务器IP或域名,最多64字节
port true int 服务器端口,范围为1-65535
return null 无返回值

close

关闭连接。

  • Net.close(id)
参数 必选 类型 说明
id true int 连接id,范围为0-3
return null 无返回值

send

发送数据,数据长度最大为1K。

  • Net.send(id, data_string | data_bytes)
参数 必选 类型 说明
id true int 连接id,范围为0-3
data_string true String 发送的数据,用于发送字符串
data_bytes true bytes 发送的数据,用于发送字节流
return null 无返回值

syncTime

同步网络时间到盒子,需在网络就绪以后调用。设置特定时间请看Box.getTime

  • Net.syncTime()
参数 必选 类型 说明
return boolean true表示成功,false表示失败

csq

获取网络信号强度,需在网络就绪以后调用

  • Net.csq()
参数 必选 类型 说明
return int 99表示无信号,0-31表示有信号,值越小信号越好,一般值在20以下通讯会比较正常。