基础库 2.18.0 开始支持,低版本需做兼容处理。
相关文档: 网络使用说明
一个 TCP Socket 实例,默认使用 IPv4 协议
方法
TCPSocket.bindWifi(Object options)
将 TCP Socket 绑定到当前 wifi 网络,成功后会触发 onBindWifi 事件(仅安卓系统支持)
TCPSocket.connect(Object options)
在给定的套接字上启动连接
TCPSocket.write(string|ArrayBuffer data)
在 socket 上发送数据
TCPSocket.close()
关闭连接
TCPSocket.onClose(function listener)
监听 socket 完全关闭时触发的事件
TCPSocket.offClose(function listener)
移除 socket 完全关闭时触发的事件的监听函数
TCPSocket.onConnect(function listener)
监听 socket 连接成功建立时触发的事件
TCPSocket.offConnect(function listener)
移除 socket 连接成功建立时触发的事件的监听函数
TCPSocket.onError(function listener)
监听错误发生时触发的事件
TCPSocket.offError(function listener)
移除错误发生时触发的事件的监听函数
TCPSocket.onMessage(function listener)
监听接收到数据时触发的事件
TCPSocket.offMessage(function listener)
移除接收到数据时触发的事件的监听函数
TCPSocket.onBindWifi(function listener)
监听 socket 绑定当前 wifi 网络成功时触发的事件
TCPSocket.offBindWifi(function listener)
移除 socket 绑定当前 wifi 网络成功时触发的事件的监听函数
错误
| 错误码 | 错误信息 | 说明 |
|---|---|---|
| -1 | 系统错误 | |
| -2 | socket接口错误,可参考系统的socket错误码 | |
| -3 | 发送失败,无接口权限 | |
| -4 | 连接失败 | |
| 1 | 发送失败,参数错误,address不合法 | |
| 2 | 发送失败,参数错误,port不合法 | |
| 3 | 绑定wifi网络失败,BSSID不合法 | |
| 4 | 绑定wifi网络失败,系统错误 | |
| 5 | 绑定wifi网络失败,该接口仅在安卓平台支持 | |
| 6 | 绑定wifi网络失败,低版本安卓不支持该接口 |
注意
- 当 errCode 为 -2 时,errMsg 里应该会有相应的 errno ,开发者可以根据 errno 到 linux 代码里的 errno-base.h 和 errno.h 中查看具体的报错信息。