注冊

connectsocket是什么,微信小程序APIWebsocket

2017-12-22
導讀:wx.connectSocket(OBJECT) 創(chuàng)建一個 WebSocket 連接; 一個微信小程序同時只能有一個 WebSocket 連接,如果當前已存在一個 WebSocket 連接,會自動關閉該連接,并重新創(chuàng)建一個 WebSocket 連接。 OBJE...

wx.connectSocket(OBJECT)


創(chuàng)建一個 WebSocket 連接;一個微信小程序同時只能有一個 WebSocket 連接,如果當前已存在一個 WebSocket 連接,會自動關閉該連接,并重新創(chuàng)建一個 WebSocket 連接。

OBJECT參數說明:

 

 

參數 類型 必填 說明 最低版本
url String 開發(fā)者服務器接口地址,必須是 wss 協(xié)議,且域名必須是后臺配置的合法域名  
data Object 請求的數據  
header Object HTTP Header , header 中不能設置 Referer  
method String 默認是GET,有效值: OPTIONS, GET, HEAD, POST, PUT, DELETE, TRACE, CONNECT  
protocols StringArray 子協(xié)議數組 1.4.0
success Function 接口調用成功的回調函數  
fail Function 接口調用失敗的回調函數  
complete Function 接口調用結束的回調函數(調用成功、失敗都會執(zhí)行)  

 

示例代碼:
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錯誤。

示例代碼:

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

wx.sendSocketMessage(OBJECT)


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

OBJECT參數說明:

參數 類型 必填 說明
data String/ArrayBuffer 需要發(fā)送的內容
success Function 接口調用成功的回調函數
fail Function 接口調用失敗的回調函數
complete Function 接口調用結束的回調函數(調用成功、失敗都會執(zhí)行)

示例代碼:

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接受到服務器的消息事件。

CALLBACK返回參數:

參數 類型 說明
data String/ArrayBuffer 服務器返回的消息

示例代碼:

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

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

wx.closeSocket(OBJECT)


關閉WebSocket連接。

 

參數 類型 必填 說明 最低版本
code Number 一個數字值表示關閉連接的狀態(tài)號,表示連接被關閉的原因。如果這個參數沒有被指定,默認的取值是1000 (表示正常連接關閉) 1.4.0
reason String 一個可讀的字符串,表示連接被關閉的原因。這個字符串必須是不長于123字節(jié)的UTF-8 文本(不是字符) 1.4.0
success Function 接口調用成功的回調函數  
fail Function 接口調用失敗的回調函數  
complete Function 接口調用結束的回調函數(調用成功、失敗都會執(zhí)行)  

 


wx.onSocketClose(CALLBACK)


監(jiān)聽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 表示為開發(fā)版。
更多微信小程序開發(fā)教程,可以關注hi小程序。
重磅推薦:小程序開店目錄

第一部分:小商店是什么

第二部分:如何開通一個小商店

第三部分:如何登錄小商店

第四部分:開店任務常見問題

第五部分:小商店可以賣什么

第六部分:HiShop小程序特色功能

第七部分:小程序直播

第八部分:小程序收貨/物流

第九部分:小程序怎么結算

第十部分:小程序客服

第十一部分:電商創(chuàng)業(yè)

第十二部分:小程序游戲開發(fā)