前言
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;
}
上述代碼均為核心代碼。
