# TCPSocket

基础库 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 callback)

监听一旦 socket 完全关闭就发出该事件

# TCPSocket.offClose(function callback)

取消监听一旦 socket 完全关闭就发出该事件

# TCPSocket.onConnect(function callback)

监听当一个 socket 连接成功建立的时候触发该事件

# TCPSocket.offConnect(function callback)

取消监听当一个 socket 连接成功建立的时候触发该事件

# TCPSocket.onError(function callback)

监听当错误发生时触发

# TCPSocket.offError(function callback)

取消监听当错误发生时触发

# TCPSocket.onMessage(function callback)

监听当接收到数据的时触发该事件

# TCPSocket.offMessage(function callback)

取消监听当接收到数据的时触发该事件

# TCPSocket.onBindWifi(function callback)

监听当一个 socket 绑定当前 wifi 网络成功时触发该事件

# TCPSocket.offBindWifi(function callback)

取消监听当一个 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.herrno.h 中查看具体的报错信息。