wx.connectSocket(OBJECT)

創(chuàng)建一個(gè) WebSocket 連接；一個(gè)微信小程序同時(shí)只能有一個(gè) WebSocket 連接，如果當(dāng)前已存在一個(gè) WebSocket 連接，會(huì)自動(dòng)關(guān)閉該連接，并重新創(chuàng)建一個(gè) WebSocket 連接。

OBJECT參數(shù)說明：

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

wx.onSocketOpen(CALLBACK)

監(jiān)聽WebSocket連接打開事件。

示例代碼：

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

wx.onSocketError(CALLBACK)

監(jiān)聽WebSocket錯(cuò)誤。

示例代碼：

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

wx.sendSocketMessage(OBJECT)

通過 WebSocket 連接發(fā)送數(shù)據(jù)，需要先 wx.connectSocket，并在 wx.onSocketOpen 回調(diào)之后才能發(fā)送。

OBJECT參數(shù)說明：

示例代碼：

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)

監(jiān)聽WebSocket接受到服務(wù)器的消息事件。

CALLBACK返回參數(shù)：

示例代碼：

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

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

wx.closeSocket(OBJECT)

關(guān)閉WebSocket連接。

wx.onSocketClose(CALLBACK)

監(jiān)聽WebSocket關(guān)閉。

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

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

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

Bug & Tip

1. tip: createSocket 鏈接默認(rèn)和最大超時(shí)時(shí)間都是 60s
2. tip: 網(wǎng)絡(luò)請(qǐng)求的 referer 是不可以設(shè)置的，格式固定為 https://servicewechat.com/{appid}/{version}/page-frame.html，其中{appid}為小程序的 appid，{version}為小程序的版本號(hào)，版本號(hào)為 0 表示為開發(fā)版。