Table of Contents
socket
socket.isReady()
socket.tcp(ssl, cert, tCoreExtPara)
socket.udp()
socket.setTcpResendPara(retryCnt, retryMaxTimeout)
socket.setDnsParsePara(retryCnt, retryTimeoutMulti)
socket.printStatus()
socket.setLowPower™
socket
模块功能:数据链路激活、SOCKET管理(创建、连接、数据收发、状态维护)
socket.isReady()
SOCKET 是否有可用
参数
无
返回值
可用true,不可用false
例子
无
socket.tcp(ssl, cert, tCoreExtPara)
创建基于TCP的socket对象
参数
名称 传入值类型 释义
ssl bool 可选参数,默认为nil 是否为ssl连接,true表示是,其余表示否
cert table 可选参数,默认为nil ssl连接需要的证书配置,只有ssl参数为true时,此参数才有意义,cert格式如下:
{
caCert = “ca.crt”, --CA证书文件(Base64编码 X.509格式),如果存在此参数,则表示客户端会对服务器的证书进行校验;不存在则不校验
clientCert = “client.crt”, --客户端证书文件(Base64编码 X.509格式),服务器对客户端的证书进行校验时会用到此参数
clientKey = “client.key”, --客户端私钥文件(Base64编码 X.509格式)
clientPassword = “123456”, --客户端证书文件密码[可选]
}
tCoreExtPara table 可选参数,默认为nil 建立链接扩展参数,4G链接和ch395链接所需扩展参数不一样
返回值
client,创建成功返回socket客户端对象;创建失败返回nil
例子
c = socket.tcp()
c = socket.tcp(true)
c = socket.tcp(true, {caCert=“ca.crt”})
c = socket.tcp(true, {caCert=“ca.crt”, clientCert=“client.crt”, clientKey=“client.key”})
c = socket.tcp(true, {caCert=“ca.crt”, clientCert=“client.crt”, clientKey=“client.key”, clientPassword=“123456”})
详细指南和示例参考:指南 示例
socket.udp()
创建基于UDP的socket对象
参数
无
返回值
client,创建成功返回socket客户端对象;创建失败返回nil
例子
c = socket.udp()
详细指南和示例参考:指南 示例
socket.setTcpResendPara(retryCnt, retryMaxTimeout)
设置TCP层自动重传的参数
参数
名称 传入值类型 释义
retryCnt number 可选参数,默认为4 重传次数;取值范围0到12
retryMaxTimeout number 可选参数,默认为16 限制每次重传允许的最大超时时间(单位秒),取值范围1到16
返回值
nil
例子
setTcpResendPara(3,8)
setTcpResendPara(4,16)
详细指南和示例参考:指南 示例
socket.setDnsParsePara(retryCnt, retryTimeoutMulti)
设置域名解析参数
注意:0027以及之后的core版本才支持此功能
参数
名称 传入值类型 释义
retryCnt number 可选参数,默认为4 重传次数;取值范围1到8
retryTimeoutMulti number 可选参数,默认为4 重传超时时间倍数,取值范围1到5
第n次重传超时时间的计算方式为:第n次的重传超时基数retryTimeoutMulti,单位为秒
重传超时基数表为{1, 1, 2, 4, 4, 4, 4, 4}
第1次重传超时时间为:1retryTimeoutMulti 秒
第2次重传超时时间为:1retryTimeoutMulti 秒
第3次重传超时时间为:2retryTimeoutMulti 秒
…
第8次重传超时时间为:8*retryTimeoutMulti 秒
返回值
nil
例子
socket.setDnsParsePara(8,5)
socket.printStatus()
打印所有socket的状态
参数
无
返回值
无
例子
socket.printStatus()
socket.setLowPower™
设置数据传输后,允许进入休眠状态的延时时长
3024版本以及之后的版本才支持此功能
此功能设置的参数,设置成功后,掉电会自动保存
参数
名称 传入值类型 释义
tm number 数据传输后,允许进入休眠状态的延时时长,单位为秒,取值范围1到20
注意:此时间越短,允许进入休眠状态越快,功耗越低;但是在某些网络环境中,此时间越短,可能会造成数据传输不稳定
建议在可以接受的功耗范围内,此值设置的越大越好
如果没有设置此参数,此延时时长是和基站的配置有关,一般来说是10秒左右
返回值
nil文章来源:https://www.toymoban.com/news/detail-638400.html
例子
socket.setLowPower(5)文章来源地址https://www.toymoban.com/news/detail-638400.html
到了这里,关于合宙Air724UG LuatOS-Air script lib API--socket的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!