小程序創(chuàng)建一個 WebSocket 連接wx.connectSocket
SocketTask wx.connectSocket(Object object)
以 Promise 風(fēng)格 調(diào)用:不支持
創(chuàng)建一個 WebSocket 連接。使用前請注意閱讀相關(guān)說明。推薦使用 SocketTask 的方式去管理 webSocket 鏈接,每一條鏈路的生命周期都更加可控。同時存在多個 webSocket 的鏈接的情況下使用 wx 前綴的方法可能會帶來一些和預(yù)期不一致的情況。
參數(shù)
Object object
屬性 類型 默認(rèn)值 必填 說明 最低版本
url string 是 開發(fā)者服務(wù)器 wss 接口地址
header Object 否 HTTP Header,Header 中不能設(shè)置 Referer
protocols Array.<string> 否 子協(xié)議數(shù)組 1.4.0
tcpNoDelay boolean false 否 建立 TCP 連接的時候的 TCP_NODELAY 設(shè)置 2.4.0
perMessageDeflate boolean false 否 是否開啟壓縮擴(kuò)展 2.8.0
timeout number 否 超時時間,單位為毫秒 2.10.0
success function 否 接口調(diào)用成功的回調(diào)函數(shù)
fail function 否 接口調(diào)用失敗的回調(diào)函數(shù)
complete function 否 接口調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會執(zhí)行)
返回值
SocketTask
基礎(chǔ)庫 1.7.0 開始支持,低版本需做兼容處理。
WebSocket 任務(wù)
并發(fā)數(shù)
1.7.0 及以上版本,最多可以同時存在 5 個 WebSocket 連接。
1.7.0 以下版本,一個小程序同時只能有一個 WebSocket 連接,如果當(dāng)前已存在一個 WebSocket 連接,會自動關(guān)閉該連接,并重新創(chuàng)建一個 WebSocket 連接。
示例代碼
wx.connectSocket({
url: 'wss://example.qq.com',
header:{
'content-type': 'application/json'
},
protocols: ['protocol1']
})
作者:大學(xué)生新聞網(wǎng) 來源:大學(xué)生新聞網(wǎng)