一、前言
在技術的長河中探索,有些目標一旦確立,便如同璀璨星辰,指引著我們不斷前行。早在2014年,我心中就種下了用純Qt實現GB28181協議的種子,如今回首,一晃十年已逝,好在整體框架和邏輯終于打通,個中滋味,只有自己知曉。
最初接觸GB28181協議時,我就發現它遠比熟悉的onvif協議復雜。onvif協議在局域網內表現出色,配置簡單、使用方便,很多安防設備在局域網環境下借助onvif協議能輕松實現設備間的互聯互通。然而,當涉及外網訪問時,onvif就顯得力不從心,幾乎找不到有效的解決辦法。在如今監控設備遍布大街小巷,各部門機構都急需外網遠程取流的大環境下,GB28181協議應運而生。它作為一套視頻監控規范,旨在解決外網訪問監控視頻的諸多痛點。但GB28181協議也面臨著網絡通信的固有難題,比如服務端在未收到客戶端消息時,無法知曉客戶端的具體通信地址,這就導致雙方無法直接通信,必須由客戶端主動向服務器發送消息來建立聯系。
在實現GB28181協議的過程中,選擇何種方式解析SIP協議是關鍵。市面上關于SIP協議的第三方庫五花八門,功能看似完備。但經過深思熟慮,我最終決定采用Qt底層的udp通信協議來進行解析。這么做主要有兩方面的考量。一方面,從底層入手能讓我更深入地理解協議的每一個細節。在解析過程中,我可以根據實際需求打造友好的使用接口,避免了使用第三方庫時可能遇到的各種問題,比如繁瑣的編譯過程,不同版本庫之間的兼容性難題等。另一方面,考慮到項目后期的拓展性,從底層“手擼”代碼是最好的選擇。只有牢牢掌握底層實現,才能靈活應對各種新需求和新場景,將兼容性和易用性放在首位。畢竟,只有真正解決了客戶在使用過程中的痛點,產品才有市場價值。
二、效果圖
三、相關地址
- 國內站點:https://gitee.com/feiyangqingyun
- 國際站點:https://github.com/feiyangqingyun
- 個人作品:https://blog.csdn.net/feiyangqingyun/article/details/97565652
- 文件地址:https://pan.baidu.com/s/1d7TH_GEYl5nOecuNlWJJ7g 提取碼:01jf 文件名:bin_video_gb28181。
四、功能特點
- 支持設備注冊、注銷、心跳、校時、注冊認證、注銷認證等。
- 設備上線后可以手動獲取設備狀態、設備信息、配置信息、預置位信息等。
- 設備上線后自動獲取設備通道信息,包括中文通道名稱。識別到通道上線離線變化,會重新獲取該設備的所有通道信息。
- 支持視頻點播,可以分別點播主碼流和子碼流,內置rtp解包線程,解包后發給視頻播放組件解碼播放。
- 每個設備每個通道支持點播多個視頻,通過ssrc區分,支持共用端口和不同端口收流。
- 支持對某個設備下面所有通道、某個通道、某個通道對應的某個流分別關閉。
- 支持錄像文件查詢和回放,回放控制支持暫停播放、繼續播放、倍速播放、切換播放進度。
- 支持錄像文件下載,支持倍速比如8倍速下載,可同時多線程批量下載。
- 回放和下載同時支持IPC和NVR,比如攝像頭自帶的SD存儲卡錄像文件回放,NVR上的硬盤錄像文件回放。
- 支持云臺控制,向上、向下、向左、向右、左上、右上、左下、右下方位移動,鏡頭放大縮小,光圈放大縮小,鏡頭聚焦放焦。
- 支持預置位信息的查詢、調用、添加、修改、刪除等操作。
- 自動目錄訂閱功能,通道上線下線都有對應的信號通知。
- 支持警情訂閱,各種警情事件比如運動目標檢測報警、入侵檢測報警、徘徊檢測報警等自動上報。
- 國標服務同時支持udp和tcp方式,可選只監聽一種或者兩種都監聽,tcp方式自動處理粘包問題。
- 收流端口自動糾錯,自動跳過被占用的端口,不會出現端口占用導致收流失敗的情況。
- 支持幾千路國標消息交互并發,實時視頻流支持64路同時顯示,可以拓展更多路數。
- 支持阿里云等云服務器,可以分別設置內網監聽地址和外網訪問地址,一般云服務器上是監聽地址用內網,對外訪問用外網地址。
- 支持視頻分發,也就是推流,視頻通道打開后可以自動推流到流媒體服務器,其他需要的地方拉流即可,支持rtsp、rtmp、hls、webrtc等方式拉流。
- SIP解析和交互采用純Qt底層代碼實現,udp/tcp通信交互,祖傳原創代碼解析,不依賴任何第三方。
- 代碼量少,gb28181交互部分共幾千行代碼,注釋詳細,接口友好,使用極其簡單,提供非常詳細的使用示例。
- 支持海康、大華、宇視、華為、天地偉業等所有國標設備。
- 支持所有Qt版本和編譯器以及操作系統,包括但不限于win、linux、mac、android、嵌入式linux、樹莓派香橙派、國產os等。
五、相關代碼
#include "frmconfig.h"
#include "frmserver.h"
#include "ui_frmserver.h"
#include "qthelper.h"
#include "apphelper.h"
#include "rtpthread.h"
#include "gb28181server.h"
#include "gb28181helper.h"frmServer::frmServer(QWidget *parent) : QWidget(parent), ui(new Ui::frmServer)
{ui->setupUi(this);this->initForm();this->initConfig();
}frmServer::~frmServer()
{delete ui;
}void frmServer::closeEvent(QCloseEvent *)
{if (AppConfig::ServerStart) {on_btnStart_clicked();}qApp->quit();
}void frmServer::initForm()
{ui->tabPlayback->setEnabled(false);ui->tabDownload->setEnabled(false);ui->widgetControl->setEnabled(false);ui->widget->setFixedWidth(AppData::RightWidth);connect(ui->tabPreview, SIGNAL(selectVideo(QString, QString)), this, SLOT(selectVideo(QString, QString)));ui->treeWidget->setAnimated(false);ui->treeWidget->setIndentation(15);ui->treeWidget->setExpandsOnDoubleClick(false);//立即啟動服務server = NULL;if (AppConfig::ServerStart) {on_btnStart_clicked();}
}void frmServer::initConfig()
{ui->tabWidget->setCurrentIndex(AppConfig::TabIndexMain);connect(ui->tabWidget, SIGNAL(currentChanged(int)), this, SLOT(saveConfig()));ui->cboxFlag->addItem(AppConfig::FilterType == 0 ? "00000000000000000000" : "0.0.0.0");ui->cboxFlag->lineEdit()->setText(AppConfig::FilterFlag);connect(ui->cboxFlag->lineEdit(), SIGNAL(textChanged(QString)), this, SLOT(saveConfig()));
}void frmServer::saveConfig()
{AppConfig::TabIndexMain = ui->tabWidget->currentIndex();AppConfig::FilterFlag = ui->cboxFlag->lineEdit()->text();AppConfig::writeConfig();
}void frmServer::receiveEvent(GB28181Event event)
{if (event.alarmMethod != 5) {return;}//設備中的某個通道離線和上線QTreeWidgetItem *itemChannel = AppHelper::findItem(ui->treeWidget, event.deviceId, event.channelId);if (itemChannel) {if (event.alarmInfo == 13) {itemChannel->setDisabled(true);ui->tabPreview->closeVideo(event.deviceId, event.channelId);} else if (event.alarmInfo == 14) {itemChannel->setDisabled(false);}}
}void frmServer::deviceChanged(const QString &deviceId, bool online)
{//關閉對應的畫面if (!online) {ui->tabPreview->closeVideo(deviceId);}QList<GB28181Device> devices = server->getDevices();GB28181Device device = GB28181Helper::getDevice(deviceId, devices);QString text = deviceId + " [" + device.deviceName + "]";QTreeWidgetItem *itemDevice = AppHelper::findItem(ui->treeWidget, deviceId, "");if (itemDevice) {itemDevice->setText(0, text);itemDevice->setDisabled(!online);return;}//不存在則添加頂層節點QTreeWidgetItem *item = new QTreeWidgetItem;item->setText(0, text);item->setData(0, Qt::UserRole, deviceId);ui->treeWidget->insertTopLevelItem(0, item);//添加到下拉框QString flag = (AppConfig::FilterType == 0 ? device.deviceId : device.deviceIp);if (ui->cboxFlag->findText(flag) < 0) {ui->cboxFlag->addItem(flag);}
}void frmServer::channelChanged(const QString &deviceId)
{//每次都清空通道再重新添加QList<GB28181Device> devices = server->getDevices();QTreeWidgetItem *itemDevice = AppHelper::findItem(ui->treeWidget, deviceId, "");if (itemDevice) {qDeleteAll(itemDevice->takeChildren());QStringList ids, names;GB28181Helper::getChannelInfo(deviceId, devices, ids, names);for (int i = 0; i < ids.count(); ++i) {QTreeWidgetItem *itemChannel = new QTreeWidgetItem(itemDevice);itemChannel->setText(0, ids.at(i) + " [" + names.at(i) + "]");itemChannel->setData(0, Qt::UserRole, ids.at(i));}}//通過單次定時器去執行/防止頻繁上線期間卡主界面static QTimer *timer = NULL;if (!timer) {timer = new QTimer(this);connect(timer, SIGNAL(timeout()), this, SLOT(finshed()));timer->setSingleShot(true);timer->setInterval(300);}timer->stop();timer->start();
}void frmServer::finshed()
{//展開所有節點ui->treeWidget->expandAll();//自動調整列寬ui->treeWidget->resizeColumnToContents(0);
}void frmServer::on_btnStart_clicked()
{if (ui->btnStart->text() == "啟動服務") {ui->tabDebug->clear();ui->tabEvent->clear();if (AppConfig::ServerIp == "0.0.0.0") {QtHelper::showMessageBoxError("請先打開系統設置, 選擇網卡地址!");return;}server = new GB28181Server;connect(server, SIGNAL(sendData(QString, int, QString, QString)), ui->tabDebug, SLOT(sendData(QString, int, QString, QString)));connect(server, SIGNAL(receiveData(QString, int, QString, QString)), ui->tabDebug, SLOT(receiveData(QString, int, QString, QString)));connect(server, SIGNAL(receiveInfo(QString, int, QString, QString)), ui->tabDebug, SLOT(receiveInfo(QString, int, QString, QString)));connect(server, SIGNAL(playStart(QString, int, QString, int, int)), ui->tabDebug, SLOT(playStart(QString, int, QString, int, int)));connect(server, SIGNAL(receiveEvent(GB28181Event)), this, SLOT(receiveEvent(GB28181Event)));connect(server, SIGNAL(receiveEvent(GB28181Event)), ui->tabEvent, SLOT(receiveEvent(GB28181Event)));connect(server, SIGNAL(receiveRecord(QList<GB28181Record>)), ui->tabPlayback, SLOT(receiveRecord(QList<GB28181Record>)));connect(server, SIGNAL(receiveRecord(QList<GB28181Record>)), ui->tabDownload, SLOT(receiveRecord(QList<GB28181Record>)));connect(server, SIGNAL(receiveStatus(GB28181Status)), ui->tabPlayback, SLOT(receiveStatus(GB28181Status)));connect(server, SIGNAL(receiveStatus(GB28181Status)), ui->tabDownload, SLOT(receiveStatus(GB28181Status)));connect(server, SIGNAL(deviceChanged(QString, bool)), this, SLOT(deviceChanged(QString, bool)));connect(server, SIGNAL(channelChanged(QString)), this, SLOT(channelChanged(QString)));connect(server, SIGNAL(presetChanged(QStringList, QStringList)), ui->widgetControl, SLOT(presetChanged(QStringList, QStringList)));GB28181ServerPara para;para.serverId = AppConfig::ServerId;para.serverRealm = AppConfig::ServerRealm;para.serverHost = AppConfig::ServerHost;para.serverIp = AppConfig::ServerIp;para.serverPort = AppConfig::ServerPort;para.serverPwd = AppConfig::ServerPwd;para.timeout = AppConfig::Timeout;server->setServerPara(para);server->start((ListenMode)AppConfig::ListenMode);ui->btnStart->setText("停止服務");ui->tabPreview->setServer(server);ui->tabPlayback->setServer(server);ui->tabDownload->setServer(server);ui->widgetControl->setServer(server);ui->tabPlayback->setEnabled(true);ui->tabDownload->setEnabled(true);ui->widgetControl->setEnabled(true);} else {ui->treeWidget->clear();ui->treeWidget->resizeColumnToContents(0);ui->btnStart->setText("啟動服務");ui->tabPreview->closeAll();ui->tabPlayback->closeAll();ui->tabDownload->closeAll();ui->widgetControl->closeAll();ui->tabPlayback->setEnabled(false);ui->tabDownload->setEnabled(false);ui->widgetControl->setEnabled(false);//停頓下處理事件qApp->processEvents();server->stop();server->deleteLater();server = NULL;RtpThread::Port = 6900;}//按鈕觸發的要保存啟動狀態if (sender() == ui->btnStart) {AppConfig::ServerStart = (ui->btnStart->text() == "停止服務");AppConfig::writeConfig();}
}void frmServer::on_btnConfig_clicked()
{static frmConfig *config = new frmConfig;config->show();config->activateWindow();
}void frmServer::selectVideo(const QString &deviceId, const QString &channelId)
{//視頻通道按下自動選中設備通道節點QTreeWidgetItem *itemChannel = AppHelper::selectItem(ui->treeWidget, deviceId, channelId);if (itemChannel) {on_treeWidget_itemClicked(itemChannel, 0);}
}void frmServer::itemClicked(QTreeWidgetItem *item, bool dbClick)
{QString deviceId, channelId;AppHelper::getItemId(item, deviceId, channelId);ui->tabPlayback->setId(deviceId, channelId);ui->tabDownload->setId(deviceId, channelId);ui->widgetControl->setId(deviceId, channelId);if (dbClick) {ui->tabPreview->openVideo(deviceId, channelId);}
}void frmServer::on_treeWidget_itemClicked(QTreeWidgetItem *item, int)
{this->itemClicked(item, false);
}void frmServer::on_treeWidget_itemDoubleClicked(QTreeWidgetItem *item, int)
{this->itemClicked(item, true);
}