推荐使用 SocketTask 的方式来管理 WebSocket 连接,这样每条链路的生命周期都更加可控。如果同时存在多个 WebSocket 连接,使用 wx 前缀的方法可能会遇到一些和预期不一致的情况。
以 Promise 风格 调用:支持
微信小程序插件:不支持
微信 Windows 版:支持
微信 Mac 版:支持
微信 鸿蒙 OS 版:支持
相关文档: 网络使用说明、局域网通信
功能描述
通过 WebSocket 连接发送数据。需要先调用 wx.connectSocket,并在 wx.onSocketOpen 回调之后才能发送。
参数
Object object
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| data | string/ArrayBuffer | 是 | 需要发送的内容 | |
| success | function | 否 | 接口调用成功的回调函数 | |
| fail | function | 否 | 接口调用失败的回调函数 | |
| complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
示例代码
let socketOpen = false
let socketMsgQueue = []
wx.connectSocket({
url: 'test.php'
})
wx.onSocketOpen(function(res) {
socketOpen = true
for (let i = 0; i < socketMsgQueue.length; i++){
sendSocketMessage(socketMsgQueue[i])
}
socketMsgQueue = []
})
function sendSocketMessage(msg) {
if (socketOpen) {
wx.sendSocketMessage({
data:msg
})
} else {
socketMsgQueue.push(msg)
}
}