WebSocket 是(shì)一種在(zài)單個(gè) TCP 連接上(shàng)進行全雙工通訊的(de)協議。 在(zài) WebSocket API 中，浏覽器和(hé / huò)服務器隻需要(yào / yāo)完成一次握手，兩者之(zhī)間就(jiù)直接可以(yǐ)建立持久性的(de)連接，并進行雙向數據傳輸。

HTML5 支持 WebSocket ，使用方法和(hé / huò)小程序的(de) WebSocket 基本是(shì)一樣的(de)。 WebSocket API 由若幹個(gè)方法和(hé / huò)若幹個(gè)事件組成。這(zhè)些方法和(hé / huò)事件如下：

方法

• wx.connectSocket ：與服務端建立連接

• wx.sendSocketMessage ：向服務端發送數據

• wx.closeSocket ：關閉連接

事件

• wx.onSocketOpen ：成功與服務端建立連接後觸發的(de)事件

• wx.onSocketError ：與服務端建立連接失敗後觸發的(de)事件

• wx.onSocketMessage ：服務端返回響應消息後觸發的(de)事件

• wx.onSocketClose ：成功關閉 WebSocket 連接後觸發的(de)事件

其中 wx.connectSocket 和(hé / huò) wx.sendSocketMessage 方法都有一個(gè) Object 類型的(de)參數，參數屬性含義如下所示。

wx.connectSocket 方法參數描述

• url ： String 類型，必選，開發者服務器接口地(dì / de)址，必須是(shì) wss 協議，且域名必須是(shì)後台配置的(de)合法域名

• data ： Object 類型，可選，請求的(de)數據

• header ： Object 類型，可選， HTTPS Header , header 中不(bù)能設置 Referer

• method ：        S