ONVIF簡(jiǎn)介
ONVIF規(guī)范描述了網(wǎng)絡(luò)視頻的模型趟据、接口券犁、數(shù)據(jù)類型以及數(shù)據(jù)交互的模式。并復(fù)用了一些現(xiàn)有的標(biāo)準(zhǔn)汹碱,如WS系列標(biāo)準(zhǔn)等粘衬。ONVIF規(guī)范的目標(biāo)是實(shí)現(xiàn)一個(gè)網(wǎng)絡(luò)視頻框架協(xié)議,使不同廠商所生產(chǎn)的網(wǎng)絡(luò)視頻產(chǎn)品(包括攝錄前端咳促、錄像設(shè)備等)完全互通稚新。
ONVIF規(guī)范中設(shè)備管理和控制部分所定義的接口均以Web Service的形式提供。ONVIF規(guī)范涵蓋了完全的XML及WSDL的定義跪腹。每一個(gè)支持ONVIF規(guī)范的終端設(shè)備均須提供與功能相應(yīng)的Web Service褂删。服務(wù)端與客戶端的數(shù)據(jù)交互采用SOAP協(xié)議。ONVIF中的其他部分比如音視頻流則通過(guò)RTP/RTSP進(jìn)行冲茸。
使用gSOAP生成ONVIF開發(fā)框架(C++)
下載gSOAP
從gSoap官網(wǎng)下載gSoap(筆者用的是gSoap_2.8.45)屯阀。gSoap有兩個(gè)版本:commercial edition 和 open source edition缅帘。下載open source edition即可。
在Linux下重新編譯gSoap源碼
由于2017年3月底ONVIF官網(wǎng)進(jìn)行了一次改版难衰,改版后WSDL的URL地址變成HTTPS钦无,而gSoap官方編譯好的Windows版本的wsdl2h.exe默認(rèn)是禁止SSL/TLS的,不支持HTTPS下載WSDL文件盖袭,所以需要自己重新編譯gSoap源碼失暂,使其開啟SSL/TLS。
安裝必要程序
編譯gSoap前安裝Bison苍凛、Flex和OpenSSL趣席。安裝OpenSSL時(shí)記得將.so文件路徑/usr/local/ssl/lib追加到/etc/ld.so.conf文件末尾,否則后面編譯會(huì)出錯(cuò)醇蝴。
編譯源碼
編譯源碼命令如下:
$ 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
檢查是否能運(yùn)行
$ wsdl2h -h
解壓gSoap并建立文件夾層次
新建一個(gè)文件夾,命名為OnvifFramework(C++)想罕,將下載下來(lái)的gsoap_x.x.xx.zip解壓到該文件夾悠栓。在該文件夾下新建兩個(gè)文件夾,分別命名為:level1和ver10按价。在level1文件夾下新建一個(gè)文件夾惭适,命名為:level2。在ver10文件夾下新建一個(gè)文件夾楼镐,命名為schema癞志。在level2文件夾下新建三個(gè)文件夾,分別命名為:FrameworkSource框产、GenerateSource凄杯、ver10。在ver10文件夾下建立三個(gè)文件夾秉宿,分別命名為:device戒突、media、schema描睦。在device和media文件夾下新建一個(gè)文件夾膊存,命名為wsdl。文件夾務(wù)必按這個(gè)順序建立忱叭。最后將OnvifFramework(C++)\gsoap-2.8\gsoap路徑下的typemap.dat和剛剛編譯生成的wsdl2h隔崎、soapcpp2拷貝到GenerateSource文件夾下。
文件夾層次結(jié)構(gòu)如下圖所示:
下載ONVIF WSDL文件
1.從ONVIF官網(wǎng)下載 Service definitions 和 Schema files 下的所有.wsdl和.xsd文件(右鍵-從鏈接另存文件為)即可韵丑。(此種方法下載的文件不適用本教程爵卒,新版本的ONVIF文件夾結(jié)構(gòu)與上述的不同)
2.下載我已打包好的ONVIF WSDL壓縮包。
拷貝必要文件到文件夾相應(yīng)目錄
將下載下來(lái)的wsdl放在GenerateSource文件夾內(nèi)埂息〖寂耍拷貝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工具,根據(jù)WSDL產(chǎn)生頭文件
生成方式分為在線生成和本地生成兩種值桩,鑒于在線生成的不穩(wěn)定性摆霉,筆者采用本地生成方式。打開控制臺(tái)奔坟,切換到GenerateSource路徑下携栋,在控制臺(tái)中輸入(每個(gè).wsdl文件之間用一個(gè)空格隔開)
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.因?yàn)殍b權(quán)的需要,在onvif.h頭文件中加入#import "wsse.h"咳秉。
2.避免接下來(lái)產(chǎn)生框架發(fā)生錯(cuò)誤婉支,修改OnvifFramework(C++)\gsoap-2.8\gsoap\import路徑下的wsa5.h,將SOAP_ENV__Fault
結(jié)構(gòu)體名字修改為SOAP_ENV__Fault_alex
澜建。
使用soapcpp2工具向挖,根據(jù)頭文件產(chǎn)生框架代碼
打開控制臺(tái),切換到GenerateSource路徑下炕舵,在控制臺(tái)中輸入
soapcpp2 -j onvif.h -I../../../gsoap-2.8/gsoap/import:../../../gsoap-2.8/gsoap
看到Compilation successful即為成功何之。
整理框架代碼
將生成的.h(onvif.h 除外,該文件已經(jīng)沒用了)和.cpp文件以及wsdd.nsmap文件(會(huì)生成好多個(gè).nsmap文件咽筋,文件內(nèi)容一模一樣溶推,拷貝一個(gè)即可)拷貝到FrameworkSource中,并拷貝OnvifFramework(C++)\gsoap-2.8\gsoap路徑下的stdsoap2.h和stdsoap2.cpp(在文件開頭加入#include "wsdd.nsmap"
奸攻,以便后續(xù)順利通過(guò)編譯)以及OnvifFramework(C++)\gsoap-2.8\gsoap\custom路徑下的duration.h和duration.c(將其后綴名改為.cpp蒜危,以便后續(xù)順利通過(guò)編譯)到該文件夾。完整ONVIF開發(fā)框架(C++)舞箍。
總結(jié)
至此舰褪,ONVIF開發(fā)框架(C++)就搭建成功了,以后開發(fā)ONVIF時(shí)疏橄,直接拷貝FrameworkSource文件夾中的文件即可(開發(fā)ONVIF客戶端程序占拍,使用XXXXProxy.h和XXXXProxy.cpp,開發(fā)ONVIF服務(wù)器端程序捎迫,使用XXXXService.h和XXXXService.cpp)晃酒。