当前位置：首页 > news >正文

【QT】Qt中Websocket的使用

news 2026/4/9 13:35:22

一、WebSocket的定义

WebSocket是一种在单个TCP连接上进行全双工通信的协议。WebSocket通信协议于2011年被IETF定为标准RFC 6455，并由RFC7936补充规范。WebSocket API也被W3C定为标准。

WebSocket使得客户端和服务器之间的数据交换变得更加简单，允许服务端主动向客户端推送数据。想对应http协议来说，websocket更加的平等，在http协议中，只有客户端向服务器发送申请请求之后，服务器才会返回请求的数据，如果要保证实时性的话，就需要不断地轮询，每隔一段时间就向服务器发送一个请求，这样就会造成很大的开销，而WebSocket服务器主动向客户端发送数据，而不需要申请，客户端发送数据给服务器也是如此

简单来说，就是浏览器和服务器之间通信的一种协议，相比较http来说，数据交换更加平等，开销更小；

二、服务器和客户端

要想在Qt实现websocket那么我们主要的就是实现一个服务器，由网页实现一个客户端

2.1 服务器的实现

要实现服务器，首先要认识QWebSocketServer Class，我们需要通过这个类实现

1）类分析

从上图可以知道，需要在.pro文件中添加QT+=websockets，然后添加头文件，新建一个WebSocketTest窗口应用程序，试图如下

2）添加库

在WebSocketTest中添加下面的语句

QT       += websockets

3）添加头文件

在websockettest.h中添加头文件，声明变量

#ifndef WEBSOCKETTEST_H
#define WEBSOCKETTEST_H#include <QWidget>
#include <QWebSocketServer>QT_BEGIN_NAMESPACE
namespace Ui { class WebSocketTest; }
QT_END_NAMESPACEclass WebSocketTest : public QWidget
{Q_OBJECTpublic:WebSocketTest(QWidget *parent = nullptr);~WebSocketTest();private:Ui::WebSocketTest *ui;//声明QWebSocketServer变量QWebSocketServer *web_server;};
#endif // WEBSOCKETTEST_H

4）QWebSocketServer类的使用

再来看一看关于这个类的使用，类名上面F1进入帮助界面，可以看到

翻译过来就是

QWebSocketServer是一个基于QTcpServer模型的类，用于处理WebSocket协议的服务器端通信。如果你知道如何使用QTcpServer，你就可以很轻松的使用QWebSocketServer。

QWebSocketServer类主要用于接收并处理来自客户端的WebSocket连接，你可以手动设定服务端的端口，也可以让QWebSocketServer自动选择。调用listen()函数即可让服务器开始侦听连接请求。

每当有新的客户端尝试连接服务器时，newConnection()信号就会发出。服务器可以调用nextPendingConnection()方法接受这个握手请求，同时返回一个已经连接状态的QWebSocket对象指针，服务器即可通过这个指针和客户端进行通信。

如果在过程中发生错误，serverError()方法可以获取错误类型，同时可以调用errorString()方法获取人类可读的错误描述。

当服务器侦听连接请求时，可以通过serverAddress()和serverPort()来获取服务器正在侦听的地址和端口。调用close()函数可以使QWebSocketServer停止侦听连接请求。

QWebSocketServer当前还不支持WebSocket拓展和WebSocket子协议。该类仅支持RFC 6455中规定的WebSocket协议的13版。

有一个默认的握手超时设置为10秒，主要用于防止拒绝服务攻击，该超时时间可以通过setHandshakeTimeout()自定义。

参见WebSocket Server Example和QWebSocket。

也就是说使用listen函数监听连接请求，一旦有新的客户端连接，就可以触发newConnection()信号，再由服务器通过nextPendingConnection()方法接收这个客户端的连接，这个方法返回一个QWebsocket的对象指针，通过这个指针就可以和客户端通信了

5）代码实现

首先客户端代码我这里直接提供一个可以测试的html，新建一个文本文件，将下面内容复制进去，保存后，将后缀改为html,点击使用浏览器打开。

<!DOCTYPE html>
<html>
<head>
<title>WebSocket Test</title>
<style>#testButton {display: block;margin: 20px auto;padding: 10px 20px;font-size: 16px;}#messageDisplay {margin: 20px auto;padding: 10px;border: 1px solid #ccc;width: 80%;height: 200px;overflow-y: scroll;font-size: 14px;}
</style>
</head>
<body>
<button id="testButton">Send Test Message</button>
<div id="messageDisplay"></div><script>
var ws = new WebSocket('ws://localhost:15678');ws.onopen = function() {console.log('WebSocket connection opened.');
};ws.onmessage = function(event) {console.log('Message from server:', event.data);var messageDisplay = document.getElementById('messageDisplay');messageDisplay.innerHTML += '<p>' + event.data + '</p>';
};ws.onerror = function(error) {console.error('WebSocket error:', error);
};ws.onclose = function() {console.log('WebSocket connection closed.');
};document.getElementById('testButton').onclick = function() {ws.send('Test');console.log('Test message sent.');
};
</script>
</body>
</html>

服务器相关代码

构造函数

 web_server = new QWebSocketServer("Myserver",QWebSocketServer::NonSecureMode,this);if(web_server->listen(QHostAddress::Any,15678)){qDebug()<<"开始监听";connect(web_server,&QWebSocketServer::newConnection,this,&WebSocketTest::newCilentConnect);}

槽函数

void WebSocketTest::newCilentConnect()
{//返回客户端web_client = web_server->nextPendingConnection();qDebug() << "有新的 WebSocket 客户端连接。";}

编译运行服务器，然后点击html文件，可以发现会打印”有新的 WebSocket 客户端连接“；

6）接收客户端的消息

void WebSocketTest::newCilentConnect()
{//返回客户端web_client = web_server->nextPendingConnection();qDebug() << "有新的 WebSocket 客户端连接。";// 处理接收到的消息connect(web_client , &QWebSocket::textMessageReceived, this, &WebSocketTest::onTextMessageReceived);}void WebSocketTest::onTextMessageReceived(const QString &message)
{qDebug() << "收到客户端消息：" << message;if(message=="Test"){/*在这里执行你实现的操作，如网页一个按钮，点击后发送打开摄像头信息给服务器，服务器执行打开摄像头的操作*/}
}

编译运行，点击网页上的按钮，服务器就可以收到这个消息了；

2.2 客户端的实现

到前面为止就可以实现客户端发送数据到服务器的操作，现在实现服务器发送数据给客户端


// 向客户端发送数据
void WebSocketTest::sendClientData(const QString &str)
{if (web_client->isValid()) {web_client->sendTextMessage(str);}
}

然后在界面上添加一个按钮发送信息给客户端


void WebSocketTest::on_btn_send_clicked()
{sendClientData("Hello");
}

编译运行，刷新网页后，点击按钮查看效果

三、完整源码

websocket.c

#include "websockettest.h"
#include "ui_websockettest.h"WebSocketTest::WebSocketTest(QWidget *parent): QWidget(parent), ui(new Ui::WebSocketTest)
{ui->setupUi(this);// 创建 WebSocket 服务器web_server = new QWebSocketServer("Myserver",QWebSocketServer::NonSecureMode,this);//监听if(web_server->listen(QHostAddress::Any,15678)){qDebug()<<"开始监听";connect(web_server,&QWebSocketServer::newConnection,this,&WebSocketTest::newCilentConnect);}}void WebSocketTest::newCilentConnect()
{web_client = web_server->nextPendingConnection();qDebug() << "有新的 WebSocket 客户端连接。";// 处理客户端断开连接connect(web_client, &QWebSocket::disconnected, this, [this, web_client]() {qDebug() << "WebSocket 客户端断开连接。";web_client->deleteLater();});// 处理接收到的消息connect(web_client, &QWebSocket::textMessageReceived, this, &WebSocketTest::onTextMessageReceived);}
void WebSocketTest::onTextMessageReceived(const QString &message)
{qDebug() << "收到客户端消息：" << message;}// 向客户端发送数据
void WebSocketTest::sendClientData(const QString &str)
{if (web_client->isValid()) {web_client->sendTextMessage(str);}
}void WebSocketTest::on_btn_send_clicked()
{sendClientData("Hello");
}WebSocketTest::~WebSocketTest()
{delete ui;
}

websocket.h

#ifndef WEBSOCKETTEST_H
#define WEBSOCKETTEST_H#include <QWidget>
#include <QWebSocketServer>
#include <QDebug>
#include <QWebSocket>QT_BEGIN_NAMESPACE
namespace Ui { class WebSocketTest; }
QT_END_NAMESPACEclass WebSocketTest : public QWidget
{Q_OBJECTpublic:WebSocketTest(QWidget *parent = nullptr);~WebSocketTest();private:Ui::WebSocketTest *ui;//声明QWebSocketServer变量  服务器QWebSocketServer *web_server;//客户端QWebSocket* web_client;private slots://客户端连接槽函数void newCilentConnect();//接收新客户端消息函数void onTextMessageReceived(const QString &message);//发送消息给客户端函数void on_btn_send_clicked();private://发送消息给客户端void sendClientData(const QString &str);};
#endif // WEBSOCKETTEST_H

websocket.html

<!DOCTYPE html>
<html>
<head>
<title>WebSocket Test</title>
<style>#testButton {display: block;margin: 20px auto;padding: 10px 20px;font-size: 16px;}#messageDisplay {margin: 20px auto;padding: 10px;border: 1px solid #ccc;width: 80%;height: 200px;overflow-y: scroll;font-size: 14px;}
</style>
</head>
<body>
<button id="testButton">Send Test Message</button>
<div id="messageDisplay"></div><script>
var ws = new WebSocket('ws://localhost:15678');ws.onopen = function() {console.log('WebSocket connection opened.');
};ws.onmessage = function(event) {console.log('Message from server:', event.data);var messageDisplay = document.getElementById('messageDisplay');messageDisplay.innerHTML += '<p>' + event.data + '</p>';
};ws.onerror = function(error) {console.error('WebSocket error:', error);
};ws.onclose = function() {console.log('WebSocket connection closed.');
};document.getElementById('testButton').onclick = function() {ws.send('Test');console.log('Test message sent.');
};
</script>
</body>
</html>