微信小程序webSocket的使用方法
(编辑：jimmy 日期: 2024/11/16 浏览：2)
博客简介
本篇博客介绍微信小程序中webSocket的使用方法，以及如何用局部网络建立webSocket连接，进行客户端与服务器之间的对话：
- webSocket简介
- 微信小程序端API调用
- 服务器端使用nodejs配置
- 演示websocket
webSocket简介
WebSocket 是 HTML5 开始提供的一种在单个 TCP 连接上进行全双工通讯的协议。WebSocket 使得客户端和服务器之间的数据交换变得更加简单，允许服务端主动向客户端推送数据。在 WebSocket API 中，浏览器和服务器只需要完成一次握手，两者之间就直接可以创建持久性的连接，并进行双向数据传输。在 WebSocket API 中，浏览器和服务器只需要做一个握手的动作，然后，浏览器和服务器之间就形成了一条快速通道。两者之间就直接可以数据互相传送。
现在，很多网站为了实现推送技术，所用的技术都是 Ajax 轮询。轮询是在特定的的时间间隔（如每1秒），由浏览器对服务器发出HTTP请求，然后由服务器返回最新的数据给客户端的浏览器。这种传统的模式带来很明显的缺点，即浏览器需要不断的向服务器发出请求，然而HTTP请求可能包含较长的头部，其中真正有效的数据可能只是很小的一部分，显然这样会浪费很多的带宽等资源。HTML5 定义的 WebSocket 协议，能更好的节省服务器资源和带宽，并且能够更实时地进行通讯。
微信小程序端API调用
微信小程序端需要做的配置有：
- 获取局部网络的地址
- SocketTask wx.connectSocket创建一个 WebSocket 连接。
- wx.onSocketOpen(function callback)监听 WebSocket 连接打开事件
- wx.sendSocketMessage(Object object) 连接发送数据。
- wx.onSocketMessage(function callback)监听 WebSocket 接受到服务器的消息事件
（1）获取局部网络的地址IP
获取局部网络的IP十分简单，打开设置，进入网络，点击WiFi属性，在IPv4右侧就能看见IP地址然后，在IP的前面加上ws://尾部加上3001得到可用的IP：
例如：
ws://199.213.7.102:3001
（2）建立客户端和服务器的链接，并且发送消息，监听服务器回发消息
在wxml部分设置一个按钮，用来获取信息亲切发送消息：
WXML:
<input type="tex" bindchange="sendMessage" class="text" placeholder="请输入消息"></input>
JS部分建立客户端和服务器的链接，并且发送消息，监听服务器回发消息：
//本地服务器地址
var wsApi = "ws://199.213.7.102:3001";
var socketOpen==false;
sendMessage:function(e)
{
var msg=e.detail.value;
if (socketOpen) {
console.log(msg);
//向服务器发送消息
wx.sendSocketMessage({
data: msg
})
}
},
onLoad: function (options) {
//建立连接
wx.connectSocket({
url: wsApi,
header: {
'content-type': 'application/json'
},
//method:"GET",
protocols: ['protocol1'],
success: function () {
console.log("客户端连接成功！");
wx.onSocketOpen(function(){
console.log('webSocket已打开！');
socketOpen=true;
wx.onSocketMessage(function(msg){
console.log(msg);
})
})
}
})
},
服务器端使用nodejs配置
服务器这里用的是nodejs来配置，当然你也可以用其他后端语言来处理。假设你已经安装好了nodejs，那么我们开始吧：
- 创建nodejs环境
- 引入ws模块的构造函数并且实例化
- 监听前端发送的消息
- 回发消息
（1）创建nodejs环境
- 首先新建一个文件夹websocket
- window+R，输入cmd
- 输入cd 空格后将websocket直接拖拽到黑框内（或者cd 路径）进入websocket文件夹
- 接着输入npm install ws建立环境
- 回车之后就能看到目录下生成了文件，环境就生成完毕，接下来就要写服务端的代码了
（2）引入ws模块的构造函数并且实例化
在websocket下创建一个文件server.js，用来编写nodejs代码，首先我们要引入ws模块的构造函数并且实例化：
引入ws模块的构造函数并且实例化：
//引入ws模块的构造函数
var webSocketServer=require("ws").Server;
//实例化
var wss=new webSocketServer({
port:3001
});
（3）监听前端发送的消息
继续编写server.js，监听前端发送的消息：
- wss.on(“connection”,function(ws)
- ws.on(“message”,function(msg)
//引入ws模块的构造函数
var webSocketServer=require("ws").Server;
//实例化
var wss=new webSocketServer({
port:3001
});
//监听客户端连接
wss.on("connection",function(ws){
console.log("服务器连接建立成功");
//监听客户端消息
ws.on("message",function(msg){
console.log(msg);
ws.send("来自客户端的消息："+msg);
})
});
（4）回发消息
服务器接收消息之后，还要具备回发消息的能力，给客户端反馈消息，至于返回什么消息，不是我们这里要讨论的，我们直接简单的将客户发送的消息回发回去即可：
ws.send(“来自客户端的消息：”+msg)
//引入ws模块的构造函数
var webSocketServer=require("ws").Server;
//实例化
var wss=new webSocketServer({
port:3001
});
//监听客户端连接
wss.on("connection",function(ws){
console.log("服务器连接建立成功");
//监听客户端消息
ws.on("message",function(msg){
console.log(msg);
ws.send("来自客户端的消息："+msg);
})
});
演示websocket
最后我们简单地演示一下：
- 在cmd中继续输入：node server.js，运行server.js代码
- 在微信开发者工具中编译，运行小程序
- 输入消息，观察反馈
（1）小程序和服务器建立连接
小程序和服务器建立连接后显示：
服务器端显示建立成功
（2）小程序向服务器发送给消息
在文本框中输入内容，发送消息，服务器接收到后：
小程序获取到服务器回发的消息：
