Qt音視訊開發36-逾時檢測和自動重連的設計

一、前言

如果網絡環境正常裝置正常，視訊監控系統一般都是按照正常運作下去，不會出現什麼問題，但是實際情況會很不同，奇奇怪怪七七八八的問題都會出現，就比如網絡出了問題都有很多情況（交換機故障、網線故障、帶寬故障等），是以監控系統在運作過程中，還得做逾時檢測，超過規定的時間沒有收到資料則認為掉線了，需要重連，逾時檢測有兩個地方需要，一個是打開的時候，因為受限于網絡等，預設逾時時間是30s太久，在打開之前，可以做個簡單的連接配接探測是否位址通，不通就不用繼續；另一個地方就是實時采集過程中，也要能夠及時識别到，防止一直在那邊死循環的讀取。

在上面超過檢測後，一般都是更新最後的收到資料的時間，然後自動重連的機制就是線上程中判斷這個最後接收資料的時間和目前時間比較，超過了設定的逾時時間，則認為掉線，關閉視訊，如果還設定了自動重連屬性，則先關閉再去重新打開，務必記得關閉的時候及時釋放所有的資源，不然記憶體會一直增長。封裝後的視訊流控件自帶了自動重連的機制，這樣使用者再使用的時候不用管如何重連，隻需要開啟自動重連屬性即可，預設開，還有一種情況可能要關閉自動重連屬性，比如播放本地視訊檔案，有時候隻需要播放一次就行，不需要播放完成以後又重新播放，如果确實需要，則關聯播放完畢信号自行重新open即可。

二、效果圖

三、體驗位址

1. 國内站點：https://gitee.com/feiyangqingyun
2. 國際站點：https://github.com/feiyangqingyun
3. 個人作品：https://blog.csdn.net/feiyangqingyun/article/details/97565652
4. 體驗位址：https://pan.baidu.com/s/1d7TH_GEYl5nOecuNlWJJ7g 提取碼：01jf 檔案名：bin_video_demo/bin_linux_video。

四、相關代碼

void VideoThread::checkOpen()
{
    //特意每次做個小延時每次都去判斷标志位等可以大大加快關閉速度
    int count = 0;
    int maxCount = openSleepTime / 100;
    while (!stopped) {
        msleep(100);
        count++;
        //測試下來正常情況下基本上等待一次後 isOk=true
        if (count == maxCount || isOk) {
            break;
        }
    }
}

void VideoThread::run()
{
    while (!stopped) {
        if (!isOk) {
            this->closeVideo();
            if (videoMode == VideoMode_Hwnd) {
                QMetaObject::invokeMethod(this, "openVideo");
            } else {
                this->openVideo();
            }

            this->checkOpen();
            continue;
        }

        if (videoCore == VideoCore_Vlc) {
            if (videoWidth <= 0 && !getOnlyAudio()) {
                //視訊檔案需要嘗試讀取媒體資訊多次保證能夠讀取到(一般視訊流需要多次才能讀取到)
                this->readMediaInfo();
            }
        } else if (videoCore == VideoCore_HaiKang) {
            if (videoType == VideoType_FileLocal) {
                //本地檔案需要這裡實時讀取播放進度
                this->getPosition();
            } else if (isOk && videoMode == VideoMode_Hwnd) {
                //句柄模式下視訊流如果打開正常了則sdk内部處理重連
                lastTime = QDateTime::currentDateTime();
            }
        } else if (videoCore == VideoCore_EasyPlayer) {
            if (videoWidth <= 0) {
                this->readMediaInfo();
            }

            this->getPosition();
        }

        //啟用了自動重連則通過判斷最後的消息時間(逾時則重新打開)
        if (readTimeout > 0) {
            qint64 offset = lastTime.msecsTo(QDateTime::currentDateTime());
            if (offset >= readTimeout) {
                isOk = false;
                debug("逾時重連", "");
                continue;
            }
        }

        msleep(100);
    }

    //關閉視訊
    this->closeVideo();

    //檔案名為空才說明真正處理完可以徹底結束線程(否則一直等因為有可能檔案還沒儲存完成)
    while (!fileName.isEmpty()) {
        debug("等待完成", "");
        msleep(5);
    }

    debug("線程結束", "");
}           

五、功能特點

5.1 基礎功能

1. 支援各種音頻視訊檔案格式，比如mp3、wav、mp4、asf、rm、rmvb、mkv等。
2. 支援本地攝像頭裝置，可指定分辨率、幀率。
3. 支援各種視訊流格式，比如rtp、rtsp、rtmp、http等。
4. 本地音視訊檔案和網絡音視訊檔案，自動識别檔案長度、播放進度、音量大小、靜音狀态等。
5. 檔案可以指定播放位置、調節音量大小、設定靜音狀态等。
6. 支援倍速播放檔案，可選0.5倍、1.0倍、2.5倍、5.0倍等速度，相當于慢放和快放。
7. 支援開始播放、停止播放、暫停播放、繼續播放。
8. 支援抓拍截圖，可指定檔案路徑，可選抓拍完成是否自動顯示預覽。
9. 支援錄像存儲，手動開始錄像、停止錄像，部分核心支援暫停錄像後繼續錄像，跳過不需要錄像的部分。
10. 支援無感覺切換循環播放、自動重連等機制。
11. 提供播放成功、播放完成、收到解碼圖檔、收到抓拍圖檔、視訊尺寸變化、錄像狀态變化等信号。
12. 多線程處理，一個解碼一個線程，不卡主界面。

5.2 特色功能

1. 同時支援多種解碼核心，包括qmedia核心（Qt4/Qt5/Qt6）、ffmpeg核心（ffmpeg2/ffmpeg3/ffmpeg4/ffmpeg5）、vlc核心（vlc2/vlc3）、mpv核心（mpv1/mp2）、海康sdk、easyplayer核心等。
2. 非常完善的多重基類設計，新增一種解碼核心隻需要實作極少的代碼量，就可以應用整套機制。
3. 同時支援多種畫面顯示政策，自動調整（原始分辨率小于顯示控件尺寸則按照原始分辨率大小顯示，否則等比例縮放）、等比例縮放（永遠等比例縮放）、拉伸填充（永遠拉伸填充）。所有核心和所有視訊顯示模式下都支援三種畫面顯示政策。
4. 同時支援多種視訊顯示模式，句柄模式（傳入控件句柄交給對方繪制控制）、繪制模式（回調拿到資料後轉成QImage用QPainter繪制）、GPU模式（回調拿到資料後轉成yuv用QOpenglWidget繪制）。
5. 支援多種硬體加速類型，ffmpeg可選dxva2、d3d11va等，mpv可選auto、dxva2、d3d11va，vlc可選any、dxva2、d3d11va。不同的系統環境有不同的類型選擇，比如linux系統有vaapi、vdpau，macos系統有videotoolbox。
6. 解碼線程和顯示窗體分離，可指定任意解碼核心挂載到任意顯示窗體，動态切換。
7. 支援共享解碼線程，預設開啟并且自動處理，當識别到相同的視訊位址，共享一個解碼線程，在網絡視訊環境中可以大大節約網絡流量以及對方裝置的推流壓力。國内頂尖視訊廠商均采用此政策。這樣隻要拉一路視訊流就可以共享到幾十個幾百個通道展示。
8. 自動識别視訊旋轉角度并繪制，比如手機上拍攝的視訊一般是旋轉了90度的，播放的時候要自動旋轉處理，不然預設是倒着的。
9. 自動識别視訊流播放過程中分辨率的變化，在視訊控件上自動調整尺寸。比如錄影機可以在使用過程中動态配置分辨率，當分辨率改動後對應視訊控件也要做出同步反應。
10. 音視訊檔案無感覺自動切換循環播放，不會出現切換期間黑屏等肉眼可見的切換痕迹。
11. 視訊控件同時支援任意解碼核心、任意畫面顯示政策、任意視訊顯示模式。
12. 視訊控件懸浮條同時支援句柄、繪制、GPU三種模式，非絕對坐标移來移去。
13. 本地攝像頭裝置支援指定裝置名稱、分辨率、幀率進行播放。
14. 錄像檔案同時支援打開的視訊檔案、本地攝像頭、網絡視訊流等。
15. 瞬間響應打開和關閉，無論是打開不存在的視訊或者網絡流，探測裝置是否存在，讀取中的逾時等待，收到關閉指令立即中斷之前的操作并響應。
16. 支援打開各種圖檔檔案，支援本地音視訊檔案拖曳播放。
17. 視訊控件懸浮條自帶開始和停止錄像切換、聲音靜音切換、抓拍截圖、關閉視訊等功能。
18. 音頻元件支援聲音波形值資料解析，可以根據該值繪制波形曲線和柱狀聲音條，預設提供了聲音振幅信号。
19. 各元件中極其詳細的列印資訊提示，尤其是報錯資訊提示，封裝的統一列印格式。針對現場複雜的裝置環境測試極其友善有用，相當于精确定位到具體哪個通道哪個步驟出錯。
20. 代碼架構和結構優化到最優，性能強悍，持續疊代更新更新。
21. 源碼支援Qt4、Qt5、Qt6，相容所有版本。

5.3 視訊控件

1. 可動态添加任意多個osd标簽資訊，标簽資訊包括名字、是否可見、字号大小、文本文字、文本顔色、标簽圖檔、标簽坐标、标簽格式（文本、日期、時間、日期時間、圖檔）、标簽位置（左上角、左下角、右上角、右下角、居中、自定義坐标）。
2. 可動态添加任意多個圖形資訊，這個非常有用，比如人工智能算法解析後的圖形區域資訊直接發給視訊控件即可。圖形資訊支援任意形狀，直接繪制在原始圖檔上，采用絕對坐标。
3. 圖形資訊包括名字、邊框大小、邊框顔色、背景顔色、矩形區域、路徑集合、點坐标集合等。
4. 每個圖形資訊都可指定三種區域中的一種或者多種，指定了的都會繪制。
5. 内置懸浮條控件，懸浮條位置支援頂部、底部、左側、右側。
6. 懸浮條控件參數包括邊距、間距、背景透明度、背景顔色、文本顔色、按下顔色、位置、按鈕圖示代碼集合、按鈕名稱辨別集合、按鈕提示資訊集合。
7. 懸浮條控件一排工具按鈕可自定義，通過結構體參數設定，圖示可選圖形字型還是自定義圖檔。
8. 懸浮條按鈕内部實作了錄像切換、抓拍截圖、靜音切換、關閉視訊等功能，也可以自行在源碼中增加自己對應的功能。
9. 懸浮條按鈕對應實作了功能的按鈕，有對應圖示切換處理，比如錄像按鈕按下後會切換到正在錄像中的圖示，聲音按鈕切換後變成靜音圖示，再次切換還原。
10. 懸浮條按鈕單擊後都用名稱唯一辨別作為信号發出，可以自行關聯響應處理。
11. 懸浮條空白區域可以顯示提示資訊，預設顯示目前視訊分辨率大小，可以增加幀率、碼流大小等資訊。
12. 視訊控件參數包括邊框大小、邊框顔色、焦點顔色、背景顔色（預設透明）、文字顔色（預設全局文字顔色）、填充顔色（視訊外的空白處填充黑色）、背景文字、背景圖檔（如果設定了圖檔優先取圖檔）、是否拷貝圖檔、縮放顯示模式（自動調整、等比例縮放、拉伸填充）、視訊顯示模式（句柄、繪制、GPU）、啟用懸浮條、懸浮條尺寸（橫向為高度、縱向為寬度）、懸浮條位置（頂部、底部、左側、右側）。