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 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 中查看具体的报错信息。

TCPSocketwx.createTCPSocket(Object object)

基础库 2.18.0 开始支持,低版本需做兼容处理。

微信小程序插件:支持

微信 Windows 版:支持

微信 Mac 版:支持

微信 鸿蒙 OS 版:支持

相关文档: 网络使用说明

功能描述

创建一个 TCP Socket 实例。使用前请注意阅读相关说明。

参数

Object object

属性 类型 默认值 必填 说明 最低版本
type string ipv4 否 套接字族,必须是 IPv4 或者 IPv6,默认是 IPv4 3.6.4
合法值 说明
ipv4 IPv4
ipv6 IPv6

返回值

TCPSocket

一个 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

wx.offLocalServiceDiscoveryStop(function listener)

基础库 2.4.0 开始支持,低版本需做兼容处理。

微信小程序插件:支持,需要微信小程序基础库版本不低于 2.15.0

相关文档: 局域网通信

功能描述

移除 mDNS 服务停止搜索的事件的监听函数

参数

function listener

onLocalServiceDiscoveryStop 传入的监听函数。不传此参数则移除所有监听函数。

示例代码

const listener = function (res) { console.log(res) }

wx.onLocalServiceDiscoveryStop(listener)
wx.offLocalServiceDiscoveryStop(listener) // 需传入与监听时同一个的函数对象

wx.offLocalServiceFound(function listener)

基础库 2.4.0 开始支持,低版本需做兼容处理。

微信小程序插件:支持,需要微信小程序基础库版本不低于 2.15.0

相关文档: 局域网通信

功能描述

移除 mDNS 服务发现的事件的监听函数

参数

function listener

onLocalServiceFound 传入的监听函数。不传此参数则移除所有监听函数。

示例代码

const listener = function (res) { console.log(res) }

wx.onLocalServiceFound(listener)
wx.offLocalServiceFound(listener) // 需传入与监听时同一个的函数对象

wx.offLocalServiceLost(function listener)

基础库 2.4.0 开始支持,低版本需做兼容处理。

微信小程序插件:支持,需要微信小程序基础库版本不低于 2.15.0

相关文档: 局域网通信

功能描述

移除 mDNS 服务离开的事件的监听函数

参数

function listener

onLocalServiceLost 传入的监听函数。不传此参数则移除所有监听函数。

示例代码

const listener = function (res) { console.log(res) }

wx.onLocalServiceLost(listener)
wx.offLocalServiceLost(listener) // 需传入与监听时同一个的函数对象

wx.offLocalServiceResolveFail(function listener)

基础库 2.4.0 开始支持,低版本需做兼容处理。

微信小程序插件:支持,需要微信小程序基础库版本不低于 2.15.0

相关文档: 局域网通信

功能描述

取消监听 mDNS 服务解析失败的事件。

参数

function listener

通过 onLocalServiceResolveFail 传入的监听函数。如果不传此参数,则会移除该事件的所有监听函数。

示例代码

const listener = function (res) { console.log(res) }

wx.onLocalServiceResolveFail(listener)
wx.offLocalServiceResolveFail(listener) // 需传入与监听时同一个的函数对象

wx.onLocalServiceFound(function listener)

基础库 2.4.0 开始支持,低版本需做兼容处理。

微信小程序插件:支持,需要微信小程序基础库版本不低于 2.15.0

相关文档: 局域网通信

功能描述

监听 mDNS 服务发现的事件

参数

function listener

mDNS 服务发现的事件的监听函数

参数

Object res
属性 类型 说明
serviceType string 服务的类型
serviceName string 服务的名称
ip string 服务的 ip 地址
port number 服务的端口

wx.onLocalServiceLost(function listener)

基础库 2.4.0 开始支持,低版本需做兼容处理。

微信小程序插件:支持,需要微信小程序基础库版本不低于 2.15.0

相关文档: 局域网通信

功能描述

监听 mDNS 服务离开的事件

参数

function listener

mDNS 服务离开的事件的监听函数

参数

Object res
属性 类型 说明
serviceType string 服务的类型
serviceName string 服务的名称

wx.onLocalServiceResolveFail(function listener)

基础库 2.4.0 开始支持,低版本需做兼容处理。

微信小程序插件:支持,需要微信小程序基础库版本不低于 2.15.0

相关文档: 局域网通信

功能描述

监听 mDNS 服务解析失败的事件

参数

function listener

mDNS 服务解析失败的事件的监听函数

参数

Object res
属性 类型 说明
serviceType string 服务的类型
serviceName string 服务的名称