一、前言
對於使用第三方的sdk庫做開發,除了基本的操作函數接口外,還希望通過事件機制拿到消息通知,比如當前播放進度、音量值變化、靜音變化、文件長度、播放結束等,有了這些纔是完整的播放功能,在vlc中要拿到各種事件需要先通過libvlc_event_attach訂閱事件,不需要的時候用libvlc_event_detach取消訂閱即可,函數中第二個參數指定是何種事件類型,常用的事件類型有下列:
- 文件長度變化=libvlc_MediaPlayerLengthChanged
- 播放進度變化=libvlc_MediaPlayerTimeChanged
- 音量大小變化=libvlc_MediaPlayerAudioVolume
- 設置靜音狀態=libvlc_MediaPlayerMuted
- 取消靜音狀態=libvlc_MediaPlayerUnmuted
- 抓圖信號通知=libvlc_MediaPlayerSnapshotTaken
- 文件打開信號=libvlc_MediaPlayerOpening
- 文件播放信號=libvlc_MediaPlayerPlaying
- 暫停播放信號=libvlc_MediaPlayerPaused
- 停止播放信號=libvlc_MediaPlayerStopped
- 文件播放結束=libvlc_MediaPlayerEndReached
二、效果圖
三、體驗地址
- 國內站點: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。
四、相關代碼
void VlcHelper::attachEvents(libvlc_event_manager_t *vlcEvent, VlcThread *thread)
{
libvlc_event_attach(vlcEvent, libvlc_MediaPlayerLengthChanged, handleEvents, thread);
libvlc_event_attach(vlcEvent, libvlc_MediaPlayerTimeChanged, handleEvents, thread);
libvlc_event_attach(vlcEvent, libvlc_MediaPlayerAudioVolume, handleEvents, thread);
libvlc_event_attach(vlcEvent, libvlc_MediaPlayerMuted, handleEvents, thread);
libvlc_event_attach(vlcEvent, libvlc_MediaPlayerUnmuted, handleEvents, thread);
libvlc_event_attach(vlcEvent, libvlc_MediaPlayerSnapshotTaken, handleEvents, thread);
//libvlc_event_attach(vlcEvent, libvlc_MediaPlayerPositionChanged, handleEvents, thread);
//libvlc_event_attach(vlcEvent, libvlc_MediaParsedChanged, handleEvents, thread);
//libvlc_event_attach(vlcEvent, libvlc_MediaPlayerOpening, handleEvents, thread);
//libvlc_event_attach(vlcEvent, libvlc_MediaPlayerPlaying, handleEvents, thread);
//libvlc_event_attach(vlcEvent, libvlc_MediaPlayerPaused, handleEvents, thread);
//libvlc_event_attach(vlcEvent, libvlc_MediaPlayerStopped, handleEvents, thread);
libvlc_event_attach(vlcEvent, libvlc_MediaPlayerEndReached, handleEvents, thread);
libvlc_event_attach(vlcEvent, libvlc_MediaPlayerEncounteredError, handleEvents, thread);
libvlc_event_attach(vlcEvent, libvlc_MediaPlayerVout, handleEvents, thread);
}
void VlcHelper::detachEvents(libvlc_event_manager_t *vlcEvent, VlcThread *thread)
{
libvlc_event_detach(vlcEvent, libvlc_MediaPlayerLengthChanged, handleEvents, thread);
libvlc_event_detach(vlcEvent, libvlc_MediaPlayerTimeChanged, handleEvents, thread);
libvlc_event_detach(vlcEvent, libvlc_MediaPlayerAudioVolume, handleEvents, thread);
libvlc_event_detach(vlcEvent, libvlc_MediaPlayerMuted, handleEvents, thread);
libvlc_event_detach(vlcEvent, libvlc_MediaPlayerUnmuted, handleEvents, thread);
libvlc_event_detach(vlcEvent, libvlc_MediaPlayerSnapshotTaken, handleEvents, thread);
//libvlc_event_detach(vlcEvent, libvlc_MediaPlayerPositionChanged, handleEvents, thread);
//libvlc_event_detach(vlcEvent, libvlc_MediaParsedChanged, handleEvents, thread);
//libvlc_event_detach(vlcEvent, libvlc_MediaPlayerOpening, handleEvents, thread);
//libvlc_event_detach(vlcEvent, libvlc_MediaPlayerPlaying, handleEvents, thread);
//libvlc_event_detach(vlcEvent, libvlc_MediaPlayerPaused, handleEvents, thread);
//libvlc_event_detach(vlcEvent, libvlc_MediaPlayerStopped, handleEvents, thread);
libvlc_event_detach(vlcEvent, libvlc_MediaPlayerEndReached, handleEvents, thread);
libvlc_event_detach(vlcEvent, libvlc_MediaPlayerEncounteredError, handleEvents, thread);
libvlc_event_detach(vlcEvent, libvlc_MediaPlayerVout, handleEvents, thread);
}
void VlcHelper::handleEvents(const libvlc_event_t *event, void *data)
{
VlcThread *thread = (VlcThread *)data;
//在回調事件中更新最後的消息時間
thread->updateTime();
//qDebug() << TIMEMS << event->type;
switch (event->type) {
case libvlc_MediaPlayerLengthChanged: {
qint64 duration = event->u.media_player_length_changed.new_length;
if (duration > 0 && thread->getIsFile()) {
QMetaObject::invokeMethod(thread, "receiveDuration", Q_ARG(qint64, duration));
}
}
break;
case libvlc_MediaPlayerTimeChanged: {
qint64 position = event->u.media_player_time_changed.new_time;
if (position > 0 && thread->getIsFile()) {
QMetaObject::invokeMethod(thread, "receivePosition", Q_ARG(qint64, position));
//如果設置了重複循環播放則快到了文件末尾重新設置位置即可
if (thread->getPlayRepeat() && (thread->getDuration() - position) < 500) {
QMetaObject::invokeMethod(thread, "setPosition", Q_ARG(qint64, 0));
}
}
}
break;
case libvlc_MediaPlayerAudioVolume: {
//這裏獲取到的音量值是 0.1 - 1.0
float volume = event->u.media_player_audio_volume.volume * 100;
QMetaObject::invokeMethod(thread, "receiveVolume", Q_ARG(int, volume));
}
break;
case libvlc_MediaPlayerMuted: {
bool muted = true;
QMetaObject::invokeMethod(thread, "receiveMuted", Q_ARG(bool, muted));
}
break;
case libvlc_MediaPlayerUnmuted: {
bool muted = false;
QMetaObject::invokeMethod(thread, "receiveMuted", Q_ARG(bool, muted));
}
break;
case libvlc_MediaPlayerSnapshotTaken: {
QMetaObject::invokeMethod(thread, "snapFinsh");
}
break;
case libvlc_MediaPlayerPositionChanged: {
float position = event->u.media_player_position_changed.new_position;
thread->debug("播放進度", QString("進度: %1").arg(position));
}
break;
case libvlc_MediaParsedChanged:
thread->debug("媒體信息", "");
break;
case libvlc_MediaPlayerOpening:
thread->debug("播放結束", "");
break;
case libvlc_MediaPlayerPlaying:
thread->debug("播放開始", "");
break;
case libvlc_MediaPlayerPaused:
thread->debug("播放暫停", "");
break;
case libvlc_MediaPlayerStopped:
thread->debug("播放停止", "");
break;
case libvlc_MediaPlayerEndReached: {
thread->debug("播放結束", "");
thread->stop2();
}
break;
case libvlc_MediaPlayerEncounteredError: {
thread->debug("發生錯誤", "");
thread->stop2();
}
break;
case libvlc_MediaPlayerVout: {
//識別尺寸發生變化
thread->checkVideoSize();
}
break;
default:
break;
}
}
五、功能特點
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版本,全部做了兼容處理。