1 专栏导读
本专栏第一篇文章「专栏开篇」列出了专栏的完整目录,按目录顺序阅读,有助于你的理解,专栏前面文章讲过的知识点(或代码段),后面文章不会赘述。为了节省篇幅,突出重点,在文章中展示的示例代码仅仅是关键代码,你可以在「专栏开篇」中获取完整代码。
如有错误,欢迎你的留言纠正!让我们共同成长!你的「点赞」或「打赏」是对我最大的支持和鼓励!
2 原理简介
ONVIF协议接口由多个模块组成,每个模块分别对应着不同的WSDL文档,在ONVIF官网中能查看到这些模块,以及每个模块中的接口函数,这里列举几个模块:
- DeviceMgmt(设备管理)
- DeviceIO(设备IO服务)
- Event(事件处理)
- Analytics(视频分析)
- AnalyticsDevice(分析设备)
- Display(显示服务)
- Imaging(图像配置)
- Media(媒体配置)
- PTZ(PTZ控制)
- Receiver(接收端配置)
- RemoteDiscovery(设备发现)
- Recording(录像控制)
- Replay(重放控制)
- Search(记录搜索)
除了「RemoteDiscovery」模块之外,每个模块都有各自的「服务地址」,客户端要使用这些模块接口之前,必须先知道对应模块的「服务地址」。
3 编码流程
怎样才能获取这些模块的「服务地址」呢?分两步:
利用WS-Discovery搜索到IPC,就能得知该设备「DeviceMgmt」模块的「服务地址」,我们称之为「设备服务地址」。
使用「设备服务地址」调用「DeviceMgmt」模块的GetCapabilities接口,就能获取到所有模块的「服务地址」。
在我专栏前面的文章里,演示了,使用GetDeviceInformation获取设备基本信息,使用GetSystemDateAndTime和SetSystemDateAndTime对设备进行校时。这些都是「DeviceMgmt」模块的接口,使用「设备服务地址」就能搞定了,所以一直未涉及到GetCapabilities接口。
但后续的文章中,会涉及到音视频流,会用到「Media」模块的接口,这时就得先用GetCapabilities获取模块的「服务地址」了。
4 示例代码
调用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;
}
执行结果类似如下:
================= + dump_tds__GetCapabilitiesResponse + >>>
Capabilities: (0x8788f60)
|- Analytics: (0x8788f90)
|- XAddr: http://100.100.100.25:80/onvif/analytics_service
|- Device: (0x8788ff0)
|- XAddr: http://100.100.100.25:80/onvif/device_service
|- Events: (0x87892d8)
|- XAddr: http://100.100.100.25:80/onvif/event_service
|- Imaging: (0x8789160)
|- XAddr: http://100.100.100.25:80/onvif/image_service
|- Media: (0x8789378)
|- XAddr: http://100.100.100.25:80/onvif/media_service
|- PTZ: (0x8789470)
|- XAddr: http://100.100.100.25:80/onvif/ptz_service
|- Extension: (0x87894c8)
|- DeviceIO: (null)
|- Display: (null)
|- Recording: (null)
|- Search: (null)
|- Replay: (null)
|- Receiver: (null)
|- AnalyticsDevice: (null)
================= - dump_tds__GetCapabilitiesResponse - <<<
从结果看,我测试的这个摄像头,ONVIF各个模块的「服务地址」不太一样,而且不支持DeviceIO(即NULL表明不支持该功能),但是有的IPC,所有模块的「服务地址」也会设置成一样的,不同厂家的IPC情况不尽相同。