前言
ONVIF协议分为多个模块，除了RemoteDiscovery模块之外，都有各自的服务地址，只有知道了对应模块的服务地址，才能使用这些模块的接口。如何获取对应模块的服务地址正是下文要说的内容。
鉴权
在介绍如何获取服务地址之前，先介绍一下鉴权。
- 为什么要介绍鉴权？
ONVIF协议规定，部分接口需要鉴权，部分接口不需要鉴权，在调用需要鉴权的接口时不使用鉴权，会导致接口调用失败。 - ONVIF哪些接口需要鉴权？
可以查看ONVIF-Core-Specification-v1706.pdf中的5.12.2.3 Access classes for service requests章节。 - 如何实现鉴权？
鉴权需要一定的加密算法，如果对加密算法不很了解，推荐使用gSOAP源码中的soap_wsse_add_UsernameTokenDigest()函数，使用该函数可以很轻松的实现鉴权。 - 代码实现
/**
* @description: 设置认证信息
*
* @brief setAuthInfo
* @param[in] soap soap
* @param[in] username 用户名
* @param[in] password 密码
* @return bool 返回true表示成功，其余查看soap错误码
*/
bool OnvifFunc::setAuthInfo(struct soap *soap, std::string username, std::string password)
{
assert(!username.empty());
assert(!password.empty());
int iRet = soap_wsse_add_UsernameTokenDigest(soap, NULL, username.c_str(), password.c_str());
if (SOAP_OK == iRet)
return true;
else
return false;
}
- 注意事项
ONVIF协议规定的需要鉴权的接口，每次调用前都要重新设置鉴权。因为IPC的应答信息会重置soap对象，导致鉴权信息丢失。
获取设备能力信息
/**
* @description: 获取设备能力信息（获取媒体服务地址）
*
* @brief getDeviceCapabilities
* @param[in] XAddrs 设备服务地址
* @param[in][out] deviceCap 设备能力信息
* @return bool 返回true表示成功，其余查看soap错误码
*/
bool OnvifFunc::getDeviceCapabilities(std::string XAddrs, DEVICECAPABILITIES * deviceCap)
{
// 初始化soap
struct soap soap;
soap_set_mode(&soap, SOAP_C_UTFSTRING);
DeviceBindingProxy device(&soap);
// 设置超时（超过指定时间没有数据就退出）
device.soap->recv_timeout = SOAP_SOCK_TIMEOUT;
device.soap->send_timeout = SOAP_SOCK_TIMEOUT;
device.soap->connect_timeout = SOAP_SOCK_TIMEOUT;
setAuthInfo(device.soap, m_username, m_password);
_tds__GetCapabilities tds__GetCapabilities;
_tds__GetCapabilitiesResponse tds__GetCapabilitiesResponse;
int iRet = device.GetCapabilities(XAddrs.c_str(), NULL, &tds__GetCapabilities, tds__GetCapabilitiesResponse);
if (SOAP_OK == iRet)
{
if (NULL != tds__GetCapabilitiesResponse.Capabilities)
{
if (NULL != tds__GetCapabilitiesResponse.Capabilities->Media)
{
if (!tds__GetCapabilitiesResponse.Capabilities->Media->XAddr.empty())
deviceCap->mediaXAddr = tds__GetCapabilitiesResponse.Capabilities->Media->XAddr;
}
if (NULL != tds__GetCapabilitiesResponse.Capabilities->Events)
{
if (!tds__GetCapabilitiesResponse.Capabilities->Events->XAddr.empty())
deviceCap->eventXAddr = tds__GetCapabilitiesResponse.Capabilities->Events->XAddr;
}
}
// 清除变量
device.destroy();
return true;
}
// 清除变量
device.destroy();
return false;
}
上述代码均为核心代码。
网友评论