分类： 网络

TCPSocket.onBindWifi(function listener)

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

微信小程序插件：不支持

微信 Windows 版：支持

微信 Mac 版：支持

微信 鸿蒙 OS 版：支持

相关文档: 网络使用说明

功能描述

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

参数

function listener

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

TCPSocket.offMessage(function listener)

微信小程序插件：不支持

微信 Windows 版：支持

微信 Mac 版：支持

微信 鸿蒙 OS 版：支持

相关文档: 网络使用说明

功能描述

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

参数

function listener

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

示例代码

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

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

TCPSocket.offError(function listener)

微信小程序插件：不支持

微信 Windows 版：支持

微信 Mac 版：支持

微信 鸿蒙 OS 版：支持

相关文档: 网络使用说明

功能描述

移除当错误发生时触发的监听函数

参数

function listener

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

示例代码

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

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

TCPSocket.offConnect(function listener)

微信小程序插件：不支持

微信 Windows 版：支持

微信 Mac 版：支持

微信 鸿蒙 OS 版：支持

相关文档: 网络使用说明

功能描述

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

参数

function listener

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

示例代码

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

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

TCPSocket.offClose(function listener)

微信小程序插件：不支持

微信 Windows 版：支持

微信 Mac 版：支持

微信 鸿蒙 OS 版：支持

相关文档: 网络使用说明

功能描述

移除当 socket 完全关闭时触发事件的监听函数

参数

function listener

通过 onClose 传入的监听函数。如果不传此参数，则移除所有监听函数。

示例代码

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

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

TCPSocket.offBindWifi(function listener)

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

微信小程序插件：不支持

微信 Windows 版：支持

微信 Mac 版：支持

微信 鸿蒙 OS 版：支持

相关文档: 网络使用说明

功能描述

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

参数

function listener

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

示例代码

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

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

TCPSocket.connect(Object options)

微信小程序插件：不支持

微信 Windows 版：支持

微信 Mac 版：支持

微信 鸿蒙 OS 版：支持

相关文档: 网络使用说明

功能描述

在指定的套接字上启动连接

参数

Object options

属性 类型 默认值 必填 说明 最低版本
address string 是 套接字要连接的地址
port number 是 套接字要连接的端口
timeout number 2 否 套接字连接的超时时间，默认为 2 秒
enableHttpDNS boolean false 否 是否开启 HttpDNS 服务。如果开启，需要同时填入 httpDNSServiceId。HttpDNS 用法详见移动解析 HttpDNS 3.4.0
httpDNSServiceId string 否 HttpDNS 服务商 ID。HttpDNS 用法详见移动解析 HttpDNS 3.4.0

示例代码


  const tcp = wx.createTCPSocket()
  tcp.connect({address: '192.168.193.2', port: 8848})

TCPSocket.bindWifi(Object options)

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

微信小程序插件：不支持

微信 Windows 版：支持

微信 Mac 版：支持

微信 鸿蒙 OS 版：支持

相关文档: 网络使用说明

功能描述

将 TCP Socket 绑定到当前 wifi 网络，成功后会触发 onBindWifi 事件（仅安卓支持）

参数

Object options

属性 类型 默认值 必填 说明
BSSID string 是 当前 wifi 网络的 BSSID ，可通过 wx.getConnectedWifi 获取

示例代码


  const tcp = wx.createTCPSocket()
  tcp.bindWifi({ BSSID: 'xxx' })
  tcp.onBindWifi(() => {})