一、前言

預置位在視訊監控系統中是不可或缺的存在，響應預置位功能的前提是要帶預置位的雲臺球機，有些普通的雲臺球機其實不帶預置位的，這個要檢查清楚，硬體上不支援該功能的，你再怎麼點也沒反應。在這個視訊監控系統的使用過程中，就有不少的使用者會問這個問題，為啥他點了雲臺沒法應之類的，前提是要硬體支援才行啊。

預置位是將被監視的重點區域與球機的執行狀況聯絡在一起的方式。當用戶通過控制裝置操作終端的監控雲臺監視目標時，操作人員可以把當前監視目標設定一個預置位，比如一個動點雲臺，可以365或360度全方位旋轉監視；操作人員可以把一個視窗、櫃檯、辦公桌、出入口、存車處等需要監視的地點設定為預置位；設定好的預置位可以通過控制裝置軟體操作把當前位置儲存在終端監控雲臺的解碼器上。當用戶需要快速監視某個監視目標時候；可以通過控制裝置的呼叫命令來調出需要監視的位置。這就是預置位功能的含義。

預置位的相關處理有獲取預置位（一堆預置位資訊集合，一般是1-255預置位編號帶預置位名稱）、呼叫預置位（相當於主動觸發一個預置位，讓球機主動移動到該預置位的位置）、新增預置位（即可傳入預置位編號和名稱新增預置位，也可對現有預置位的位置資訊進行替換）、刪除預置位（將現有預置位的位置資訊刪除）、設定起始位（球機一般有個HOME位置作為起始位置，也可以手動切換球機移動到某個合適的位置然後設定成起始位置，以便移動發生變化後，先回到起始位置）、呼叫起始位（將當前畫面對應的位置資訊作為起始位置）。預置位編號一般是1-255，部分球機可能還能做到1000，預置位名稱也相當於別名，可以是中文方便標識記憶。

onvif主要的功能

1. 搜尋裝置，獲取裝置的資訊比如廠家、型號等。
2. 獲取裝置的多個配置檔案資訊profile。
3. 獲取對應配置檔案的視訊流地址rtsp，以及解析度等引數。
4. 雲臺控制，上下左右移動，焦距放大縮小，相對和絕對移動。
5. 獲取預置位資訊，觸發預置位。
6. 訂閱事件，接收裝置的各種訊息尤其是報警事件比如IO口的報警。
7. 抓圖，獲取裝置當前的圖片。
8. 獲取、建立、刪除使用者資訊。
9. 獲取和裝置網路配置資訊比如IP地址等。
10. 獲取和設定NTP時間同步。
11. 獲取和設定裝置時間。
12. 重啟裝置。

onvif的處理流程

1. 繫結組播IP（239.255.255.250）和埠（3702），傳送固定的xml格式的資料搜尋裝置。
2. 接收到的xml格式的資料解析，得到裝置的Onvif地址。
3. 對Onvif地址傳送對應的資料，收到資料取出對應的節點資料。
4. 請求Onvif地址獲取Media地址和Ptz地址，Media地址用來獲取詳細的配置檔案，Ptz地址用來雲臺控制。
5. ptz控制是對Ptz地址傳送對應的資料即可。
6. 設定了使用者認證的需要組織使用者token資訊一塊傳送，每次都需要作鑑權處理。
7. 接收到的資料不是標準的xml資料，沒法按照正常的節點解析來處理，只能用QXmlQuery來做。
8. 每個廠家裝置返回的資料未必完全一致，基本上都不一致，需要進行模糊查詢節點值。
9. 特意採用底層協議解析，因為soap太臃腫函式名稱太另類，特意做的輕量級的。
10. 兩個必備工具，Onvif Device Manager 和 Onvif Device Test Tool。

二、功能特點

（一）軟體模組

1. 視訊監控模組，各種停靠小窗體子模組，包括裝置列表、圖文警情、視窗資訊、雲臺控制、預置位、巡航設定、裝置控制、懸浮地圖、網頁瀏覽等。
2. 視訊回放模組，包括本地回放、遠端回放、裝置播放、圖片回放、視訊上傳等。
3. 電子地圖模組，包括圖片地圖、線上地圖、離線地圖、路徑規劃等。
4. 日誌查詢模組，包括本地日誌、裝置日誌等。
5. 系統設定模組，包括系統設定（基本設定、視訊引數、資料庫設定、地圖配置、串列埠配置等）、錄影機管理、攝像機管理、輪詢配置、使用者管理等。

（二）基礎功能

1. 支援各種視訊流（rtsp、rtmp、http等）、視訊檔案（mp4、rmvb、avi等）、本地USB攝像機播放。
2. 支援多畫面切換，包括1、4、6、8、9、13、16、25、36、64畫面切換。
3. 支援全屏切換，多種切換方式包括滑鼠右鍵選單、工具欄按鈕、快捷鍵（alt+enter全屏，esc退出全屏）。
4. 支援視訊輪詢，包括1、4、9、16畫面輪詢，可設定輪詢分組（輪詢預案）、輪詢間隔、碼流型別等。
5. 支援onvif協議，包括裝置搜尋、雲臺控制、裝置控制（圖片引數、校對時間、系統重啟，抓拍圖片等）。
6. 支援許可權管理，不同的使用者可以對應不同的模組許可權，比如刪除日誌、關閉系統等。
7. 資料庫支援多種，包括sqlite、mysql、sqlserver、postgresql、oracle、人大金倉等。
8. 本地USB攝像機支援設定解析度、幀率等引數。
9. 所有停靠模組都自動生成對應的選單用來控制顯示和隱藏，在標題欄右鍵可以彈出。
10. 支援顯示所有模組、隱藏所有模組、復位普通佈局、復位全屏佈局。
11. 雙擊裝置彈出實時預覽視訊，支援圖片地圖、線上地圖、離線地圖等。
12. 攝像機節點拖曳到對應窗體播放視訊，同時支援拖曳本地檔案直接播放。
13. 刪除視訊支援滑鼠右鍵刪除、懸浮條關閉刪除、拖曳到視訊監控面板外刪除等多種方式。
14. 圖片地圖上裝置按鈕可自由拖動，自動儲存位置資訊。百度地圖上可以滑鼠單擊獲取經緯度資訊，用來更新裝置位置。
15. 視訊監控面板窗體中任意通道支援拖曳交換，瞬間響應。
16. 封裝了百度地圖，檢視切換，運動軌跡，裝置點位，滑鼠按下獲取經緯度等。
17. 雙擊節點、拖曳節點、拖曳窗體交換位置等操作，均自動更新儲存最後的播放地址，下次軟體開啟自動應用。
18. 右下角音量條控制元件，失去焦點自動隱藏，音量條帶靜音圖示。
19. 支援視訊截圖，可指定單個或者對所有通道截圖，底部小工具欄也有截圖按鈕。
20. 支援超時自動隱藏滑鼠指標、自動全屏機制。
21. 支援onvif雲臺控制，可上下左右移動雲臺攝像機，包括復位和焦距調整等。
22. 支援任意onvif攝像機，包括但不限於海康、大華、宇視、天地偉業、華為等。
23. 可儲存視訊，可選定時儲存或者單檔案儲存，可選儲存間隔時間。
24. 可設定視訊流通訊方式tcp+udp，可設定視訊解碼是速度優先、質量優先、均衡等。
25. 可設定軟體中文名稱、英文名稱、LOGO圖示等。
26. 儲存的視訊檔案支援匯出到指定目錄，支援批量上傳到伺服器。

（三）特色功能

1. 主介面採用停靠窗體模式，各種元件以小模組的形式加入，可自定義任意模組加入。
2. 停靠模組可拖動任意位置嵌入和懸浮，支援最大化全屏，支援多螢幕。
3. 雙重佈局檔案儲存機制，正常模式、全屏模式都對應不同的佈局方案，自動切換和儲存，比如全屏模式可以突出幾個模組透明顯示在指定位置，更具科幻感現代化。
4. 原創onvif協議機制，採用底層協議解析（udp廣播搜尋+http請求執行命令）更輕量易懂易學習拓展，不依賴任何第三方元件比如gsoap。
5. 原創資料匯入匯出機制，跨平臺不依賴任何元件，瞬間匯出資料。
6. 內建多個原創元件，宇宙超值超級牛逼，包括資料匯入匯出元件（匯出到xls、pdf、列印）、資料庫元件（資料庫管理執行緒、自動清理資料執行緒、萬能分頁、資料請求等）、地圖元件、視訊監控元件、檔案多執行緒收發元件、onvif通訊元件、通用瀏覽器核心元件等。
7. 自定義資訊框+錯誤框+詢問框+右下角提示框（包含多種格式）等。
8. 精美換膚，高達17套面板樣式隨意更換，所有樣式全部統一，包括選單等。
9. 視訊控制元件懸浮條可以自行增加多個按鈕，監控介面底部小工具欄也可自行增加按鈕。
10. 雙擊攝像機節點自動播放視訊，雙擊節點自動依次新增視訊，會自動跳到下一個，雙擊父節點自動新增該節點下的所有視訊。可選主碼流、子碼流。
11. 錄影機管理、攝像機管理，可新增刪除修改匯入匯出列印資訊，立即應用新的裝置資訊生成樹狀列表，不需重啟。
12. 可選多種核心自由切換，ffmpeg、vlc、mpv等，均可在pro中設定。推薦用ffmpeg，跨平臺最多，預設提供好了linux和mac平臺上編譯好的庫。
13. 支援硬解碼，可設定硬解碼型別（qsv、dxva2、d3d11va等）。
14. 預設採用opengl繪製視訊，超低的CPU資源佔用，支援yuyv和nv12兩種格式繪製，很牛逼。
15. 高度可定製化，使用者可以很方便的在此基礎上衍生自己的功能，比如增加自定義模組，增加執行模式、機器人監控、無人機監控、挖掘機監控等。
16. 支援xp、win7、win10、linux、mac、各種國產系統（UOS、中標麒麟、銀河麒麟等）、嵌入式linux等系統。
17. 註釋完整，專案結構清晰，超級詳細完整的使用開發手冊，精確到每個程式碼檔案的功能說明，不斷持續迭代版本。

三、體驗地址

1. 體驗地址：https://pan.baidu.com/s/1d7TH_GEYl5nOecuNlWJJ7g 提取碼：01jf 檔名：bin_video_system.zip。
2. 國內站點：https://gitee.com/feiyangqingyun
3. 國際站點：https://github.com/feiyangqingyun
4. 個人主頁：https://blog.csdn.net/feiyangqingyun
5. 知乎主頁：https://www.zhihu.com/people/feiyangqingyun/
6. 線上文件：https://feiyangqingyun.gitee.io/qwidgetdemo/video_system.html

四、效果圖

五、核心程式碼

#include "onvifptz.h"

OnvifPtz::OnvifPtz(QObject *parent) : QObject(parent)
{
    device = 0;
}

void OnvifPtz::setDevice(OnvifDevice *device)
{
    this->device = device;
}

bool OnvifPtz::ptzControl(quint8 type, const QString &profileToken, double x, double y, double z)
{
    QString name = "PtzStop";
    QString flag = "雲臺停止移動";
    if (type == 1) {
        name = "PtzAbsoluteMove";
        flag = "雲臺絕對移動";
    } else if (type == 2) {
        //xy=0表示此時控制焦距縮放
        if (x == 0.0 && y == 0.0) {
            name = "PtzRelativeMoveZoom";
            flag = "雲臺相對焦距";
        } else {
            name = "PtzRelativeMove";
            flag = "雲臺相對移動";
        }
    } else if (type == 3) {
        //xy=0表示此時控制焦距縮放
        if (x == 0.0 && y == 0.0) {
            name = "PtzContinuousMoveZoom";
            flag = "雲臺連續焦距";
        } else {
            name = "PtzContinuousMove";
            flag = "雲臺連續移動";
        }
    }

    QString file = OnvifHelper::getFile(QString(":/onvifsend/%1.xml").arg(name));
    QString userToken = device->getUserToken();
    if (type == 1) {
        file = file.arg(userToken).arg(profileToken).arg(x).arg(y).arg(z);
    } else if (type == 2 || type == 3) {
        if (name.endsWith("Zoom")) {
            file = file.arg(userToken).arg(profileToken).arg(z);
        } else {
            file = file.arg(userToken).arg(profileToken).arg(x).arg(y);
        }
    } else {
        file = file.arg(userToken).arg(profileToken);
    }

    QByteArray dataSend = file.toUtf8();
    QNetworkReply *reply = device->request->post(device->ptzUrl, dataSend);

    QByteArray dataReceive;
    bool ok = device->checkData(reply, dataReceive, flag);
    return ok;
}

bool OnvifPtz::ptzPreset(quint8 type, const QString &profileToken, const QString &presetToken, const QString &presetName)
{
    QString name = "PtzGotoPreset";
    QString flag = "呼叫預置位";
    if (type == 1) {
        name = "PtzSetPreset";
        flag = "新增預置位";
    } else if (type == 2) {
        name = "PtzRemovePreset";
        flag = "刪除預置位";
    } else if (type == 3) {
        name = "PtzGotoHomePosition";
        flag = "呼叫起始位";
    } else if (type == 4) {
        name = "PtzSetHomePosition";
        flag = "設定起始位";
    }

    QString file = OnvifHelper::getFile(QString(":/onvifsend/%1.xml").arg(name));
    if (type == 1) {
        file = file.arg(device->getUserToken()).arg(profileToken).arg(presetToken).arg(presetName);
    } else if (type == 0 || type == 2) {
        file = file.arg(device->getUserToken()).arg(profileToken).arg(presetToken);
    } else if (type == 3 || type == 4) {
        file = file.arg(device->getUserToken()).arg(profileToken);
    }

    QByteArray dataSend = file.toUtf8();
    QNetworkReply *reply = device->request->post(device->ptzUrl, dataSend);

    QByteArray dataReceive;
    bool ok = device->checkData(reply, dataReceive, flag);
    return ok;
}

QList<OnvifPresetInfo> OnvifPtz::getPresets(const QString &profileToken)
{
    QList<OnvifPresetInfo> presets;
    if (device->mediaUrl.isEmpty()) {
        return presets;
    }

    QString file = OnvifHelper::getFile(":/onvifsend/PtzGetPresets.xml");
    file = file.arg(device->getUserToken()).arg(profileToken);
    QByteArray dataSend = file.toUtf8();
    QNetworkReply *reply = device->request->post(device->mediaUrl, dataSend);

    QByteArray dataReceive;
    bool ok = device->checkData(reply, dataReceive, "獲取預置位");
    if (ok) {
        //解析預置位資訊
        OnvifQuery query;
        if (query.setData(dataReceive)) {
            presets = query.getPresets();
        }
    }

    return presets;
}