connectsocket是什么,微信小程序APIWebsocket
2017-12-22
導(dǎo)讀:wx.connectSocket(OBJECT) 創(chuàng)建一個 WebSocket 連接; 一個微信小程序同時只能有一個 WebSocket 連接,如果當(dāng)前已存在一個 WebSocket 連接,會自動關(guān)閉該連接,并重新創(chuàng)建一個 WebSocket 連接。 OBJE...
wx.connectSocket(OBJECT)
創(chuàng)建一個 WebSocket 連接;一個微信小程序同時只能有一個 WebSocket 連接,如果當(dāng)前已存在一個 WebSocket 連接,會自動關(guān)閉該連接,并重新創(chuàng)建一個 WebSocket 連接。
OBJECT參數(shù)說明:
參數(shù) | 類型 | 必填 | 說明 | 最低版本 |
---|---|---|---|---|
url | String | 是 | 開發(fā)者服務(wù)器接口地址,必須是 wss 協(xié)議,且域名必須是后臺配置的合法域名 | |
data | Object | 否 | 請求的數(shù)據(jù) | |
header | Object | 否 | HTTP Header , header 中不能設(shè)置 Referer | |
method | String | 否 | 默認(rèn)是GET,有效值: OPTIONS, GET, HEAD, POST, PUT, DELETE, TRACE, CONNECT | |
protocols | StringArray | 否 | 子協(xié)議數(shù)組 | 1.4.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í)行) |
示例代碼:
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ā)送數(shù)據(jù),需要先 wx.connectSocket,并在 wx.onSocketOpen 回調(diào)之后才能發(fā)送。
OBJECT參數(shù)說明:
參數(shù) | 類型 | 必填 | 說明 |
---|---|---|---|
data | String/ArrayBuffer | 是 | 需要發(fā)送的內(nèi)容 |
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í)行) |
示例代碼:
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ù):
參數(shù) | 類型 | 說明 |
---|---|---|
data | String/ArrayBuffer | 服務(wù)器返回的消息 |
示例代碼:
wx.connectSocket({
url: 'test.php'
})
wx.onSocketMessage(function(res) {
console.log('收到服務(wù)器內(nèi)容:' + res.data)
})
wx.closeSocket(OBJECT)
關(guān)閉WebSocket連接。
參數(shù) | 類型 | 必填 | 說明 | 最低版本 |
---|---|---|---|---|
code | Number | 否 | 一個數(shù)字值表示關(guān)閉連接的狀態(tài)號,表示連接被關(guān)閉的原因。如果這個參數(shù)沒有被指定,默認(rèn)的取值是1000 (表示正常連接關(guān)閉) | 1.4.0 |
reason | String | 否 | 一個可讀的字符串,表示連接被關(guān)閉的原因。這個字符串必須是不長于123字節(jié)的UTF-8 文本(不是字符) | 1.4.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í)行) |
wx.onSocketClose(CALLBACK)
監(jiān)聽WebSocket關(guān)閉。
wx.connectSocket({
url: 'test.php'
})
//注意這里有時序問題,
//如果 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
-
tip
: createSocket 鏈接默認(rèn)和最大超時時間都是 60s -
tip
: 網(wǎng)絡(luò)請求的 referer 是不可以設(shè)置的,格式固定為 https://servicewechat.com/{appid}/{version}/page-frame.html,其中{appid}
為小程序的 appid,{version}
為小程序的版本號,版本號為 0 表示為開發(fā)版。
第二部分:如何開通一個小商店