tencent cloud

腾讯云超级应用服务

动态与公告
【2025年1月2日】关于腾讯云小程序平台更名为腾讯云超级应用服务的公告
控制台更新动态
Android SDK 更新动态
iOS SDK 更新动态
Flutter 更新动态
IDE 更新动态
基础库更新动态
产品简介
产品概述
产品优势
应用场景
购买指南
计费概述
按量计费(后付费)
续费指引
停服说明
快速入门
套餐管理
概述
控制台账号管理
存储配置
加速配置
品牌化配置
平台功能
控制台登录
用户和权限体系
小程序管理
小游戏管理
应用管理
商业化
平台管理
用户管理
团队管理
运营管理
安全中心
代码接入指引
Demo 及 SDK 获取
Android
iOS
Flutter
App 服务端接入指南
GUID 生成规则
小程序开发指南
小程序介绍与开发环境
小程序代码组成
指南
框架
组件
API
服务端
JS SDK
基础库
IDE 使用指南
小游戏开发指南
指南
API
服务端
实践教程
小程序登录实践教程
小程序订阅消息实践教程
支付相关实践教程
广告接入实践教程
小游戏订阅消息实践教程
相关协议
数据处理和安全协议

TCP 通信

PDF
聚焦模式
字号
最后更新时间: 2024-07-12 19:28:42

createTCPSocket

该 API 使用方法为 TCPSocket wx.createTCPSocket()
功能说明:创建一个 TCP Socket 实例。
返回值:一个 TCP Socket 实例。
链接限制
允许与局域网内的非本机 IP 通信;
允许与配置过的服务器域名通信,详见 相关说明
禁止与以下端口号连接:1024 以下、1099、1433、1521、1719、1720、1723、2049、2375、3128、3306、3389、3659、4045、5060、5061、5432、5984、6379、6000、6566、7001、7002、8000-8100、8443、8888、9200、9300、10051、10080、11211、27017、27018、27019;
每5分钟内最多创建20个 TCPSocket。


TCPSocket

说明:
一个 TCP Socket 实例,默认使用 IPv4 协议。
当 errCode 为 -2 时,errMsg 里应该会有相应的 errno ,开发者可以根据 errno 到 Linux 代码里的 errno-base.h 和 errno.h 中查看具体的报错信息。

.bindWifi

该 方法 使用方式为 TCPSocket.bindWifi(Object options)
功能说明:将 TCP Socket 绑定到当前 Wi-Fi 网络,成功后会触发 onBindWifi 事件(仅 Android 支持)。
参数及说明:Object options。
属性
类型
默认值
必填
说明
BSSID
string
-
当前 Wi-Fi 网络的 BSSID ,可通过 wx.getConnectedWifi 获取
示例代码:
const tcp = wx.createTCPSocket()
tcp.bindWifi({ BSSID: 'xxx' })
tcp.onBindWifi(() => {})


.close

该 方法 使用方式为 TCPSocket.close()
功能说明:关闭连接。
示例代码:
const tcp = wx.createTCPSocket()
tcp.close()


.connect

该 方法 使用方式为 TCPSocket.connect(Object options)
功能说明:在给定的套接字上启动连接。
参数及说明:Object options。
属性
类型
默认值
必填
说明
address
string
-
套接字要连接的地址
port
number
-
套接字要连接的端口
timeout
number
2
套接字要连接的超时时间,默认为 2s
示例代码:
const tcp = wx.createTCPSocket()
tcp.connect({address: '192.168.193.2', port: 8848})


.onClose

该 方法 使用方式为 TCPSocket.onClose(function listener)
功能说明:监听一旦 socket 完全关闭就发出该事件。
参数及说明:function listener,一旦 socket 完全关闭就发出该事件的监听函数。


.offClose

该 方法 使用方式为 TCPSocket.offClose(function listener)
功能说明:移除一旦 socket 完全关闭就发出该事件的监听函数。
参数及说明:function listener,onClose 传入的监听函数。不传此参数则移除所有监听函数。
示例代码:
const listener = function (res) { console.log(res) }

TCPSocket.onConnect(listener)
TCPSocket.offConnect(listener) // 需传入与监听时同一个的函数


.onConnect

该 方法 使用方式为 TCPSocket.onConnect(function listener)
功能说明:监听当一个 socket 连接成功建立的时候触发该事件。
参数及说明:function listener,当一个 socket 连接成功建立的时候触发该事件的监听函数。


.offConnect

该 方法 使用方式为 TCPSocket.offConnect(function listener)
功能说明:移除当一个 socket 连接成功建立的时候触发该事件的监听函数。
参数及说明:function listener,onConnect 传入的监听函数。不传此参数则移除所有监听函数。
示例代码:
const listener = function (res) { console.log(res) }

TCPSocket.onConnect(listener)
TCPSocket.offConnect(listener) // 需传入与监听时同一个的函数对象


.onError

该 方法 使用方式为 TCPSocket.onError(function listener)
功能说明:监听当错误发生时触发。
参数及说明:function listener 的监听函数。
属性
类型
说明
errMsg
string
错误信息


.offError

该 方法 使用方式为 TCPSocket.offError(function listener)
功能说明:移除当错误发生时触发的监听函数。
参数及说明:function listener,onError 传入的监听函数。不传此参数则移除所有监听函数。
示例代码:
const listener = function (res) { console.log(res) }

TCPSocket.onError(listener)
TCPSocket.offError(listener) // 需传入与监听时同一个的函数对象


.onMessage

该 方法 使用方式为 TCPSocket.onMessage(function listener)
功能说明:监听当接收到数据的时触发该事件。
参数及说明:function listener,当接收到数据的时触发该事件的监听函数,参数 Object res 如下:
属性
类型
说明
message
ArrayBufffer
收到的消息
remoteInfo
Object
发送端地址信息
localInfo
Object
接收端地址信息
remoteInfo 结构属性
结构属性
类型
说明
address
string
发送消息的 socket 的地址
family
string
使用的协议族,为 IPv4 或者 IPv6
port
number
端口号
size
number
message 的大小,单位:字节
localInfo 结构属性
结构属性
类型
说明
address
string
发送消息的 socket 的地址
family
string
使用的协议族,为 IPv4 或者 IPv6
port
number
端口号


.offMessage

该 方法 使用方式为 TCPSocket.offMessage(function listener)
功能说明:移除当接收到数据的时触发该事件的监听函数。
参数及说明:function listener,onMessage 传入的监听函数。不传此参数则移除所有监听函数。
示例代码:
const listener = function (res) { console.log(res) }

TCPSocket.onMessage(listener)
TCPSocket.offMessage(listener) // 需传入与监听时同一个的函数对象


.onBindWifi

该 方法 使用方式为 TCPSocket.onBindWifi(function listener)
功能说明:监听当一个 socket 绑定当前 Wi-Fi 网络成功时触发该事件。
参数及说明:function listener,当一个 socket 绑定当前 Wi-Fi 网络成功时触发该事件的监听函数。


.offBindWifi

该 方法 使用方式为 TCPSocket.offBindWifi(function listener)
功能说明:移除当一个 socket 绑定当前 Wi-Fi 网络成功时触发该事件的监听函数。
参数及说明:function listener,onBindWifi 传入的监听函数。不传此参数则移除所有监听函数。
示例代码:
const listener = function (res) { console.log(res) }

TCPSocket.onBindWifi(listener)
TCPSocket.offBindWifi(listener) // 需传入与监听时同一个的函数对象


.write

该 方法 使用方式为 TCPSocket.write(string|ArrayBuffer data)
功能说明:在 socket 上发送数据。
参数及说明:string|ArrayBuffer data,要发送的数据。
示例代码:
const tcp = wx.createTCPSocket()
tcp.write('hello, how are you')


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈