Qt音视频开发02-海康sdk解码（支持句柄/回调/GPU模式/支持win/linux）

一、前言

为何还要选用使用海康sdk，之前不是ffmpeg已经牛皮吹上天了吗？这个问题问得好，那是因为无论ffmpeg也好还是vlc/mpv之类的，都是实现的播放相关，不同的监控硬件厂家对应设备还有很多特殊的处理，这些处理和视频播放无关的，基本上不同的厂家设备都不同的处理，都是私有协议去处理，比如雨刷、光圈调节，远程视频文件回放、远程视频文件下载等，这些都在私有sdk中才有的，针对特定的应用行业场景需要这些sdk去通信。

做过海康sdk开发的人都会遇到一个问题，那就是64位的库对应头文件不兼容的问题，可以参考 https://zhuanlan.zhihu.com/p/362149017，帮助文档上也有错误，我在这个地方也是折腾了很久，海康sdk提供两个库，一个是解码库，一个是播放库，这两个库中都有播放视频的头文件，不知道为什么没有统一，其实是可以统一的，最终选择播放库中这个头文件就可以了，官方这个BUG一直没有修复。

二、功能特点

2.1 基础功能

支持各种音频视频文件格式，比如mp3、wav、mp4、asf、rm、rmvb、mkv等。
支持本地摄像头设备，可指定分辨率、帧率。
支持各种视频流格式，比如rtp、rtsp、rtmp、http等。
本地音视频文件和网络音视频文件，自动识别文件长度、播放进度、音量大小、静音状态等。
文件可以指定播放位置、调节音量大小、设置静音状态等。
支持倍速播放文件，可选0.5倍、1.0倍、2.5倍、5.0倍等速度，相当于慢放和快放。
支持开始播放、停止播放、暂停播放、继续播放。
支持抓拍截图，可指定文件路径，可选抓拍完成是否自动显示预览。
支持录像存储，手动开始录像、停止录像，部分内核支持暂停录像后继续录像，跳过不需要录像的部分。
支持无感知切换循环播放、自动重连等机制。
提供播放成功、播放完成、收到解码图片、收到抓拍图片、视频尺寸变化、录像状态变化等信号。
多线程处理，一个解码一个线程，不卡主界面。

2.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，兼容所有版本。

2.3 视频控件

可动态添加任意多个osd标签信息，标签信息包括名字、是否可见、字号大小、文本文字、文本颜色、标签图片、标签坐标、标签格式（文本、日期、时间、日期时间、图片）、标签位置（左上角、左下角、右上角、右下角、居中、自定义坐标）。
可动态添加任意多个图形信息，这个非常有用，比如人工智能算法解析后的图形区域信息直接发给视频控件即可。图形信息支持任意形状，直接绘制在原始图片上，采用绝对坐标。
图形信息包括名字、边框大小、边框颜色、背景颜色、矩形区域、路径集合、点坐标集合等。
每个图形信息都可指定三种区域中的一种或者多种，指定了的都会绘制。
内置悬浮条控件，悬浮条位置支持顶部、底部、左侧、右侧。
悬浮条控件参数包括边距、间距、背景透明度、背景颜色、文本颜色、按下颜色、位置、按钮图标代码集合、按钮名称标识集合、按钮提示信息集合。
悬浮条控件一排工具按钮可自定义，通过结构体参数设置，图标可选图形字体还是自定义图片。
悬浮条按钮内部实现了录像切换、抓拍截图、静音切换、关闭视频等功能，也可以自行在源码中增加自己对应的功能。
悬浮条按钮对应实现了功能的按钮，有对应图标切换处理，比如录像按钮按下后会切换到正在录像中的图标，声音按钮切换后变成静音图标，再次切换还原。
悬浮条按钮单击后都用名称唯一标识作为信号发出，可以自行关联响应处理。
悬浮条空白区域可以显示提示信息，默认显示当前视频分辨率大小，可以增加帧率、码流大小等信息。
视频控件参数包括边框大小、边框颜色、焦点颜色、背景颜色（默认透明）、文字颜色（默认全局文字颜色）、填充颜色（视频外的空白处填充黑色）、背景文字、背景图片（如果设置了图片优先取图片）、是否拷贝图片、缩放显示模式（自动调整、等比例缩放、拉伸填充）、视频显示模式（句柄、绘制、GPU）、启用悬浮条、悬浮条尺寸（横向为高度、纵向为宽度）、悬浮条位置（顶部、底部、左侧、右侧）。

2.4 内核海康sdk

支持海康设备视频流、MP4录像文件、本地MP4视频文件播放。
支持windows、linux系统，支持32位、64位的库。
支持句柄、绘制（回调拿到数据转QImage绘制）、GPU（回调拿到数据转yuv用QOpenGLWidget绘制）三种视频显示模式。
本地文件支持开始播放、暂停播放、继续播放、停止播放、设置播放进度、倍速播放。
可设置音量、静音切换、抓拍图片、录像存储。
回调除了拿到图片数据还支持拿到音频数据并播放。
可以获取每一帧的世界时间，比如 2022-09-08 11:11:11 000 表示该帧在 2022-09-08 11:11:11 000 存储的，可以很方便用于回放录像标记。

三、体验地址

国内站点：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。

四、效果图

五、相关代码

bool HaiKangThread::openRtsp(QWidget *widget)
{//可以根据实际需求启用过滤非海康设备(有部分第三方厂家的设备也兼容海康私有协议)if (!HaiKangHelper::isHaiKangDevice(videoUrl)) {debug("地址有误", "原因: 不是海康设备地址");//return false;}//从视频地址取出设备信息和用户信息等QString ip, userName, userPwd;int port, channel, streamType;HaiKangHelper::getDeviceInfo(videoUrl, ip, port, channel, streamType, userName, userPwd);QString msg = QString("地址: %1 用户: %2 密码: %3 端口: %4 通道: %5 码流: %6").arg(ip).arg(userName).arg(userPwd).arg(port).arg(channel).arg(streamType);debug("设备信息", msg);//登录设备NET_DVR_DEVICEINFO_V30 deviceInfo;userid = NET_DVR_Login_V30(ip.toUtf8().data(), port, userName.toUtf8().data(), userPwd.toUtf8().data(), &deviceInfo);if (userid >= 0) {//获取设备配置信息NET_DVR_COMPRESSIONCFG_V30 deviceConfig = {0};DWORD dwRet = 0;NET_DVR_GetDVRConfig(userid, NET_DVR_GET_COMPRESSCFG_V30, channel, &deviceConfig, sizeof(deviceConfig), &dwRet);frameRate = deviceConfig.struNormHighRecordPara.dwVideoFrameRate;//主码流和子码流获取对应的分辨率int resolution = (streamType == 0 ? deviceConfig.struNormHighRecordPara.byResolution : deviceConfig.struNetPara.byResolution);HaiKangHelper::getResolution(resolution, videoWidth, videoHeight);msg = QString("宽高: %1x%2 - %3").arg(videoWidth).arg(videoHeight).arg(resolution);debug("登录成功", msg);//以下参数具体见对应头文件说明NET_DVR_PREVIEWINFO previewInfo;previewInfo.lChannel = channel;previewInfo.dwStreamType = streamType;previewInfo.dwLinkMode = (transport == "tcp" ? 0 : 1);previewInfo.bBlocked = 0;previewInfo.byProtoType = 1;previewInfo.byPreviewMode = 0;previewInfo.dwDisplayBufNum = 15;//回调则可以拿到音视频数据if (videoMode == VideoMode_Hwnd) {previewInfo.hPlayWnd = (HWND)widget->winId();hwnd = NET_DVR_RealPlay_V40(userid, &previewInfo, NULL, NULL);//海康视频流默认打开后声音是0emit receiveVolume(0);} else {this->initData();hwnd = NET_DVR_RealPlay_V40(userid, &previewInfo, HaiKangHelper::RealDataCallBack, callbackData);}if (hwnd < 0) {debug("打开失败", QString("错误: %1").arg(NET_DVR_GetLastError()));}return (hwnd >= 0);} else {debug("登录失败", QString("错误: %1").arg(NET_DVR_GetLastError()));return false;}
}bool HaiKangThread::openFile(QWidget *widget)
{//转码以便支持中文路径QTextCodec *codec = QTextCodec::codecForName("gb2312");QByteArray data = codec->fromUnicode(videoUrl);PlayM4_GetPort(&port);bool ok = PlayM4_OpenFile(port, data.data());if (ok) {//设置文件播放完毕回调函数PlayM4_SetFileEndCallback(port, HaiKangHelper::FileEndCallback, this);//回调则可以拿到音视频数据if (videoMode == VideoMode_Hwnd) {PlayM4_Play(port, (HWND)widget->winId());} else {this->initData();PlayM4_SetDecCallBackMend(port, HaiKangHelper::DecCallBack, callbackData);PlayM4_Play(port, NULL);}//同时播放声音//PlayM4_PlaySound(port);PlayM4_PlaySoundShare(port);return true;} else {debug("打开失败", "错误: %1" + PlayM4_GetLastError(port));return false;}
}

Qt音视频开发02-海康sdk解码（支持句柄/回调/GPU模式/支持win/linux）相关推荐

Qt音视频开发06-海康sdk内核linux客户端
一.前言海康sdk的示例在官方是提供了的,但是无论UI还是交互简直是宇宙无敌的垃圾,猜测应该是初学者编写的,估计练手用的,所以老早就想把这个linux支持集成到自己的示例中,既然已经支持了windo ...
Qt音视频开发18-海康sdk回调
一.前言海康sdk显示实时视频流除了支持句柄方式以外,也支持回调的方式拿到每一张图片自己绘制处理,当然回调除了拿到视频数据,其实音频数据也一块拿到了,自行调用音频设备播放就行,关于海康sdk回调这块 ...
Qt音视频开发01-共享解码线程（耗时一年/性能凶残/至臻完美）
一.前言大概在8年前就开始用ffmpeg做视频解码的显示,第一个版本就100行代码左右,功能极其简单,就是开个线程解码视频流转成图片发给主界面绘制.时间过得真快,从当初的一胎到现在二胎都上学了三胎计 ...
Qt音视频开发44-实时人脸框
一.前言在人脸识别到以后,需要在实时视频上将所有人脸框绘制出来,一把来说识别人脸会有多种选择,一个是识别最大人脸,这种场景主要用于刷脸门禁,还有一种是识别所有人脸,这种场景主要用于人脸识别摄像机,就 ...
Qt音视频开发27-Onvif设备搜索
一.前言最近业余时间主要研究音视频开发这块,前面的文章写了好多种视频监控内核,一旦将这些内核搞定以后,视频监控的相关功能水到渠成.做视频监控系统,绕不过onvif这玩意,这玩意主要就是为了统一一个大 ...
C#：使用海康SDK解码回调函数DecCallbackFUN()
简述使用海康摄像头采集图像时,需要在图像上添加图标.文字等额外数据.可选择使用海康SDK绘图回调函数叠加字符.图像等(请参考上一篇文章):也可使用海康SDK的解码回调函数,对视频流数据进行解码后 ...
Qt音视频开发49-通用截图截屏
一.前言采用了回调方式的视频通道,截图只需要对解析好的QImage对象直接保存即可,而对于句柄的形式,需要调用不同的处理策略,比如vlc需要用它自己提供的api接口函数libvlc_video_ta ...
Qt音视频开发21-通用硬解码
一.前言硬件解码是图形芯片厂家提出的用GPU资源解码视频流的方案,与之相对的是软解,也就是传统的用CPU承担解码工作的方案:优点是效率高,功耗低.热功耗低,缺点是缺乏有力的支持(包括滤镜.字幕等), ...
QT 音视频开发基于gstreamer框架
在音视频领域接触最多实现的方案通常是通过ffmpeg(PC和sever端居多)或者硬件厂家的的SDK实现特定硬件的编解码功能(机顶盒,电视等嵌入式设备).国内不太常用的解决方案gstreamer gs ...