一、前言
在vlc默認提供的保存文件方式中，通過打開的時候傳入指定的參數來保存文件，直到關閉播放生成文件，這種方式簡單暴力，但是不適用大部分的場景，大部分時候需要的是提供開始錄製和停止錄製的功能，也就是在播放過程中能夠動態錄製多個文件，想錄制的時候就錄製，要結束的時候就結束錄製，很遺憾vlc並沒有提供這樣的函數接口。當然vlc內置類這樣的功能，只不過沒有開放出來，那如何實現呢，兩種辦法，一種辦法是修改vlc的源碼，加入對應函數和實現，然後重新編譯生成新的vlc庫以及頭文件，一種是用var_ToggleBool函數觸發按鈕。網上幾乎都是說要改源碼來實現，這就有點不友好了，使用vlc來開發的大部分都是菜鳥級別，你覺得讓他去編譯vlc源碼，這不是難於上青天嗎？而且每個平臺都需要重新編譯，得不償失。所以最終採用動態觸發錄製按鈕的方式去實現。
用動態觸發按鈕的形式去實現也不是一帆風順的，通過input-record-name字符串指定了文件名稱不會生效，查閱代碼發現vlc默認固定用內部的 INPUT_RECORD_PREFIX 定義去保存的文件，比如打開的2.mp4文件則保存的是 vlc-record-2022-11-04-14h07m43s-2.mp4-.mp4，可以發現前綴一樣，中間部分是文件名稱標識，而且前綴部分帶了存儲的時間，這下子思路就有了，只需要在文件保存結束後根據規則重命名文件就好。在監控系統中，很多時候需要的是按照通道名稱來保存，但是哪個地址是哪個通道呢？有兩個辦法，一個辦法是通過數據庫查詢數據對應關係，一個辦法是在打開文件的時候指定meta-title即可，會按照指定的meta-title作爲標識保存，比如指定meta-title=Ch1則保存的文件是vlc-record-2021-09-26-16h15m13s-Ch2-.mp4。
- 默認名稱: vlc-record-2022-11-04-14h07m43s-2.mp4-.mp4
- 默認名稱: vlc-record-2021-09-26-16h15m13s-dshow___-.avi
- 默認名稱: vlc-record-2021-09-26-20h46m19s-rtsp___192.168.0.15_media_video2-.avi
- 默認名稱: vlc-record-2021-09-26-20h46m16s-6e0b2be040a943489ef0b9bb344b96b8.hd.m3u8-.mp4
- 規範名稱: vlc-record-2021-09-26-16h15m13s-Ch1-.avi vlc-record-2021-09-26-16h15m13s-Ch2-.mp4
- 正確名稱: video1_2021-09-26-16-15-41.mp4 ch1_2021-09-26-16-15-41.mp4
二、效果圖
三、體驗地址
- 國內站點：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_demo/bin_linux_video。
四、相關代碼
#define LIBVLC_USE_PTHREAD_CANCEL 1
#include <plugins/vlc_common.h>
#include <plugins/vlc_modules.h>
#include <plugins/vlc_charset.h>
#include <plugins/vlc_input.h>
//回調數據結構體
struct VlcCallbackData {
QMutex mutex;
VlcThread *thread;
int width;
int height;
quint8 *pixels;
};
//此結構體從vlc源文件中拷貝到此
#ifdef vlc3
struct libvlc_event_manager_t {
void *p_obj;
vlc_array_t listeners;
vlc_mutex_t lock;
};
struct libvlc_media_player_t {
VLC_COMMON_MEMBERS
int i_refcount;
vlc_mutex_t object_lock;
struct {
input_thread_t *p_thread;
input_resource_t *p_resource;
vlc_renderer_item_t *p_renderer;
vlc_mutex_t lock;
} input;
struct libvlc_instance_t *p_libvlc_instance;
libvlc_media_t *p_md;
libvlc_event_manager_t event_manager;
libvlc_state_t state;
vlc_viewpoint_t viewpoint;
int selected_es[3];
};
#else
struct libvlc_media_player_t {
VLC_COMMON_MEMBERS
int i_refcount;
vlc_mutex_t object_lock;
struct {
input_thread_t *p_thread;
input_resource_t *p_resource;
vlc_mutex_t lock;
} input;
struct libvlc_instance_t *p_libvlc_instance;
libvlc_media_t *p_md;
libvlc_event_manager_t *p_event_manager;
libvlc_state_t state;
};
#endif
input_thread_t *VlcHelper::libvlc_get_input_thread(libvlc_media_player_t *vlcPlayer)
{
input_thread_t *input = NULL;
if (vlcPlayer) {
input = vlcPlayer->input.p_thread;
if (input) {
vlc_object_hold(input);
}
}
return input;
}
void VlcHelper::recordStart(libvlc_media_player_t *vlcPlayer, const QString &fileName)
{
input_thread_t *input = libvlc_get_input_thread(vlcPlayer);
if (!input) {
return;
}
QFileInfo file(fileName);
QString path = file.path();
QString name = file.fileName();
//設置了指定的文件名還是沒作用(查閱代碼發現默認固定用內部的 INPUT_RECORD_PREFIX )
//參考網址 https://blog.csdn.net/weixin_46295795/article/details/110564462
//名稱說明 https://www.cnblogs.com/nlsoft/p/13611192.html
var_Create(input, "input-record-path", VLC_VAR_STRING);
var_SetString(input, "input-record-path", path.toUtf8().data());
//var_CreateGetString(input, "sout-record-dst-prefix");
//var_SetString(input, "sout-record-dst-prefix", name.toUtf8().data());
//var_Create(input, "record-video-name", VLC_VAR_STRING);
//var_SetString(input, "record-video-name", name.toUtf8().data());
//觸發錄製按鈕
var_ToggleBool(input, "record");
vlc_object_release(input);
}
void VlcHelper::recordStop(libvlc_media_player_t *vlcPlayer)
{
input_thread_t *input = libvlc_get_input_thread(vlcPlayer);
if (!input) {
return;
}
var_ToggleBool(input, "record");
vlc_object_release(input);
}
五、功能特點
5.1 基礎功能
- 支持各種音頻視頻文件格式，比如mp3、wav、mp4、asf、rm、rmvb、mkv等。
- 支持本地攝像頭設備，可指定分辨率、幀率。
- 支持各種視頻流格式，比如rtp、rtsp、rtmp、http等。
- 本地音視頻文件和網絡音視頻文件，自動識別文件長度、播放進度、音量大小、靜音狀態等。
- 文件可以指定播放位置、調節音量大小、設置靜音狀態等。
- 支持倍速播放文件，可選0.5倍、1.0倍、2.5倍、5.0倍等速度，相當於慢放和快放。
- 支持開始播放、停止播放、暫停播放、繼續播放。
- 支持抓拍截圖，可指定文件路徑，可選抓拍完成是否自動顯示預覽。
- 支持錄像存儲，手動開始錄像、停止錄像，部分內核支持暫停錄像後繼續錄像，跳過不需要錄像的部分。
- 支持無感知切換循環播放、自動重連等機制。
- 提供播放成功、播放完成、收到解碼圖片、收到抓拍圖片、視頻尺寸變化、錄像狀態變化等信號。
- 多線程處理，一個解碼一個線程，不卡主界面。
5.2 特色功能
- 同時支持多種解碼內核，包括qmedia內核（Qt4/Qt5/Qt6）、ffmpeg內核（ffmpeg2/ffmpeg3/ffmpeg4/ffmpeg5）、vlc內核（vlc2/vlc3）、mpv內核（mpv1/mp2）、海康sdk、easyplayer內核等。
- 非常完善的多重基類設計，新增一種解碼內核只需要實現極少的代碼量，就可以應用整套機制。
- 同時支持多種畫面顯示策略，自動調整（原始分辨率小於顯示控件尺寸則按照原始分辨率大小顯示，否則等比例縮放）、等比例縮放（永遠等比例縮放）、拉伸填充（永遠拉伸填充）。所有內核和所有視頻顯示模式下都支持三種畫面顯示策略。
- 同時支持多種視頻顯示模式，句柄模式（傳入控件句柄交給對方繪製控制）、繪製模式（回調拿到數據後轉成QImage用QPainter繪製）、GPU模式（回調拿到數據後轉成yuv用QOpenglWidget繪製）。
- 支持多種硬件加速類型，ffmpeg可選dxva2、d3d11va等，mpv可選auto、dxva2、d3d11va，vlc可選any、dxva2、d3d11va。不同的系統環境有不同的類型選擇，比如linux系統有vaapi、vdpau，macos系統有videotoolbox。
- 解碼線程和顯示窗體分離，可指定任意解碼內核掛載到任意顯示窗體，動態切換。
- 支持共享解碼線程，默認開啓並且自動處理，當識別到相同的視頻地址，共享一個解碼線程，在網絡視頻環境中可以大大節約網絡流量以及對方設備的推流壓力。國內頂尖視頻廠商均採用此策略。這樣只要拉一路視頻流就可以共享到幾十個幾百個通道展示。
- 自動識別視頻旋轉角度並繪製，比如手機上拍攝的視頻一般是旋轉了90度的，播放的時候要自動旋轉處理，不然默認是倒着的。
- 自動識別視頻流播放過程中分辨率的變化，在視頻控件上自動調整尺寸。比如攝像機可以在使用過程中動態配置分辨率，當分辨率改動後對應視頻控件也要做出同步反應。
- 音視頻文件無感知自動切換循環播放，不會出現切換期間黑屏等肉眼可見的切換痕跡。
- 視頻控件同時支持任意解碼內核、任意畫面顯示策略、任意視頻顯示模式。
- 視頻控件懸浮條同時支持句柄、繪製、GPU三種模式，非絕對座標移來移去。
- 本地攝像頭設備支持指定設備名稱、分辨率、幀率進行播放。
- 錄像文件同時支持打開的視頻文件、本地攝像頭、網絡視頻流等。
- 瞬間響應打開和關閉，無論是打開不存在的視頻或者網絡流，探測設備是否存在，讀取中的超時等待，收到關閉指令立即中斷之前的操作並響應。
- 支持打開各種圖片文件，支持本地音視頻文件拖曳播放。
- 視頻控件懸浮條自帶開始和停止錄像切換、聲音靜音切換、抓拍截圖、關閉視頻等功能。
- 音頻組件支持聲音波形值數據解析，可以根據該值繪製波形曲線和柱狀聲音條，默認提供了聲音振幅信號。
- 各組件中極其詳細的打印信息提示，尤其是報錯信息提示，封裝的統一打印格式。針對現場複雜的設備環境測試極其方便有用，相當於精確定位到具體哪個通道哪個步驟出錯。
- 代碼框架和結構優化到最優，性能強悍，持續迭代更新升級。
- 源碼支持Qt4、Qt5、Qt6，兼容所有版本。
5.3 視頻控件
- 可動態添加任意多個osd標籤信息，標籤信息包括名字、是否可見、字號大小、文本文字、文本顏色、標籤圖片、標籤座標、標籤格式（文本、日期、時間、日期時間、圖片）、標籤位置（左上角、左下角、右上角、右下角、居中、自定義座標）。
- 可動態添加任意多個圖形信息，這個非常有用，比如人工智能算法解析後的圖形區域信息直接發給視頻控件即可。圖形信息支持任意形狀，直接繪製在原始圖片上，採用絕對座標。
- 圖形信息包括名字、邊框大小、邊框顏色、背景顏色、矩形區域、路徑集合、點座標集合等。
- 每個圖形信息都可指定三種區域中的一種或者多種，指定了的都會繪製。
- 內置懸浮條控件，懸浮條位置支持頂部、底部、左側、右側。
- 懸浮條控件參數包括邊距、間距、背景透明度、背景顏色、文本顏色、按下顏色、位置、按鈕圖標代碼集合、按鈕名稱標識集合、按鈕提示信息集合。
- 懸浮條控件一排工具按鈕可自定義，通過結構體參數設置，圖標可選圖形字體還是自定義圖片。
- 懸浮條按鈕內部實現了錄像切換、抓拍截圖、靜音切換、關閉視頻等功能，也可以自行在源碼中增加自己對應的功能。
- 懸浮條按鈕對應實現了功能的按鈕，有對應圖標切換處理，比如錄像按鈕按下後會切換到正在錄像中的圖標，聲音按鈕切換後變成靜音圖標，再次切換還原。
- 懸浮條按鈕單擊後都用名稱唯一標識作爲信號發出，可以自行關聯響應處理。
- 懸浮條空白區域可以顯示提示信息，默認顯示當前視頻分辨率大小，可以增加幀率、碼流大小等信息。
- 視頻控件參數包括邊框大小、邊框顏色、焦點顏色、背景顏色（默認透明）、文字顏色（默認全局文字顏色）、填充顏色（視頻外的空白處填充黑色）、背景文字、背景圖片（如果設置了圖片優先取圖片）、是否拷貝圖片、縮放顯示模式（自動調整、等比例縮放、拉伸填充）、視頻顯示模式（句柄、繪製、GPU）、啓用懸浮條、懸浮條尺寸（橫向爲高度、縱向爲寬度）、懸浮條位置（頂部、底部、左側、右側）。
5.4 內核vlc
- 支持各種音視頻文件、本地攝像頭設備，各種視頻流網絡流。
- 支持開始播放、暫停播放、繼續播放、停止播放、設置播放進度、倍速播放。
- 可設置音量、靜音切換、抓拍圖片、錄像存儲。
- 自動提取專輯信息比如標題、藝術家、專輯、專輯封面，自動顯示專輯封面。
- 事件回調機制響應文件長度變化、播放進度變化、音量大小變化、靜音狀態變化、分辨率變化等。
- 不用重新編譯源碼，實現句柄模式下響應鼠標鍵盤信息。
- 不用重新編譯源碼，實現錄像文件存儲。手動開啓錄像和停止錄像，錄像文件名稱自動調整爲設置的名稱。
- 句柄模式顯示懸浮條和osd標籤控件，非絕對座標move來move去這種垃圾方式。
- 支持硬解碼any、dxva2、d3d11va等，性能極高尤其是大分辨率比如4K視頻。
- 同時支持vlc2、vlc3版本，全部做了兼容處理。