Onvif学习笔记2 - 客户端搜索与能力获取实例讲解

最新推荐文章于 2024-06-27 08:16:30 发布

bluish_white

最新推荐文章于 2024-06-27 08:16:30 发布

阅读量3.1k

点赞数

分类专栏： Onvif 文章标签： onvif

本文链接：https://blog.csdn.net/bluish_white/article/details/78149928

版权

Onvif 专栏收录该内容

4 篇文章 1 订阅

订阅专栏

注：由于我实际开发中参考的代码主要来自于博客园 DoubleLi，所以完整的源码我会给出原博主的链接，我在这篇文章里可能主要就是对设备搜索的流程和原博主没说明的地方详细解释。

设备搜索

原博主源码地址：《Onvif开发之客户端搜索篇》（http://www.cnblogs.com/lidabo/p/6604957.html）

首先，Onvif使用了 IP：239.255.255.250 / Port：3702 的组播地址。

客户端在网段内发送Probe，网段内的Onvif服务端设备在收到这个Probe之后会生成一个ProbeMatch来回复给客户端，其中包含了这个服务端设备的基本信息。

根据之前生成的Onvif框架，这个ProbeMatch对应的结构体是

struct __wsdd__ProbeMatches

在DoubleLi的博文中，主要的流程是：

1. 初始化一个soap对象。

在ONVIF_ClientDiscovery函数中，struct SOAP_ENV__Header header指的是 SOAP的Envelope元素，was_To，was_Action也是用于header中填充数据的传参。

2. ONVIF_Initsoap()

定义完上述内容后，这位博主做了这个Initsoap接口，同时他也说明了这个接口是为了后续的方便，这个方便其实是对于后面的开发的鉴权操作。在搜索这一部分暂时用不到。

在这个接口里有一段代码是用于生成uuid的，这个uuid是用来填充header->wsa_MessageID字段的。因为每次的取值都要求不一样，所以使用了部分随机数+部分定值的组合方式。uuid的生成其实有一些开源方法的实现，但是这里的使用随机数做法比较取巧。

关于为什么每次的uuid都要不同：我也不知道，但是Onvif官方的《 Application Programmers Guide 》（APG）里说明了这一条。

// Each probe should have a unique MessageID to be able to match requests and responses.

3. soap_send___wsdd__Porbe() 和 soap_recv___wsdd__ProbeMatches()

这部分也就是Probe探针的发送和接收。

完整地贴一下APG里的文本：

/* ONVIF::Discovery */
// Send WS-Discovery Probe, collect the responses and then
// process the responses.
probematch_type probematcheslist[]={};
// Send probe. See chapter 4.3.1 for details
probe = ONVIF::DiscoverySendProbe(scopes, types);
// Wait a while for responses
while (data_available_and_not_timeout(probe.net_handle))
{
// This fetch next probe match so that we can put it into the list
// See chapter 4.3.2 for details
probematch = ONVIF::DiscoveryReadResponse(probe);
// Store info about the match, first check for duplicates
if (!in_list(probematcheslist, probematch))
{
    add_to_list(probematcheslist, probematch);
}
}
// Process the responses, see chapter 5.1.3 for details.
foreach (probeMatch in probematcheslist)
{
    ONVIF::ProcessMatch(probeMatch);
}

/* ONVIF::DiscoverySendProbe */
DiscoverySendProbe(scopes, types)
{
// Each probe should have a unique MessageID to be able to match
// requests and responses. We store it in the probe place holder for later checking
probe.MessageID = "uuid:" + App.uuidGenerate();
// Build probe message, we provide
// MessageID, Types and Scopes. See SOAP trace section for how
// it actually looks like.
message = App.BuildProbeMessage(probe.MessageID, types, scopes);
// Send probe to multicast address and port according to [WS-Discovery] section 2.4
probe.net_handle = App.send_multicast("239.255.255.250", 3702, message);
return probe;
}

/* ONVIF::DiscoveryReadResponse */
DiscoveryReadResponse(probe)
{
// Read response and process it.
// We need both the body and the Header:
aProbeMatches = App.ReadProbeMatches(probe.net_handle, Header);
// Check if this is a response to the probe we sent:
if (Header.RelatesTo != probe.MessageID) {
return -1;
}
// We pick what we need from the response:
probematch.types = aProbeMatches.ProbeMatch.Types;
probematch.scopes = aProbeMatches.ProbeMatch.Scopes;
// XAddrs is a space separated list of URLs to the Device service:
probematch.xaddrs = aProbeMatches.ProbeMatch.XAddrs;
probematch.metadataversion = aProbeMatches.ProbeMatch.MetadataVersion;
probematch.address = aProbeMatches.ProbeMatch.EndpointReference.Address;
return probematch;
}