libONVIF：开源ONVIF库的全面解析与使用指南

libONVIF：开源ONVIF库的全面解析与使用指南

【免费下载链接】libONVIF Yet another ONVIF library 项目地址: https://gitcode.com/gh_mirrors/li/libONVIF

libONVIF是一款基于ONVIF标准的开源C++库，旨在简化gsoap的使用复杂性，并提供高级类实现与多种ONVIF服务的无缝对接。该库支持跨平台开发，包括Android、Linux、Windows和macOS等多种操作系统。

技术架构与设计理念

libONVIF采用精心设计的架构，核心优势体现在以下几个方面：

• 线程安全性：大部分代码在多线程环境下仍能保持良好的运行性能
• gsoap封装：通过优雅的封装设计，开发者无需直接接触复杂的gsoap底层实现
• RAII资源管理：使用Request<>和Response<>类管理RPC参数，确保内存自动释放
• 全面的服务支持：涵盖ONVIF的十一项核心服务

支持的ONVIF服务

libONVIF目前支持以下ONVIF标准服务：

• 分析服务 (Analytics)：http://www.onvif.org/ver20/analytics/wsdl
• 设备管理 (Device)：http://www.onvif.org/ver10/device/wsdl
• 显示服务 (Display)：http://www.onvif.org/ver10/display/wsdl
• 事件处理 (Event)：http://www.onvif.org/ver10/events/wsdl
• 成像配置 (Imaging)：http://www.onvif.org/ver20/imaging/wsdl
• 媒体服务 (Media)：http://www.onvif.org/ver10/media/wsdl
• 媒体服务v2 (Media2)：http://www.onvif.org/ver20/media/wsdl
• PTZ控制 (PTZ)：http://www.onvif.org/ver20/ptz/wsdl
• 接收器服务 (Receiver)：http://www.onvif.org/ver10/receiver/wsdl
• 录制服务 (Recording)：http://www.onvif.org/ver10/recording/wsdl
• 回放服务 (Replay)：http://www.onvif.org/ver10/replay/wsdl

安装与构建

libONVIF使用CMake构建系统，支持多种构建方式：

使用Conan管理依赖

conan remote add tereius https://conan.privatehive.de/artifactory/api/conan/public-conan
conan install ./ -s build_type=Release --build missing

标准CMake构建

cd <build_dir>
cmake -G "Unix Makefiles" -DCMAKE_BUILD_TYPE=Release <git_root_dir>
cmake --build ./
sudo cmake --build ./ --target install

Android交叉编译

conan create ./ -pr:h ./buildProfiles/androidArmv8LinuxHost.profile -pr:b default --build missing

核心组件与使用示例

libONVIF提供了一系列客户端类，命名遵循Onvif*Client模式（*代表服务名称）。此外还包含两个重要辅助类：OnvifDiscovery用于WS发现功能，OnvifPullPoint用于ONVIF事件处理。

库中附带了一个名为ovifinfo的实用工具应用，可用于设备发现和信息查询：

#include "OnvifDiscoveryClient.h"
#include "OnvifDevice.h"

// 设备发现示例
auto discovery = new OnvifDiscoveryClient(QUrl("soap.udp://239.255.255.250:3702"), ctxBuilder.Build());
ProbeTypeRequest request;
request.Types = "tds:Device";
auto probeResponse = discovery->Probe(request, uuid);

应用场景

libONVIF适用于多种IP安防应用场景：

• 视频监控系统开发：轻松接入不同厂商的ONVIF兼容设备
• 智能安防解决方案：结合Analytics服务实现人脸识别和行为分析
• 远程监控应用：利用Media服务实现实时流媒体传输
• 智能家居集成：在智能家居系统中集成视频监控功能

项目特点

• 跨平台兼容性：支持主流操作系统平台
• 服务全覆盖：满足多样化ONVIF服务需求
• 易于使用：通过预定义客户端类简化ONVIF服务调用
• 配套工具完善：提供ovifinfo等实用工具辅助开发

开发建议

对于初次接触libONVIF的开发者，建议：

1. 首先阅读ONVIF程序员指南了解ONVIF标准基础
2. 研究ovifinfo应用的源代码学习基本用法
3. 参考ONVIFMonitor项目了解如何在QML应用中集成libONVIF
4. 充分利用库提供的RAII特性简化内存管理

libONVIF通过其强大的功能和易用性，为开发者提供了在ONVIF标准世界中游刃有余的开发体验。无论是经验丰富的安防系统开发者，还是初涉该领域的新手，都能从这个开源库中受益。

【免费下载链接】libONVIF Yet another ONVIF library 项目地址: https://gitcode.com/gh_mirrors/li/libONVIF