# TCPSocket
基础库 3.1.1 开始支持,低版本需做兼容处理。
相关文档: 网络使用说明
一个 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 中查看具体的报错信息。