ONVIF协议网络摄像机(IPC)客户端程序开发使用ONVIF框架代码(C++)生成静态库04--＞Windows

Posted Mango酱

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了ONVIF协议网络摄像机(IPC)客户端程序开发使用ONVIF框架代码(C++)生成静态库04--＞Windows相关的知识，希望对你有一定的参考价值。

一 前提

先说一下，为什么不像前面Linux生成动态库那样去开发Onvif。因为Onvif的源码是没有那些＿_declspec（dlleXPort）指令，所以当你导出dll时，你会发现没有xxx.lib文件产生，在windows下你就没办法隐式调用dll了，除非你显示调用dll，即在程序中使用LoadLibrary()一个一个将要用到的函数加载进来，那么就会非常麻烦。

所以我们在windows下选择生成静态库去开发是比较好的选择。
注：生成dll有两种方法，一种是使用＿_declspec（dlleXPort）指令；另一种是使用DEF文件，可能这种方法方便，但是本人还没尝试过，有兴趣的可以试着这个思路去实现。

这里还是要提一点，为啥onvif开发要生成库比较好，因为使用gsoap生成的onvif源码是非常大的，如果不生成库，那么你每次更改自己的代码，即使onvif的源码没改变，每次编译都要4-8分钟，所以是非常浪费时间的，所以需要生成库进行开发。除非你不使用gsoap，而是自己实现onvif的客户端，那么就不需要关心是否生成库。

好了，我们确定了在windows要使用静态库开发，那么就开始撸。

二 编写cmake文件

为什么要使用cmake文件进行编译onvif源码生成静态库呢，因为cmake跨平台，方便Linux和Windows，在Linux下它会直接生成.a文件，在Windows下，它会先生成VS的项目，然后再由用户打开该VS项目进行生成静态库。

  • 1）首先创建一个CMake_Onvif根目录，用于存放相关内容。
  • 2）然后将上一篇我们使用gsoap生成的onvif源码 拷贝到这里，即ONVIFAPI里面的内容。
  • 3）因为onvif依赖openssl库，所以我们需要下载一个openssl。
    注意，openssl的版本与onvif的版本可能不一定兼容，我的openssl版本是"OpenSSL 1.1.1h 22 Sep 2020"，onvif版本是gsoap_2.8.109.zip，这两个是没问题的。
    后面当我使用新版本的gsoap_2.8.122.zip，配合"OpenSSL 1.1.1h 22 Sep 2020"，发现会报X509参数错误(反正一大堆错误)，看了一下是本应传回调函数的，但是实际上传了一个void*类型的成员参数，所以需要注意版本问题，建议如果你想用最新版的onvif，那么应该去openssl官网下载最新版本的openssl。这样能减少错误。

查看openssl的方法：

  • 1）若有执行文件，则执行：openssl version。

  • 2）若找不到执行文件，则去头文件的opensslv.h中找：

  • 4）先创建一个build目录。待会用来存放执行cmake文件产生的临时文件。

  • 5）创建一个名字为CMakeLists.txt的文件。添加以下内容：

重点讲一下下面比较重要的内容。
set(BUILD_USE_64BITS on)是用于开启64位静态库的编译；
“/bigobj”选项是因为onvif源码很大，不加的话会导致编译报错。cmake不加这个参数，可以直接在VS的：”属性->C/C++/命令行”加上也行。

cmake_minimum_required(VERSION 2.6)

project(ONVIF)
#打印
message(STATUS "binary dir: " $PROJECT_BINARY_DIR)
message(STATUS "source dir: " $PROJECT_SOURCE_DIR)

if (CMAKE_HOST_WIN32)
    set(WINDOWS 1)
elseif (CMAKE_HOST_APPLE)
    set(MACOS 1)
elseif (CMAKE_HOST_UNIX)
    set(LINUX 1)
endif ()

if(WINDOWS)
    message( "WINDOWS Platform......" )
    set(BUILD_USE_64BITS on)
    add_definitions(-DWITH_OPENSSL -DWITH_NONAMESPACES)
    set(CMAKE_CXX_FLAGS "$CMAKE_CXX_FLAGS /bigobj")
    #在Windows下，这样添加CMake参数，会被添加到C/C++的+选项的命令行当中，导致添加动态库错误
    #set(CMAKE_CXX_FLAGS_DEBUG "$ENVCXXFLAGS -O0 -g -ggdb -w -Wall -std=c++11 -fPIC -lssl -lcrypto")
elseif(LINUX)
    message( "LINUX Platform......" )
    set(CMAKE_CXX_FLAGS_DEBUG "$ENVCXXFLAGS -O0 -g -ggdb -w -Wall -std=c++11 -fPIC -lpthread -lssl -lcrypto -DWITH_OPENSSL -DWITH_NONAMESPACES ")
else()
    message( "MACOS Platform......" )
endif()

# 查找当前目录下的所有源文件，并将名称保存到 DIR_SRCS 变量
aux_source_directory(./ONVIFAPI/ DIR_SRCS)
set(CMAKE_BUILD_TYPE Debug)

#OPENSSL,尽量不要写当前路径，否则可以会报找不到动态库。
include_directories($PROJECT_SOURCE_DIR/openssl/include)
link_directories($PROJECT_SOURCE_DIR/openssl/lib)


# 生成链接库
#add_library(Onvif_Client SHARED $DIR_SRCS)
add_library(Onvif_Client STATIC $DIR_SRCS)

三 执行cmake文件

首先因为cmake是依赖VS这个软件去编译的，所以我们需要提前下载VS，我的是VS2015。然后我们可以查看当前cmake版本支持的编译器，执行：

cmake -G


图中看到，支持VS2017及以下的版本，因为我的是VS2015，所以执行命令：

cd build
# ..代表CMakeLists所在目录
cmake -G "Visual Studio 14 2015 Win64" ..

注意，若不加-G选项，cmake很可恶的，因为即使你在CMakeLists文件中加上set(BUILD_USE_64BITS on)设置了64位，但是它还是给你生成32bit的VS程序，即使你在VS将Win32平台改成x64，它还是不行，它会报错：fatal error LNK1112: 模块计算机类型“x64”与目标计算机类型“X86”冲突。

所以在执行cmake时，必须加上-G选项，表示我们要生成的是Win64位的VS项目。

四 运行生成的VS项目

通过上面后，在build目录下会生成一个VS项目，我们打开后缀为sln的VS项目。

然后右击ALL_BUILD，选择配置管理器，把生成的那一列全部勾上，不然待会会有个小报错，虽然不影响静态库的生成，但是总是不好看嘛。

然后执行程序即可。
我们会在Debug(你选择Release的话就是Release目录)目录下看的对应的静态库生成。

五 使用静态库

既然静态库生成了，那么肯定就是使用它呗。测试代码，以获取IPC的能力集为例子：

  • 1）新建Win32控制台项目，我的名字是TestOnvif，然后空项目即可。
  • 2）添加main.cpp文件。
  • 3）把相关库引入进来，用到的库就是上面编译生成的静态库，以及openssl库。那么将onvif静态库、openssl动态库的include、lib路径引入到VS项目中即可。openssl的dll我没放到生成的执行程序也能运行，那么这里就不管它了。

main.cpp的内容：

#include <iostream>

#include "soapH.h"
#include "soapStub.h"
#include "wsseapi.h"
#include "smdevp.h"
#include "wsaapi.h"
#include "mecevp.h"

int main() 

	printf("nihao\\n");

	struct soap *soap = NULL;                                                   // soap环境变量

	
	if (NULL == (soap = soap_new())) 
		printf("nihao111\\n");
		return -1;
	
	printf("nihao222\\n");

	soap_set_namespaces(soap, namespaces);                                      // 设置soap的namespaces
	soap->recv_timeout = 3;                                            			// 设置超时（超过指定时间没有数据就退出）
	soap->send_timeout = 3;
	soap->connect_timeout = 3;

#if defined(__linux__) || defined(__linux)                                      // 参考https://www.genivia.com/dev.html#client-c的修改：
	soap->socket_flags = MSG_NOSIGNAL;                                          // To prevent connection reset errors
#endif

	soap_set_mode(soap, SOAP_C_UTFSTRING);                                      // 设置为UTF-8编码，否则叠加中文OSD会乱码

	int result;

	struct _tds__GetCapabilities            req;
	struct _tds__GetCapabilitiesResponse    rep;

	result = soap_call___tds__GetCapabilities(soap, "http://192.168.1.186/onvif/device_service", NULL, &req, rep);// PRE_AUTH
	if (SOAP_OK != result) 
		const char **s = NULL;
		return -1;
	

	if (rep.Capabilities->Media != NULL)
	

		printf("-------------------Media-------------------\\n");
		printf("XAddr:%s\\n", rep.Capabilities->Media->XAddr.c_str());
		printf("-------------------streaming-------------------\\n");
		printf("RTPMulticast:%s\\n", (rep.Capabilities->Media->StreamingCapabilities->RTPMulticast) ? "Y" : "N");
		printf("RTP_TCP:%s\\n", (rep.Capabilities->Media->StreamingCapabilities->RTP_USCORETCP) ? "Y" : "N");
		printf("RTP_RTSP_TCP:%s\\n", (rep.Capabilities->Media->StreamingCapabilities->RTP_USCORERTSP_USCORETCP) ? "Y" : "N");
	

	if (rep.Capabilities->PTZ != NULL)
	
		printf("-------------------PTZ-------------------\\n");
		printf("XAddr:%s\\n", rep.Capabilities->PTZ->XAddr.c_str());
	

	Sleep(3);
	return 0;

然后看到，相关能力集是能拿到的，且程序编译就10秒左右，完全没问题，可以达到开发的目的，所以windows下使用静态库开发onvif是没问题的。

Linux下onvif客户端关于ipc摄像头的搜索

设备搜索：要访问一个IPC摄像头，或者说要调用IPC摄像头提供的WEB服务接口，就要先知道其IP地址，这就是设备发现的过程，或者叫设备搜索的过程。IPC摄像头用的是239.255.255.250（端口3702），所以设备搜索的原理是，只要在设备上服务器监听239.255.255.250的3702端口。ONVIF规范并没有自己定义服务设备发现框架，而是复用了已经很成熟的WS-Discovery标准，根据.wsdl的文件，用gsoap产生框架代码，调用其产生的函数接口去实现设备的搜索。

1、gsoap框架代码：https://blog.csdn.net/weixin_42432281/article/details/84818575

2、上一部如果完成，就直接略过，将安装的gsoap-2.8\\gsoap目录下的两个文件：stdsoap2.c、stdsoap2.h拷贝到你工作目录下

3、注释stdsoap2.c如下代码：不注释的话会在编译运行的时候产生log日志，最后会发现磁盘已满的现象。

/*

#ifdef SOAP_DEBUG

#ifdef TANDEM_NONSTOP

soap_set_test_logfile(soap, "TESTLOG");

soap_set_sent_logfile(soap, "SENTLOG");

soap_set_recv_logfile(soap, "RECVLOG");

#else

soap_set_test_logfile(soap, "TEST.log");

soap_set_sent_logfile(soap, "SENT.log");

soap_set_recv_logfile(soap, "RECV.log");

#endif

#endif

*/

和修改

if (/*s == r || *r || */n < -128 || n > 127)

4、将安装的gsoap2.8目录下的import目录，拷贝到生成.c、.h的工作的文件夹里，cp gsoap-2.8/gsoap/import ./  ,REAMOD.txt是我写的记录文档，不必在意，其他的文件都拷贝到这个目录下

5、设备搜索的代码：我是直接copy别人的代码，做了一下修改（https://blog.csdn.net/saloon_yuan/article/details/27524875）

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
 
#include "soapH.h"
#include "stdsoap2.h"
#include "soapStub.h"
 
#include "wsdd.nsmap" //命名空间
 
 
static struct soap* ONVIF_Initsoap(struct SOAP_ENV__Header *header, const char *was_To, const char *was_Action, int timeout)
{
    struct soap *soap = NULL;    // soap环境变量
    unsigned char macaddr[6];
    char _HwId[1024];
    unsigned int Flagrand;
 
    soap = soap_new();
    if(soap == NULL)
    {
        printf("[%d]soap = NULL\\n", __LINE__);
        return NULL;
    }
 
    soap_set_namespaces(soap, namespaces);   // 设置soap的namespaces，即设置命名空间
 
    // 设置超时（超过指定时间没有数据就退出）
    if(timeout > 0)
    {
        soap->recv_timeout = timeout;
        soap->send_timeout = timeout;
        soap->connect_timeout = timeout;
    }
    else
    {
        //Maximum waittime : 20s
        soap->recv_timeout  = 20;
        soap->send_timeout  = 20;
        soap->connect_timeout = 20;
    }
 
    soap_default_SOAP_ENV__Header(soap, header);
 
    //Create SessionID randomly,生成uuid(windows下叫guid，linux下叫uuid)，格式为urn:uuid:8-4-4-4-12，由系统随机产生
    srand((int)time(0));
    Flagrand = rand()%9000 + 8888;
    macaddr[0] = 0x1;
    macaddr[1] = 0x2;
    macaddr[2] = 0x3;
    macaddr[3] = 0x4;
    macaddr[4] = 0x5;
    macaddr[5] = 0x6;
    sprintf(_HwId, "urn:uuid:%ud68a-1dd2-11b2-a105-%02X%02X%02X%02X%02X%02X", Flagrand, macaddr[0], macaddr[1], macaddr[2],macaddr[3],macaddr[4],macaddr[5]);
    header->wsa__MessageID = (char *)malloc(100);  
    memset(header->wsa__MessageID, 0, 100);
    strncpy(header->wsa__MessageID, _HwId, strlen(_HwId));    //wsa__MessageID存放的是uuid
 
    if(was_Action != NULL)
    {
        header->wsa__Action = (char*)malloc(1024);
        memset(header->wsa__Action, \'\\0\', 1024);
        strncpy(header->wsa__Action, was_Action, 1024); //
    }
    if(was_To != NULL)
    {
        header->wsa__To = (char *)malloc(1024);
        memset(header->wsa__To, \'\\0\', 1024);
        strncpy(header->wsa__To, was_To, 1024);//"urn:schemas-xmlsoap-org:ws:2005:04:discovery";
    }
    soap->header = header;
    return soap;
}
 
 
//释放函数
void ONVIF_soap_delete(struct soap *soap)
{
    soap_destroy(soap);                                                         // remove deserialized class instances (C++ only)
    soap_end(soap);                                                             // Clean up deserialized data (except class instances) and temporary data
    soap_free(soap);                                                            // Reset and deallocate the context created with soap_new or soap_copy
}
 
 
int ONVIF_ClientDiscovery()
{
    int FoundDevNo = 0; 
    int retval = SOAP_OK;
    wsdd__ProbeType req;    // 用于发送Probe消息
    struct __wsdd__ProbeMatches resp;   // 用于接收Probe应答
    wsdd__ScopesType sScope;
    struct SOAP_ENV__Header header;
    struct soap* soap;
 
    const char *was_To = "urn:schemas-xmlsoap-org:ws:2005:04:discovery";
    const char *was_Action = "http://schemas.xmlsoap.org/ws/2005/04/discovery/Probe";
 
    //IP Adress and PortNo, broadCast
    const char *soap_endpoint = "soap.udp://239.255.255.250:3702/"; //设备上服务器监听239.255.255.250的3702端口
 
    //Create new soap object with info
    soap = ONVIF_Initsoap(&header, was_To, was_Action, 10);
 
    soap_default_SOAP_ENV__Header(soap, &header);
    soap->header = &header;
 
    soap_default_wsdd__ScopesType(soap, &sScope);  // 设置寻找设备的范围
    sScope.__item = NULL;
    soap_default_wsdd__ProbeType(soap, &req);  // 设置寻找设备的类型
    req.Scopes = &sScope;
    req.Types = NULL; //"dn:NetworkVideoTransmitter";
 
    //sent the message broadcast and wait
    retval = soap_send___wsdd__Probe(soap, soap_endpoint, NULL, &req);   // 向组播地址广播Probe消息
 
    while(retval == SOAP_OK)
    {
        printf("**************1**************\\n");
        retval = soap_recv___wsdd__ProbeMatches(soap, &resp);
        if(retval == SOAP_OK)
        {
            if(soap->error)
            {
                printf("[%d]:recv soap error :%d, %s, %s\\n", __LINE__, soap->error, *soap_faultcode(soap), *soap_faultstring(soap));
                retval = soap->error;
            }
            else //we find a device
            {
                FoundDevNo++;
                if(resp.wsdd__ProbeMatches->ProbeMatch != NULL && resp.wsdd__ProbeMatches->ProbeMatch->XAddrs != NULL)
                {
                    printf("***** No %d Devices Information *****\\n", FoundDevNo);
                    printf("Device Service Address : %s\\r\\n", resp.wsdd__ProbeMatches->ProbeMatch->XAddrs);
                    printf("Device EP Address      : %s\\r\\n", resp.wsdd__ProbeMatches->ProbeMatch->wsa__EndpointReference.Address);
                    printf("Device Type            : %s\\r\\n", resp.wsdd__ProbeMatches->ProbeMatch->Types);
                    printf("Device Metadata Version: %d\\r\\n", resp.wsdd__ProbeMatches->ProbeMatch->MetadataVersion);
 
 
                    printf("[%d]*********************************\\n", __LINE__);
                }
 
            }
        }
        else if(soap->error)
        {
            if(FoundDevNo == 0)
            {
                printf("No Device found!\\n");
                retval = soap->error;
            }
            else
            {
                printf("Search end! Find %d Device! \\n", FoundDevNo);
                retval = 0;
            }
            break;
        }
    }
 
    //释放函数
    ONVIF_soap_delete(soap);
    return retval;
}
 
int main(int argc, char *argv[])
{
    if(ONVIF_ClientDiscovery() != 0)
    {
        printf("discover failed! \\n");
        return -1;
    }
    return 0;
}

 

6、在编译时如果出现：对‘namespaces’未定义的引用，那是你在程序中没有加 #include "wsdd.nsmap" ，这个头文件，加上即可。

 

7、编译，生成可执行文件test：gcc -o test search_test.c  stdsoap2.c  soapC.c  soapClient.c -I import/

 

8、运行test： ./test

 

设备搜索已完成！

设备搜索的主要目的是获取他服务器的地址：http://172.168.0.216/onvif/device_service，为下一步获取能力做准备。

 

以上是关于ONVIF协议网络摄像机(IPC)客户端程序开发使用ONVIF框架代码(C++)生成静态库04--＞Windows的主要内容，如果未能解决你的问题，请参考以下文章

Linux下onvif客户端关于ipc摄像头的搜索

海康威视中文的摄像机IPC能接入到英文的NVR里面吗?

基于ONVIF协议的摄像头开发总结

tplink球机能不能用海康威视录像机操控云台？

波粒的网络摄像头能和海康兼容吗

Onvif协议接入分析学习总结（设备取流）