wx.connectSocket(OBJECT)

創建一個 WebSocket 連接；一個微信小程序同時只能有一個 WebSocket 連接，如果當前已存在一個 WebSocket 連接，會自動關閉該連接，并重新創建一個 WebSocket 連接。

OBJECT參數說明：

wx.connectSocket({  
  url: 'test.php',
  data:{
    x: '',
    y: ''
  },
  header:{ 
    'content-type': 'application/json'
  },  protocols: ['protocol1'],
  method:"GET"
})

wx.onSocketOpen(CALLBACK)

監聽WebSocket連接打開事件。

示例代碼：

wx.connectSocket({
  url: 'test.php'
})
wx.onSocketOpen(function(res) {
  console.log('WebSocket連接已打開！')
})

wx.onSocketError(CALLBACK)

監聽WebSocket錯誤。

示例代碼：

wx.connectSocket({
  url: 'test.php'
})
wx.onSocketOpen(function(res){
  console.log('WebSocket連接已打開！')
})
wx.onSocketError(function(res){
  console.log('WebSocket連接打開失敗，請檢查！')
})

wx.sendSocketMessage(OBJECT)

通過 WebSocket 連接發送數據，需要先 wx.connectSocket，并在 wx.onSocketOpen 回調之后才能發送。

OBJECT參數說明：

示例代碼：

var socketOpen = false
var socketMsgQueue = []
wx.connectSocket({
  url: 'test.php'
})

wx.onSocketOpen(function(res) {
  socketOpen = true
  for (var i = 0; i < socketMsgQueue.length; i++){
     sendSocketMessage(socketMsgQueue[i])
  }
  socketMsgQueue = []
})

function sendSocketMessage(msg) {
  if (socketOpen) {
    wx.sendSocketMessage({
      data:msg
    })
  } else {
     socketMsgQueue.push(msg)
  }
}

wx.onSocketMessage(CALLBACK)

監聽WebSocket接受到服務器的消息事件。

CALLBACK返回參數：

示例代碼：

wx.connectSocket({
  url: 'test.php'
})

wx.onSocketMessage(function(res) {
  console.log('收到服務器內容：' + res.data)
})

wx.closeSocket(OBJECT)

關閉WebSocket連接。

wx.onSocketClose(CALLBACK)

監聽WebSocket關閉。

wx.connectSocket({
  url: 'test.php'
})

//注意這里有時序問題，
//如果 wx.connectSocket 還沒回調 wx.onSocketOpen，而先調用 wx.closeSocket，那么就做不到關閉 WebSocket 的目的。
//必須在 WebSocket 打開期間調用 wx.closeSocket 才能關閉。
wx.onSocketOpen(function() {
  wx.closeSocket()
})

wx.onSocketClose(function(res) {
  console.log('WebSocket 已關閉！')
})

Bug & Tip

1. tip: createSocket 鏈接默認和最大超時時間都是 60s
2. tip: 網絡請求的 referer 是不可以設置的，格式固定為 https://servicewechat.com/{appid}/{version}/page-frame.html，其中{appid}為小程序的 appid，{version}為小程序的版本號，版本號為 0 表示為開發版。