2023年微信小程序API UDP通信
作者: --时间: 2025-06-27 07:37:44
阅读量:
微信小程序API UDP通信
如果你正在寻找一种高效可靠的方式来实现客户端与服务器之间的通信,那么UDP通信是一个不错的选择。微信小程序提供了UDPSocket API,它可以让你轻松创建一个UDP Socket实例,并进行消息的发送和接收。
UDPSocket wx.createUDPSocket()
基础库 2.7.0 开始支持,低版本需做兼容处理。
通过wx.createUDPSocket()函数可以生成一个UDP Socket实例,该函数在基础库2.7.0以上版本开始支持,如果使用较低版本需要先进行兼容处理。
UDPSocket.bind(number port)
绑定UDP Socket实例到指定的端口,默认使用IPv4协议。若未传入参数,则返回系统随机分配的可用端口。
UDPSocket.send(Object object)
向指定的地址和端口发送消息。object参数具有以下属性:
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
address | string | 是 | 要发消息的地址。在基础库 2.9.3 及之前版本可以是一个和本机同网段的 IP 地址,也可以是在安全域名列表内的域名地址;在基础库 2.9.4 及之后版本,可以是任意 IP 和域名 | |
port | number | 是 | 要发送消息的端口号 | |
message | string/ArrayBuffer | 是 | 要发送的数据 | |
offset | number | 0 | 否 | 发送数据的偏移量,仅当 message 为 ArrayBuffer 类型时有效 |
length | number | message.byteLength | 否 | 发送数据的长度,仅当 message 为 ArrayBuffer 类型时有效 |
UDPSocket.onMessage(function callback)
监听收到消息的事件。callback回调函数中包含参数res,具有以下属性:
属性 | 类型 | 说明 |
---|---|---|
message | ArrayBuffer | 收到的消息 |
remoteInfo | Object | 消息来源的结构化信息 |
UDPSocket.close()
关闭UDP Socket实例,相当于销毁。在关闭之后,UDP Socket 实例不能再发送消息,每次调用 UDPSocket.send 将会触发错误事件,并且 message 事件回调函数也不会再被执行。在 UDPSocket 实例被创建后将被 Native 强引用,保证其不