前言
ONVIF協(xié)議分為多個(gè)模塊儒溉,除了RemoteDiscovery模塊之外,都有各自的服務(wù)地址赊舶,只有知道了對(duì)應(yīng)模塊的服務(wù)地址睁搭,才能使用這些模塊的接口赶诊。如何獲取對(duì)應(yīng)模塊的服務(wù)地址正是下文要說(shuō)的內(nèi)容。
鑒權(quán)
在介紹如何獲取服務(wù)地址之前园骆,先介紹一下鑒權(quán)舔痪。
- 為什么要介紹鑒權(quán)?
ONVIF協(xié)議規(guī)定锌唾,部分接口需要鑒權(quán)锄码,部分接口不需要鑒權(quán),在調(diào)用需要鑒權(quán)的接口時(shí)不使用鑒權(quán)晌涕,會(huì)導(dǎo)致接口調(diào)用失敗滋捶。 - ONVIF哪些接口需要鑒權(quán)?
可以查看ONVIF-Core-Specification-v1706.pdf中的5.12.2.3 Access classes for service requests章節(jié)余黎。 - 如何實(shí)現(xiàn)鑒權(quán)重窟?
鑒權(quán)需要一定的加密算法,如果對(duì)加密算法不很了解惧财,推薦使用gSOAP源碼中的soap_wsse_add_UsernameTokenDigest()
函數(shù)巡扇,使用該函數(shù)可以很輕松的實(shí)現(xiàn)鑒權(quán)。 - 代碼實(shí)現(xiàn)
/**
* @description: 設(shè)置認(rèn)證信息
*
* @brief setAuthInfo
* @param[in] soap soap
* @param[in] username 用戶名
* @param[in] password 密碼
* @return bool 返回true表示成功垮衷,其余查看soap錯(cuò)誤碼
*/
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;
}
- 注意事項(xiàng)
ONVIF協(xié)議規(guī)定的需要鑒權(quán)的接口厅翔,每次調(diào)用前都要重新設(shè)置鑒權(quán)。因?yàn)镮PC的應(yīng)答信息會(huì)重置soap對(duì)象搀突,導(dǎo)致鑒權(quán)信息丟失刀闷。
獲取設(shè)備能力信息
/**
* @description: 獲取設(shè)備能力信息(獲取媒體服務(wù)地址)
*
* @brief getDeviceCapabilities
* @param[in] XAddrs 設(shè)備服務(wù)地址
* @param[in][out] deviceCap 設(shè)備能力信息
* @return bool 返回true表示成功,其余查看soap錯(cuò)誤碼
*/
bool OnvifFunc::getDeviceCapabilities(std::string XAddrs, DEVICECAPABILITIES * deviceCap)
{
// 初始化soap
struct soap soap;
soap_set_mode(&soap, SOAP_C_UTFSTRING);
DeviceBindingProxy device(&soap);
// 設(shè)置超時(shí)(超過(guò)指定時(shí)間沒(méi)有數(shù)據(jù)就退出)
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;
}
上述代碼均為核心代碼仰迁。