一、前言

在安防视频监控行业，Onvif作为国际标准，几乎主要的厂商都支持，不仅包含了国内的厂商，也包括主要的国际厂商，由于有了这个标准的存在，使得不同设备不同安防平台之间，能够接入各个厂家的硬件设备，互通有无，你中有我我中有你，实现良性竞争。ONVIF是一个全球性的开放式行业协议，其目标是促进开发和使用基于物理IP的安全产品接口的全球开放标准。ONVIF创建了一个视频监控和其他物理安全领域的IP产品如何进行相互通信的标准。

这里需要特别强调的是，onvif只是个文本协议，并不包括视频流的传输，onvif协议可以拿到视频流地址比如rtsp地址，至于rtsp如何传输这是其他的事情，你可以用ffmpeg或者live555去做解析。本人在接触和使用了众多的相关监控设备后，总结的onvif的主要功能如下：

1. 搜索设备，获取设备的信息比如厂家、型号等。
2. 获取设备的多个配置文件信息profile。
3. 获取对应配置文件的视频流地址rtsp，以及分辨率等参数。
4. 云台控制，上下左右移动，焦距放大缩小，相对和绝对移动。
5. 获取预置位信息，触发预置位。
6. 订阅事件，接收设备的各种消息尤其是报警事件比如IO口的报警。
7. 抓图，获取设备当前的图片。
8. 获取、创建、删除用户信息。
9. 获取和设备网络配置信息比如IP地址等。
10. 获取和设置NTP时间同步以及设置设备时间。
11. 获取和设置视频参数和图片参数（亮度、色彩、饱和度）。
12. 重启设备。
13. 增加、删除、修改、查询OSD信息。

主要处理流程：

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数据，带有前缀命名空间，解析的时候要注意。
8. 每个厂家设备返回的数据未必完全一致，基本上都不一致，需要进行模糊查找节点值。
9. 特意采用底层协议解析，因为soap太臃肿函数名称太另类，特意做的轻量级的。
10. 两个必备工具，Onvif Device Manager 和 Onvif Device Test Tool。

本组件代码使用说明：

1. 第一步：拷贝onvif组件源码到你的项目，放到同级目录。
2. 第二步：在项目pro文件中引入组件 include ($$PWD/…/core_onvif/core_onvif.pri)。
3. 第三步：代码文件引入头文件 #include “onvifsearch.h” #include “onvifdevice.h”，其中onvifsearch用于搜索设备，onvifdevice用于获取设备的详细信息比如rtsp视频流地址。
4. 第四步：组播或者单播搜索设备，获取到对应的onvif地址。每个设备都有一个唯一的onvif地址。

//实例化搜索对象并关联信号槽
OnvifSearch *search = new OnvifSearch(this);
connect(search, SIGNAL(receiveDevice(OnvifDeviceInfo)), this, SLOT(receiveDevice(OnvifDeviceInfo)));
//参数1是网卡地址/参数2指定地址则表示单播
search->search("192.168.0.110", "");void frmSimple::receiveDevice(const OnvifDeviceInfo &deviceInfo)
{QString msg = QString("收到设备: %1").arg(deviceInfo.onvifAddr);ui->textEdit->append(msg);QListWidgetItem *item = new QListWidgetItem;item->setText(deviceInfo.deviceIp);item->setData(Qt::UserRole, deviceInfo.onvifAddr);ui->listWidget->addItem(item);
}

5. 第五步：对指定的onvif地址发送http请求，获取详细信息。

//实例化onvif对象实例
OnvifDevice *device = new OnvifDevice(this);
//设置用户信息用于请求的时候认证用
device->setUserInfo("admin", "123456");
//设置请求地址
device->setOnvifAddr("http://192.168.0.64/onvif/device_service");//先获取服务文件
device->getServices();
//可能为空需要按照另一种方式获取
if (device->getMediaUrl().isEmpty()) {device->getCapabilities();
}//获取配置文件
QList<OnvifProfileInfo> profiles = device->getProfiles();
foreach (OnvifProfileInfo profile, profiles) {ui->cboxProfiles->addItem(profile.token);
}//对指定的配置文件获取视频地址
QString token = ui->cboxProfiles->currentText();
QString url = device->getStreamUri(token);
ui->txtStreamUri->setText(url);

6. 特别提示：可以在main.cpp中注释//frmMain w;打开frmSimple w;用来开启直接运行简单示例。

二、效果图

三、体验地址

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_onvif。
5. 视频主页：https://space.bilibili.com/687803542

四、功能特点

1. 广播搜索设备，支持IPC和NVR，依次返回。
2. 可选择不同的网卡IP进行对应网段设备的搜索。
3. 依次获取Onvif地址、Media地址、Profile文件、Rtsp地址。
4. 可对指定的Profile获取视频流Rtsp地址，比如主码流地址、子码流地址。
5. 可对每个设备设置Onvif用户信息，用于认证获取详细信息。
6. 可实时预览摄像机图像。
7. 支持云台控制，可上下左右调节云台，支持绝对移动、相对移动、连续移动三种方式，可对图像拉近拉远。
8. 支持获取预置位集合、调用预置位、添加预置位、删除预置位等。
9. 支持图片参数设置，包括亮度、对比度、饱和度、锐度等。
10. 支持Qt4和Qt6任意Qt版本以及后续Qt版本。
11. 支持任意编译器，亲测mingw、msvc、gcc、clang。
12. 支持任意操作系统，亲测xp、win7、win10、android、linux、嵌入式linux、树莓派全志H3等。
13. 支持任意Onvif摄像机和NVR，亲测海康、大华、宇视、天地伟业、华为、海思芯片内核等，可定制开发。
14. 支持对指定IP地址及onvif地址进行单播搜索，比如跨网段情况下非常有用。
15. 支持指定过滤条件过滤搜索设备，比如只搜索某个网段的设备或者针对某个地址的设备。
16. 支持搜索间隔和搜索策略设置，保证所有设备搜索回来，在大量设备现场很有用（亲测上千个摄像机现场，搜索回来的设备数量比摄像机厂家自带搜索工具还要准确）。
17. 可对设备进行重启、网络参数获取等。
18. 支持各种事件订阅（入侵报警、越界报警、遮挡报警等）、Onvif抓图等操作。
19. 支持NTP校时和时间同步设置。
20. 支持OSD相关操作，可以增删改查OSD信息。
21. 内置了线程实时执行Onvif指令队列，排队最大速度的执行对应的指令，执行结果信号发出。
22. 采用的最底层的TCP+UDP通信机制，原创最底层协议解析，纯QtWidget编写。
23. 超级小巧轻量，总共约3000行代码，不依赖任何第三方的库和组件，跨平台。
24. 封装好了通用的数据发送和接收解析的函数，可以非常方便的自行拓展其他Onvif处理。
25. 工具上提供了收发数据文本框，显示收发的数据，方便查看和分析。
26. 支持所有Onvif设备，代码工整，接口友好，直接引入pri即可使用。