博客简介
本篇博客介绍微信小程序中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)小程序向服务器发送给消息
在文本框中输入内容,发送消息,服务器接收到后:
小程序获取到服务器回发的消息: