Qt音视频开发35-Onvif图片参数

一、前言

视频中的图片的配置参数一般有亮度、饱和度、对比度、锐度等，以前一直以为这些需要通过厂家的私有协议SDK来设置才行，后面通过研究Onvif Device Manager 和 Onvif Device Test Tool 这两个onvif开发的必备工具以后，发现onvif协议也具备了修改 亮度、色彩度、饱和度这三个参数，当然这三个参数我见过的摄像机厂家（主流的十几种）都具备，还有些大厂做的设备还提供了其他详细图片参数的设置比如ICAT。

通过万能的超级牛逼的抓包工具Wireshark抓包分析，发现 对图片参数进行设置（亮度、色彩度、饱和度）的参数中除了指定填入亮度、色彩度、饱和度的值以外，还需要指定VideoSourceToken，这玩意从哪里来呢？需要通过获取VideoSource拿到，即GetVideoSources命令，一般来说会在获取设备的rtsp地址、ptz云台地址等信息的时候一并获取，获取到以后存入onvifdevice类的变量中，下次设置图片参数的时候直接取就行。

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. 广播搜索设备，支持IPC和NVR，依次返回，可选择不同的网卡IP。
2. 依次获取Onvif地址、Media地址、Profile文件、Rtsp地址。
3. 可对指定的Profile获取视频流Rtsp地址，比如主码流子码流地址。
4. 可对每个设备设置Onvif用户信息，用于认证获取详细信息。
5. 可实时预览摄像机图像。
6. 支持云台控制，可上下左右调节云台，支持绝对移动和相对移动，可放到和缩小图像远近。
7. 支持Qt4和Qt5任意Qt版本，亲测Qt4.7.0到Qt5.14.2。
8. 支持任意编译器，亲测mingw、msvc、gcc、clang。
9. 支持任意操作系统，亲测xp、win7、win10、android、linux、嵌入式linux、树莓派全志H3等。
10. 支持任意Onvif摄像机和NVR，亲测海康、大华、宇视、华为、海思芯片内核等，可定制开发。
11. 支持对指定IP地址及onvif地址进行单播搜索，比如跨网段情况下非常有用。
12. 支持指定过滤条件过滤搜索设备。
13. 支持搜索间隔设置，保证所有设备搜索回来，在大量设备现场很有用。
14. 可对图片参数（亮度、色彩度、饱和度）进行设置。
15. 支持NTP校时和时间同步设置。
16. 纯Qt编写，超级小巧轻量，总共约2000行代码，不依赖任何第三方的库和组件，跨平台。
17. 封装好了通用的数据发送和接收解析的函数，可以非常方便的自行拓展其他Onvif处理。
18. 工具上提供了收发数据文本框，显示收发的数据，方便查看和分析。
19. 支持所有Onvif设备，代码工整，接口友好，直接引入pri即可使用。

三、效果图

四、相关站点

1. 国内站点：https://gitee.com/feiyangqingyun/QWidgetDemo
2. 国际站点：https://github.com/feiyangqingyun/QWidgetDemo
3. 个人主页：https://blog.csdn.net/feiyangqingyun
4. 知乎主页：https://www.zhihu.com/people/feiyangqingyun/
5. 体验地址：https://blog.csdn.net/feiyangqingyun/article/details/97565652

五、核心代码

QString OnvifOther::getVideoSource()
{
    QString result = writeData("    <trt:GetVideoSources/>", "", "获取视频参数", false, false, 1);
    QStringList list = result.split(ResultSplit);
    QString videosource = list.first().split(":").last();
    device->videoSource = videosource;
    return result;
}

QString OnvifOther::getImageSetting(int &brightness, int &colorSaturation, int &contrast)
{
    brightness = colorSaturation = contrast = 0;
    QString wsdl = "http://www.onvif.org/ver20/imaging/wsdl";

    QStringList list;
    list << QString("    <GetImagingSettings xmlns=\"%1\">").arg(wsdl);
    list << QString("      <VideoSourceToken>%1</VideoSourceToken>").arg(device->videoSource);
    list << QString("    </GetImagingSettings>");

    QString result = writeData(list.join("\r\n"), "Brightness|ColorSaturation|Contrast", "获取图片参数", false);
    list = result.split(ResultSplit);
    if (list.count() != 3) {
        return result;
    }

    brightness = list.at(0).split(":").last().toInt();
    colorSaturation = list.at(1).split(":").last().toInt();
    contrast = list.at(2).split(":").last().toInt();
    return result;
}

bool OnvifOther::setImageSetting(int brightness, int colorSaturation, int contrast)
{
    QString wsdl = "http://www.onvif.org/ver20/imaging/wsdl";
    QString schema = "http://www.onvif.org/ver10/schema";

    QStringList list;
    list << QString("    <SetImagingSettings xmlns=\"%1\">").arg(wsdl);
    list << QString("      <VideoSourceToken>%1</VideoSourceToken>").arg(device->videoSource);
    list << QString("      <ImagingSettings>");
    list << QString("        <Brightness  xmlns=\"%1\">%2</Brightness>").arg(schema).arg(brightness);
    list << QString("        <ColorSaturation  xmlns=\"%1\">%2</ColorSaturation>").arg(schema).arg(colorSaturation);
    list << QString("        <Contrast  xmlns=\"%1\">%2</Contrast>").arg(schema).arg(contrast);
    list << QString("      </ImagingSettings>");
    list << QString("      <ForcePersistence>true</ForcePersistence>");
    list << QString("    </SetImagingSettings>");

    QString result = writeData(list.join("\r\n"), "SetImagingSettingsResponse", "设置图片参数", false);
    return result.contains("SetImagingSettingsResponse");
}