linux设备上的Onvif 实现7：编写设备能力获取程序

1 背景说明

要和摄像头直接通信，第一步必须获取webserver地址，通过该地址才能进一步获得设备的能力、提供的媒体频信息等内容。webserver地址就是在probe应答包中， 具体是XAddrs：http://192.168.15.240/onvif/device_service，接下来的获取设备能力函数将使用此地址进行通信。

2 GetCapabilities命令说明

GetCapabilities函数在不同的版本中实际名称并不一样，我的版本中是：

SOAP_FMAC5 int SOAP_FMAC6 soap_call___ns2__GetCapabilities(struct soap *soap, const char *soap_endpoint, const char *soap_action, struct _ns2__GetCapabilities *ns2__GetCapabilities, struct _ns2__GetCapabilitiesResponse *ns2__GetCapabilitiesResponse)

该函数需要提供请求指针、应答指针。可以指定请求设备的全部能力还是某一部分能力：

enum ns3__CapabilityCategory { ns3__CapabilityCategory__All = 0, ns3__CapabilityCategory__Analytics = 1, ns3__CapabilityCategory__Device = 2, ns3__CapabilityCategory__Events = 3, ns3__CapabilityCategory__Imaging = 4, ns3__CapabilityCategory__Media = 5, ns3__CapabilityCategory__PTZ
= 6 };

以下实例中指定查询ns3__CapabilityCategory__Media能力。一般的可以选择查询ALL能力。

最后从报文中提取出媒体信息URI ：http://192.168.15.240/onvif/Media，将用于查询具体的视频源、编码器配置参数。

如果设备具备用户名、密码，那么查询设备能力可能需要鉴权过程，本文没有研究ONVIF的鉴权机制，默认摄像头无需输入用户名密码。如果出现鉴权应答，那么应答 getCapResponse.Capabilities就是NULL指针。soap_call___ns2__GetCapabilities函数返回值是501。

具体的应用实例如下：

/******************************************************************************

* Name: MyGetCapabilities

*

* Desc: 获取指定设备节点的能力

* Param:

struct soap *soap,

int index, 设备序号

* Return: BOOL, TRUE: success, FALSE: fail

* Global:

* Note:

* Author: Tom-hongtao.gao

* -------------------------------------

* Log: 2013/07/24, Create this function by Tom-hongtao.gao

******************************************************************************/

BOOL MyGetCapabilities(struct soap *soap, int index)

{

BOOL bret=FALSE;

int result = 0;

DEVICENODE * deviceode = DLFindbyIndex(index);

if(!deviceode)

{

printf("--Error: DLFindbyIndex(%d) return NULL! \n", index);

return FALSE;

}

if(deviceode->webserver==NULL || strlen(deviceode->webserver)==0)

{

printf("--Error: deviceode->webserver is NULL! \n");

return FALSE;

}

struct _ns2__GetCapabilities getCapReq={0};

struct _ns2__GetCapabilitiesResponse getCapResponse={0};

enum ns3__CapabilityCategory temp_category = ns3__CapabilityCategory__Media;

getCapReq.__sizeCategory=1;

getCapReq.Category=&temp_category;

result = soap_call___ns2__GetCapabilities(soap, deviceode->webserver, NULL, &getCapReq, &getCapResponse);

if(result==-1)

{

printf("soap error: %d, %s, %s\n", soap->error, *soap_faultcode(soap), *soap_faultstring(soap));

result = soap->error;

bret = FALSE;

}

else

{

if(getCapResponse.Capabilities==NULL)

{

printf(" GetCapabilities failed! result=%d \n",result);

bret = FALSE;

}

else

{

printf(" GetCapabilities OK! result=%d \n",result);

//printf(" Media->XAddr=%s \n", getCapResponse.Capabilities->Media->XAddr);

DLSetMediaUri(index, getCapResponse.Capabilities->Media->XAddr);

//PrintfNodebyIndex(index);

bret = TRUE;

}

}

soap_end(soap);

return bret;

}

实际的数据报文如下：

略