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前安装Bison、Flex和OpenSSL。安装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 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.h和stdsoap2.cpp（在文件开头加入#include "wsdd.nsmap"，以便后续顺利通过编译）以及OnvifFramework(C++)\gsoap-2.8\gsoap\custom路径下的duration.h和duration.c（将其后缀名改为.cpp，以便后续顺利通过编译）到该文件夹。完整ONVIF开发框架（C++）。

总结

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

ONVIF之开发框架搭建（C++）