Onvif协议学习：9、设备能力

Onvif协议学习：9、设备能力

---

原文链接：https://blog.csdn.net/benkaoya/article/details/72486544

1、原理简介

ONVIF协议接口由多个模块组成，每个模块分别对应着不同的WSDL文档，在ONVIF官网中能查看到这些模块，以及每个模块中的接口函数，这里列举几个模块：

• DeviceMgmt（设备管理）

• DeviceIO（设备IO服务）

• Event（事件处理）

• Analytics（视频分析）

• AnalyticsDevice（分析设备）

• Display（显示服务）

• Imaging（图像配置）

• Media（媒体配置）

• PTZ（PTZ控制）

• Receiver（接收端配置）

• RemoteDiscovery（设备发现）

• Recording（录像控制）

• Replay（重放控制）

• Search（记录搜索）

除了「RemoteDiscovery」模块之外，每个模块都有各自的「服务地址」，客户端要使用这些模块接口之前，必须先知道对应模块的「服务地址」。

2、编码流程

怎样才能获取这些模块的「服务地址」呢？分两步：

• 利用WS-Discovery搜索到IPC，就能得知该设备「DeviceMgmt」模块的「服务地址」，我们称之为「设备服务地址」。

• 使用「设备服务地址」调用「DeviceMgmt」模块的GetCapabilities接口，就能获取到所有模块的「服务地址」。

在我专栏前面的文章里，演示了，使用GetDeviceInformation获取设备基本信息，使用GetSystemDateAndTime和SetSystemDateAndTime对设备进行校时。这些都是「DeviceMgmt」模块的接口，使用「设备服务地址」就能搞定了，所以一直未涉及到GetCapabilities接口。

但后续的文章中，会涉及到音视频流，会用到「Media」模块的接口，这时就得先用GetCapabilities获取模块的「服务地址」了。

3、示例代码

调用GetCapabilities接口的示例代码如下：

/************************************************************************
**函数：ONVIF_GetCapabilities
**功能：获取设备能力信息
**参数：
        [in] DeviceXAddr - 设备服务地址
**返回：
        0表明成功，非0表明失败
**备注：
    1). 其中最主要的参数之一是媒体服务地址
************************************************************************/
int ONVIF_GetCapabilities(const char *DeviceXAddr)
{
    int result = 0;
    struct soap *soap = NULL;
    struct _tds__GetCapabilities            req;
    struct _tds__GetCapabilitiesResponse    rep;

    SOAP_ASSERT(NULL != DeviceXAddr);
    SOAP_ASSERT(NULL != (soap = ONVIF_soap_new(SOAP_SOCK_TIMEOUT)));

    ONVIF_SetAuthInfo(soap, USERNAME, PASSWORD);

    memset(&req, 0x00, sizeof(req));
    memset(&rep, 0x00, sizeof(rep));
    result = soap_call___tds__GetCapabilities(soap, DeviceXAddr, NULL, &req, &rep);
    SOAP_CHECK_ERROR(result, soap, "GetCapabilities");

    dump_tds__GetCapabilitiesResponse(&rep);

EXIT:

    if (NULL != soap) {
        ONVIF_soap_delete(soap);
    }
    return result;
}

从结果看，我测试的这个摄像头，ONVIF各个模块的「服务地址」不太一样，而且不支持DeviceIO（即NULL表明不支持该功能），但是有的IPC，所有模块的「服务地址」也会设置成一样的，不同厂家的IPC情况不尽相同。