ONVIF之开发框架搭建(C++)

ONVIF简介

ONVIF规范描述了网络视频的模型、接口、数据类型以及数据交互的模式。并复用了一些现有的标准,如WS系列标准等。ONVIF规范的目标是实现一个网络视频框架协议,使不同厂商所生产的网络视频产品(包括摄录前端、录像设备等)完全互通。
ONVIF规范中设备管理和控制部分所定义的接口均以Web Service的形式提供。ONVIF规范涵盖了完全的XML及WSDL的定义。每一个支持ONVIF规范的终端设备均须提供与功能相应的Web Service。服务端与客户端的数据交互采用SOAP协议。ONVIF中的其他部分比如音视频流则通过RTP/RTSP进行。

使用gSOAP生成ONVIF开发框架(C++)

下载gSOAP

从gSoap官网下载gSoap(笔者用的是gSoap_2.8.45)。gSoap有两个版本:commercial edition 和 open source edition。下载open source edition即可。

在Linux下重新编译gSoap源码

由于2017年3月底ONVIF官网进行了一次改版,改版后WSDL的URL地址变成HTTPS,而gSoap官方编译好的Windows版本的wsdl2h.exe默认是禁止SSL/TLS的,不支持HTTPS下载WSDL文件,所以需要自己重新编译gSoap源码,使其开启SSL/TLS。

安装必要程序

编译gSoap前安装BisonFlexOpenSSL安装OpenSSL时记得将.so文件路径/usr/local/ssl/lib追加到/etc/ld.so.conf文件末尾,否则后面编译会出错。

编译源码

编译源码命令如下:
$ cd gsoap-2.8
$ ./configure --with-openssl=/usr/local/ssl
$ make
$ make install
查看wsdl2h和soapcpp2安装路径
$ which wsdl2h soapcpp2
/usr/local/bin/wsdl2h
/usr/local/bin/soapcpp2
检查是否能运行
$ wsdl2h -h

解压gSoap并建立文件夹层次

新建一个文件夹,命名为OnvifFramework(C++),将下载下来的gsoap_x.x.xx.zip解压到该文件夹。在该文件夹下新建两个文件夹,分别命名为:level1和ver10。在level1文件夹下新建一个文件夹,命名为:level2。在ver10文件夹下新建一个文件夹,命名为schema。在level2文件夹下新建三个文件夹,分别命名为:FrameworkSource、GenerateSource、ver10。在ver10文件夹下建立三个文件夹,分别命名为:device、media、schema。在device和media文件夹下新建一个文件夹,命名为wsdl。文件夹务必按这个顺序建立。最后将OnvifFramework(C++)\gsoap-2.8\gsoap路径下的typemap.dat和刚刚编译生成的wsdl2h、soapcpp2拷贝到GenerateSource文件夹下。

文件夹层次结构如下图所示:

ONVIF之开发框架搭建(C++)_第1张图片
文件夹结构层次图

下载ONVIF WSDL文件

1.从ONVIF官网下载 Service definitions 和 Schema files 下的所有.wsdl和.xsd文件(右键-从链接另存文件为)即可。(此种方法下载的文件不适用本教程,新版本的ONVIF文件夹结构与上述的不同
2.下载我已打包好的ONVIF WSDL压缩包。

拷贝必要文件到文件夹相应目录

将下载下来的wsdl放在GenerateSource文件夹内。拷贝devicemgmt.wsdl到OnvifFramework(C++)\level1\level2\ver10\device\wsdl路径下,拷贝media.wsdl到OnvifFramework(C++)\level1\level2\ver10\media\wsdl路径下,拷贝onvif.xsd到OnvifFramework(C++)\level1\level2\ver10\schema路径下,拷贝onvif.xsd到OnvifFramework(C++)\ver10\schema路径下。

使用wsdl2h工具,根据WSDL产生头文件

生成方式分为在线生成和本地生成两种,鉴于在线生成的不稳定性,笔者采用本地生成方式。打开控制台,切换到GenerateSource路径下,在控制台中输入(每个.wsdl文件之间用一个空格隔开

wsdl2h -o onvif.h -t ./typemap.dat accesscontrol.wsdl accessrules.wsdl actionengine.wsdl advancedsecurity.wsdl  
analytics.wsdl analyticsdevice.wsdl credential.wsdl deviceio.wsdl devicemgmt.wsdl display.wsdl doorcontrol.wsdl
event.wsdl imaging.wsdl media.wsdl ptz.wsdl receiver.wsdl recording.wsdl remotediscovery.wsdl replay.wsdl  
schedule.wsdl search.wsdl  

修改生成的onvif.h及wsa5.h

1.因为鉴权的需要,在onvif.h头文件中加入#import "wsse.h"。
2.避免接下来产生框架发生错误,修改OnvifFramework(C++)\gsoap-2.8\gsoap\import路径下的wsa5.h,将SOAP_ENV__Fault结构体名字修改为SOAP_ENV__Fault_alex

使用soapcpp2工具,根据头文件产生框架代码

打开控制台,切换到GenerateSource路径下,在控制台中输入

soapcpp2 -j onvif.h -I../../../gsoap-2.8/gsoap/import:../../../gsoap-2.8/gsoap

看到Compilation successful即为成功。

整理框架代码

将生成的.h(onvif.h 除外,该文件已经没用了)和.cpp文件以及wsdd.nsmap文件(会生成好多个.nsmap文件,文件内容一模一样,拷贝一个即可)拷贝到FrameworkSource中,并拷贝OnvifFramework(C++)\gsoap-2.8\gsoap路径下的stdsoap2.hstdsoap2.cpp(在文件开头加入#include "wsdd.nsmap",以便后续顺利通过编译)以及OnvifFramework(C++)\gsoap-2.8\gsoap\custom路径下的duration.hduration.c(将其后缀名改为.cpp,以便后续顺利通过编译)到该文件夹。完整ONVIF开发框架(C++)。

总结

至此,ONVIF开发框架(C++)就搭建成功了,以后开发ONVIF时,直接拷贝FrameworkSource文件夹中的文件即可(开发ONVIF客户端程序,使用XXXXProxy.h和XXXXProxy.cpp,开发ONVIF服务器端程序,使用XXXXService.h和XXXXService.cpp)。

参考

  • ONVIF官网
  • ONVIF协议网络摄像机(IPC)客户端程序开发(6):使用gSOAP生成ONVIF框架代码

你可能感兴趣的:(ONVIF之开发框架搭建(C++))