前言

ONVIF協(xié)議分為多個模塊，除了RemoteDiscovery模塊之外，都有各自的服務(wù)地址，只有知道了對應(yīng)模塊的服務(wù)地址，才能使用這些模塊的接口。如何獲取對應(yīng)模塊的服務(wù)地址正是下文要說的內(nèi)容。

鑒權(quán)

在介紹如何獲取服務(wù)地址之前，先介紹一下鑒權(quán)。

• 為什么要介紹鑒權(quán)？
  ONVIF協(xié)議規(guī)定，部分接口需要鑒權(quán)，部分接口不需要鑒權(quán)，在調(diào)用需要鑒權(quán)的接口時不使用鑒權(quán)，會導(dǎo)致接口調(diào)用失敗。
• ONVIF哪些接口需要鑒權(quán)？
  可以查看ONVIF-Core-Specification-v1706.pdf中的5.12.2.3 Access classes for service requests章節(jié)。
• 如何實現(xiàn)鑒權(quán)？
  鑒權(quán)需要一定的加密算法，如果對加密算法不很了解，推薦使用gSOAP源碼中的soap_wsse_add_UsernameTokenDigest()函數(shù)，使用該函數(shù)可以很輕松的實現(xiàn)鑒權(quán)。
• 代碼實現(xiàn)

/**
* @description: 設(shè)置認(rèn)證信息
*
* @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協(xié)議規(guī)定的需要鑒權(quán)的接口，每次調(diào)用前都要重新設(shè)置鑒權(quán)。因為IPC的應(yīng)答信息會重置soap對象，導(dǎo)致鑒權(quán)信息丟失。

獲取設(shè)備能力信息

/**
* @description: 獲取設(shè)備能力信息（獲取媒體服務(wù)地址）
*
* @brief getDeviceCapabilities
* @param[in] XAddrs                 設(shè)備服務(wù)地址
* @param[in][out] deviceCap         設(shè)備能力信息
* @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);
    // 設(shè)置超時（超過指定時間沒有數(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;
}

上述代碼均為核心代碼。

參考

• ONVIF官網(wǎng)
• ONVIF協(xié)議網(wǎng)絡(luò)攝像機（IPC）客戶端程序開發(fā)（9）：鑒權(quán)（認(rèn)證）
• ONVIF協(xié)議網(wǎng)絡(luò)攝像機（IPC）客戶端程序開發(fā)（11）：設(shè)備能力