分类： 微信小程序开发

UDPSocket.onError(function listener)

微信小程序插件：支持，需要微信小程序基础库版本不低于 2.11.1

微信 Windows 版：支持

微信 Mac 版：支持

微信 鸿蒙 OS 版：支持

相关文档: 网络使用说明、局域网通信

功能描述

监听错误事件

参数

function listener

错误事件的监听函数

参数

Object res
属性 类型 说明
errMsg string 错误信息

UDPSocket.offMessage(function listener)

微信小程序插件：支持，需要微信小程序基础库版本不低于 2.11.1

微信 Windows 版：支持

微信 Mac 版：支持

微信 鸿蒙 OS 版：支持

相关文档: 网络使用说明、局域网通信

功能描述

移除收到消息的事件的监听函数

参数

function listener

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

示例代码

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

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

UDPSocket.offListening(function listener)

微信小程序插件：支持，需要微信小程序基础库版本不低于 2.11.1

微信 Windows 版：支持

微信 Mac 版：支持

微信 鸿蒙 OS 版：支持

相关文档: 网络使用说明、局域网通信

功能描述

取消监听开始接收数据包消息的事件。也就是移除之前设置的监听函数，之后不再触发该回调。

参数

function listener

通过 onListening 传入的监听函数。如果不传这个参数，就会移除所有监听函数。

示例代码

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

UDPSocket.onListening(listener)
UDPSocket.offListening(listener) // 需传入与监听时同一个的函数对象

UDPSocket.offError(function listener)

微信小程序插件：支持，需要微信小程序基础库版本不低于 2.11.1

微信 Windows 版：支持

微信 Mac 版：支持

微信 鸿蒙 OS 版：支持

相关文档: 网络使用说明、局域网通信

功能描述

移除错误事件的监听函数

参数

function listener

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

示例代码

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

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

UDPSocket.offClose(function listener)

微信小程序插件：支持，需要微信小程序基础库版本不低于 2.11.1

微信 Windows 版：支持

微信 Mac 版：支持

微信 鸿蒙 OS 版：支持

相关文档: 网络使用说明、局域网通信

功能描述

移除关闭事件的监听函数

参数

function listener

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

示例代码

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

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

UDPSocket.connect(Object object)

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

微信小程序插件：支持，需要微信小程序基础库版本不低于 2.11.1

微信 Windows 版：支持

微信 Mac 版：支持

微信 鸿蒙 OS 版：支持

相关文档: 网络使用说明、局域网通信

功能描述

预先连接到指定的 IP 和端口号，需要配合 write 方法一起使用

参数

Object object

属性 类型 默认值 必填 说明
address string 是 要发消息的地址
port number 是 要发送消息的端口号

示例代码


  const udp = wx.createUDPSocket()
  udp.bind()
  udp.connect({
    address: '192.168.193.2',
    port: 8848,
  })
  udp.write({
    address: '192.168.193.2',
    port: 8848,
    message: 'hello, how are you'
  })

UDPSocket.close()

微信小程序插件：支持，需要微信小程序基础库版本不低于 2.11.1

微信 Windows 版：支持

微信 Mac 版：支持

微信 鸿蒙 OS 版：支持

相关文档: 网络使用说明、局域网通信

功能描述

关闭 UDP Socket 实例，相当于销毁这个实例。关闭之后，这个 UDP Socket 实例就不能再发送消息了，每次调用 UDPSocket.send 都会触发错误事件，并且 message 事件回调函数也不会再执行。在 UDPSocket 实例被创建后，会被 Native 强引用，确保它不会被垃圾回收（GC）。在调用 UDPSocket.close 后，会解除这个强引用，让 UDPSocket 实例遵循垃圾回收机制。

UDPSocket.bind(number port)

微信小程序插件：支持，需要微信小程序基础库版本不低于 2.11.1

微信 Windows 版：支持

微信 Mac 版：支持

微信 鸿蒙 OS 版：支持

相关文档: 网络使用说明、局域网通信

功能描述

绑定一个系统随机分配的可用端口，或绑定一个指定的端口号

参数

number port

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

指定要绑定的端口号，不传则返回系统随机分配的可用端口

返回值

number

绑定成功的端口号

示例代码


  const udp = wx.createUDPSocket()
  const port = udp.bind()