簡(jiǎn)介設(shè)備網(wǎng)絡(luò)SDK Win64 V6.1.6.45_build20210302 是?？低暪俜桨l(fā)布的二次開(kāi)發(fā)工具包適用于需要遠(yuǎn)程訪問(wèn)與控制海康各類(lèi)硬件產(chǎn)品的軟件工程師。其基于設(shè)備私有網(wǎng)絡(luò)通信協(xié)議可幫助開(kāi)發(fā)者高效完成設(shè)備接入、實(shí)時(shí)預(yù)覽、錄像回放、參數(shù)配置等功能。該SDK覆蓋設(shè)備發(fā)現(xiàn)、實(shí)時(shí)音視頻預(yù)覽、云臺(tái)控制、錄像檢索與回放、報(bào)警訂閱等典型接口適合構(gòu)建安防管理平臺(tái)或行業(yè)應(yīng)用集成。壓縮包約78.83MB內(nèi)含SDK動(dòng)態(tài)庫(kù)、開(kāi)發(fā)文檔和C、C#、Java三種語(yǔ)言的Demo示例方便不同技術(shù)棧的開(kāi)發(fā)者直接參考調(diào)用。目前已有1171人學(xué)習(xí)下載適合具備一定編程基礎(chǔ)、正在從事安防或物聯(lián)網(wǎng)項(xiàng)目的人員通過(guò)這份資源讀者可獲得完整的SDK依賴(lài)與示例工程結(jié)合開(kāi)發(fā)文檔快速理解接口流程縮短實(shí)際項(xiàng)目的開(kāi)發(fā)調(diào)試周期。 做安防設(shè)備上位機(jī)開(kāi)發(fā)的工程師看到“設(shè)備網(wǎng)絡(luò)SDK_Win64 V6.1.6.45_build20210302.rar”這個(gè)文件名基本就能猜到這是某個(gè)安防廠商提供的Windows 64位平臺(tái)開(kāi)發(fā)套件。我做視頻接入和物聯(lián)網(wǎng)集成這幾年手里過(guò)過(guò)的SDK不下七八種但真正稱(chēng)得上穩(wěn)定、能放到項(xiàng)目里長(zhǎng)期跑不翻車(chē)的還得是這種官方發(fā)布的完整包。今天不聊具體品牌就從這個(gè)壓縮包本身出發(fā)聊聊設(shè)備網(wǎng)絡(luò)SDK在Win64平臺(tái)上的完整使用思路從解壓、環(huán)境準(zhǔn)備到設(shè)備搜索、登錄、取流預(yù)覽再到我實(shí)際踩過(guò)的依賴(lài)沖突和排查方法。適合準(zhǔn)備做安防監(jiān)控客戶端、門(mén)禁對(duì)講集成或者想快速把網(wǎng)絡(luò)攝像機(jī)接入自研平臺(tái)的工程師參考。這個(gè)版本的SDK發(fā)布于2021年3月2日版本號(hào)V6.1.6.45從命名規(guī)則看屬于6.x系列的中期維護(hù)版本接口相對(duì)穩(wěn)定用來(lái)做項(xiàng)目基線很合適。它的核心價(jià)值在于開(kāi)發(fā)者不需要關(guān)心ONVIF、GB/T 28181等復(fù)雜協(xié)議的信令細(xì)節(jié)直接調(diào)用SDK封裝好的API就能完成設(shè)備發(fā)現(xiàn)、登錄、實(shí)時(shí)預(yù)覽、云臺(tái)控制、報(bào)警監(jiān)聽(tīng)等一整套操作。也就是說(shuō)你把最底層的數(shù)據(jù)交互交給SDK自己專(zhuān)注做業(yè)務(wù)邏輯和界面開(kāi)發(fā)效率會(huì)高很多。1. 設(shè)備網(wǎng)絡(luò)SDK_Win64 是什么先搞懂版本與場(chǎng)景1.1 從壓縮包命名看版本信息拿到這個(gè)壓縮包第一件事不要急著解壓先把文件名拆開(kāi)看一遍。設(shè)備網(wǎng)絡(luò)SDK_Win64指的是平臺(tái)架構(gòu)說(shuō)明這一版SDK只能用于64位Windows系統(tǒng)V6.1.6.45是版本號(hào)其中主版本6、功能版本1、維護(hù)版本6、修訂版本45build20210302是構(gòu)建日期代表2021年3月2日的構(gòu)建產(chǎn)物。在實(shí)際項(xiàng)目里這個(gè)命名信息非常關(guān)鍵。我曾經(jīng)見(jiàn)過(guò)團(tuán)隊(duì)把32位設(shè)備網(wǎng)絡(luò)SDK硬塞給64位系統(tǒng)上運(yùn)行的軟件結(jié)果加載DLL時(shí)直接報(bào)“模塊找不到”或者“應(yīng)用程序無(wú)法正常啟動(dòng)”。所以在開(kāi)始前請(qǐng)務(wù)必確認(rèn)你的目標(biāo)進(jìn)程是x64還是x86再選擇對(duì)應(yīng)位數(shù)的SDK版本。如果你的開(kāi)發(fā)機(jī)是64位Windows但項(xiàng)目中還有一些老舊的32位組件最好單獨(dú)維護(hù)一套32位構(gòu)建環(huán)境不要混用。另外構(gòu)建日期可以用來(lái)判斷你手里的包是不是官方最新的穩(wěn)定版。一般來(lái)說(shuō)安防廠商會(huì)定期發(fā)布更新修復(fù)漏洞、增加新設(shè)備型號(hào)的兼容性。如果項(xiàng)目剛立項(xiàng)建議去官網(wǎng)找一下有沒(méi)有更新的構(gòu)建版本如果項(xiàng)目已經(jīng)上線且運(yùn)行穩(wěn)定則不要輕易換SDK版本——很多廠商的新版本會(huì)在接口行為上做調(diào)整換包往往意味著回歸測(cè)試。1.2 核心功能盤(pán)點(diǎn)設(shè)備網(wǎng)絡(luò)SDK本質(zhì)上是一個(gè)用C語(yǔ)言接口暴露出來(lái)的動(dòng)態(tài)庫(kù)功能覆蓋了網(wǎng)絡(luò)攝像機(jī)、NVR、DVR、門(mén)禁設(shè)備等安防終端的絕大部分操作。常用的功能可以大致分為以下幾類(lèi)設(shè)備發(fā)現(xiàn)通過(guò)局域網(wǎng)廣播或指定網(wǎng)段掃描找到在線設(shè)備并獲取IP、MAC、序列號(hào)等信息。用戶登錄 / 注銷(xiāo)使用設(shè)備用戶名密碼建立會(huì)話后續(xù)所有操作都依賴(lài)這個(gè)會(huì)話句柄。實(shí)時(shí)預(yù)覽從指定通道拉取實(shí)時(shí)碼流可以直接在窗口渲染也可以回調(diào)拿到H.264/H.265裸流。遠(yuǎn)程回放 / 錄像下載按時(shí)間段查詢(xún)?cè)O(shè)備本地錄像支持回放和文件下載。云臺(tái)控制控制球機(jī)的上下左右、變倍變焦、預(yù)置位等。語(yǔ)音對(duì)講 / 語(yǔ)音廣播將本機(jī)音頻發(fā)送到設(shè)備或者從設(shè)備采集音頻。報(bào)警監(jiān)聽(tīng)訂閱設(shè)備報(bào)警事件比如移動(dòng)偵測(cè)、遮擋、斷網(wǎng)等。設(shè)備參數(shù)配置查詢(xún)和修改設(shè)備的網(wǎng)絡(luò)參數(shù)、編碼參數(shù)、時(shí)間同步等。這些功能里我最常用的是設(shè)備發(fā)現(xiàn)、登錄和實(shí)時(shí)預(yù)覽。很多項(xiàng)目需求就是“把多個(gè)攝像頭的畫(huà)面接進(jìn)來(lái)展示在統(tǒng)一平臺(tái)上”這三個(gè)功能能解決80%的問(wèn)題。至于云臺(tái)控制、報(bào)警訂閱則要看具體業(yè)務(wù)是否需要。1.3 適合哪些開(kāi)發(fā)者如果你是個(gè)人開(kāi)發(fā)者想快速做一個(gè)“局域網(wǎng)內(nèi)視頻監(jiān)控工具”那么這套SDK非常合適因?yàn)樗腄emo工程里幾乎覆蓋了所有基礎(chǔ)功能照著改就能跑起來(lái)。如果你是集成商或項(xiàng)目交付團(tuán)隊(duì)需要把安防設(shè)備接入到自己研發(fā)的管理平臺(tái)也適合用這套SDK作為底層接入層。但如果你只是想用一個(gè)現(xiàn)成的客戶端軟件來(lái)看監(jiān)控并不需要做二次開(kāi)發(fā)那用官方提供的配套工具就行沒(méi)必要折騰SDK。2. 部署環(huán)境與開(kāi)發(fā)環(huán)境準(zhǔn)備Win64 下的依賴(lài)坑2.1 解壓后的目錄結(jié)構(gòu)解壓這個(gè)rar包后你通常會(huì)看到以下三類(lèi)關(guān)鍵內(nèi)容include目錄C/C頭文件聲明了所有導(dǎo)出函數(shù)、數(shù)據(jù)結(jié)構(gòu)、錯(cuò)誤碼。lib目錄開(kāi)發(fā)期需要鏈接的導(dǎo)入庫(kù)比如.lib文件MSVC環(huán)境或.so文件如果是Linux版。bin目錄運(yùn)行期需要加載的動(dòng)態(tài)庫(kù)比如HCNetSDK.dll以及一系列配套組件。這里要特別提醒很多初學(xué)者把dll文件放在了源碼目錄或隨便某個(gè)位置然后程序運(yùn)行時(shí)提示找不到dll。正確做法是要么把bin目錄下的所有動(dòng)態(tài)庫(kù)拷貝到最終可執(zhí)行文件的同級(jí)目錄要么把bin目錄添加到系統(tǒng)PATH環(huán)境變量里。我自己的習(xí)慣是建立一個(gè)3rdparty/device_sdk文件夾把include、lib、bin按固定目錄放好同時(shí)把bin目錄在CMake和運(yùn)行時(shí)都顯式指向這個(gè)位置這樣換機(jī)器部署時(shí)只要整體拷貝項(xiàng)目目錄就能跑。2.2 Win64 環(huán)境下的關(guān)鍵依賴(lài)項(xiàng)設(shè)備網(wǎng)絡(luò)SDK本身對(duì)第三方庫(kù)的依賴(lài)相對(duì)簡(jiǎn)單但在實(shí)際工程里你很可能同時(shí)使用其他Win64組件這時(shí)候依賴(lài)沖突就來(lái)了。結(jié)合我常年在Windows 64位系統(tǒng)上做集成的經(jīng)驗(yàn)下面幾個(gè)基礎(chǔ)包最容易和SDK產(chǎn)生“糾纏”O(jiān)penSSL例如win64 openssl v1.1.1 light如果你的設(shè)備開(kāi)啟了TLS加密通道或者你的業(yè)務(wù)模塊需要通過(guò)HTTPS訪問(wèn)云端就會(huì)引入OpenSSL。設(shè)備網(wǎng)絡(luò)SDK有的版本內(nèi)部也帶了自己的加密庫(kù)如果同時(shí)存在兩個(gè)版本的libcrypto或libssl很容易在加載時(shí)出現(xiàn)“模塊初始化失敗”或運(yùn)行時(shí)隨機(jī)崩潰。Instant Client Basic包例如win64的instant client 19.23 basic包當(dāng)你的平臺(tái)需要把設(shè)備抓拍信息或操作日志寫(xiě)入Oracle數(shù)據(jù)庫(kù)時(shí)就需要Windows 64位的Instant Client。它和SDK沒(méi)有直接關(guān)系但如果DLL搜索路徑設(shè)置不當(dāng)可能互相干擾。OpenSSH for Win64如果你需要在Windows服務(wù)器上做自動(dòng)化部署或遠(yuǎn)程維護(hù)會(huì)用到OpenSSH。這個(gè)一般是獨(dú)立的服務(wù)不直接影響SDK但對(duì)版本敏感的運(yùn)維腳本有要求。我的建議是在項(xiàng)目根目錄建立一個(gè)統(tǒng)一的libs目錄把所有第三方運(yùn)行時(shí)按子目錄隔離比如libs/openssl、libs/instant_client、libs/device_sdk再在代碼中顯式指定加載路徑。不要把它們?nèi)珌G進(jìn)C:\Windows\System32那樣只會(huì)埋下未來(lái)升級(jí)時(shí)想哭的雷。2.3 配置開(kāi)發(fā)環(huán)境VS / Qt / C# 的選擇設(shè)備網(wǎng)絡(luò)SDK的頭文件和導(dǎo)入庫(kù)主要是為C/C設(shè)計(jì)的但通過(guò)動(dòng)態(tài)庫(kù)導(dǎo)出函數(shù)也可以被C#、Delphi、Python等調(diào)用。我推薦以下幾種組合Visual Studio 2019 C最穩(wěn)妥。SDK官方Demo大多用VS創(chuàng)建編譯選項(xiàng)和鏈接庫(kù)都已經(jīng)調(diào)整好你只需要把include和lib路徑指過(guò)去。Qt 5.15 MSVC適合界面比較豐富的桌面程序。注意Qt的編譯器套件必須是MSVC不能是MinGW否則導(dǎo)入庫(kù)格式不兼容。C# WPF/WinForms可以通過(guò)DllImport聲明導(dǎo)入函數(shù)但結(jié)構(gòu)體封裝的成本不低尤其是回調(diào)函數(shù)和內(nèi)存管理。我看過(guò)不少團(tuán)隊(duì)用C#封裝最后還是因?yàn)榻Y(jié)構(gòu)體內(nèi)存對(duì)齊問(wèn)題偶爾崩潰。我目前的主力方案是VS2019 C原因是SDK的調(diào)試日志和崩潰轉(zhuǎn)儲(chǔ)信息在C下最完整堆棧能直接定位到SDK內(nèi)部調(diào)用點(diǎn)。如果你熟悉現(xiàn)代化C建議把SDK的C接口再包一層C類(lèi)把設(shè)備句柄、登錄狀態(tài)、預(yù)覽通道封裝成對(duì)象后面業(yè)務(wù)代碼會(huì)干凈很多。3. 核心流程落地從初始化到設(shè)備登錄3.1 初始化SDK與設(shè)置回調(diào)無(wú)論做什么操作第一步都是調(diào)用NET_DVR_Init完成SDK全局初始化。這個(gè)函數(shù)會(huì)做一些底層網(wǎng)絡(luò)、內(nèi)存池、日志系統(tǒng)的事。初始化成功后建議設(shè)置一下連接參數(shù)和異?；卣{(diào)比如#include HCNetSDK.h NET_DVR_Init(); NET_DVR_SetConnectTime(2000, 1); // 連接超時(shí)2秒重試1次 NET_DVR_SetReconnect(10000, true); // 斷線后10秒自動(dòng)重連 // 設(shè)置異常消息回調(diào) NET_DVR_SetExceptionCallBack_V30(0, 0, MyExceptionCallBack, nullptr);這里的回調(diào)函數(shù)原型要嚴(yán)格按SDK頭文件定義寫(xiě)。異常回調(diào)通常用于接收設(shè)備掉線、網(wǎng)絡(luò)異常等事件。注意回調(diào)是在SDK內(nèi)部線程里觸發(fā)的千萬(wàn)不要在回調(diào)里做耗時(shí)操作比如寫(xiě)數(shù)據(jù)庫(kù)或彈窗正確做法是把事件塞到一個(gè)線程安全的隊(duì)列里由業(yè)務(wù)線程統(tǒng)一處理。在程序退出時(shí)一定要調(diào)用NET_DVR_Cleanup()釋放全局資源。我見(jiàn)過(guò)有的項(xiàng)目只初始化不清理導(dǎo)致進(jìn)程反復(fù)啟動(dòng)后資源耗盡最終不得不重啟系統(tǒng)。3.2 設(shè)備搜索與IP配置很多時(shí)候設(shè)備剛拿到手IP是默認(rèn)的和電腦也不在同一個(gè)網(wǎng)段。所以登錄前一般先做廣播搜索。SDK提供了設(shè)備搜索接口可以搜到局域網(wǎng)內(nèi)的在線設(shè)備并拿到IP和MAC信息NET_DVR_GetDVRWorkState(); NET_DVR_FindDVR();實(shí)際開(kāi)發(fā)中我更常用NET_DVR_GetDeviceInfo這類(lèi)接口配合網(wǎng)卡列表來(lái)做主動(dòng)掃描。不過(guò)有一點(diǎn)要注意搜索接口依賴(lài)系統(tǒng)網(wǎng)絡(luò)環(huán)境如果你的電腦有多張網(wǎng)卡或者啟用了虛擬網(wǎng)卡如VMware、WSL可能搜不到設(shè)備。這種情況下可以先手動(dòng)指定IP把電腦有線網(wǎng)卡和相機(jī)設(shè)到同一網(wǎng)段再調(diào)用登錄接口。另外剛拆封的設(shè)備通常處于未激活狀態(tài)需要先設(shè)置管理員密碼。很多登錄失敗案例根本不是密碼錯(cuò)而是設(shè)備沒(méi)激活。新版本SDK一般會(huì)提供激活接口但需要你先通過(guò)搜索拿到設(shè)備的序列號(hào)再調(diào)用NET_DVR_ActivateDevice。3.3 用戶登錄與會(huì)話管理登錄設(shè)備是后續(xù)一切操作的入口。標(biāo)準(zhǔn)調(diào)用方式是構(gòu)建設(shè)備信息結(jié)構(gòu)體然后取登錄句柄NET_DVR_USER_LOGIN_INFO loginInfo {0}; NET_DVR_DEVICEINFO_V40 deviceInfo {0}; strcpy(loginInfo.sDeviceAddress, 192.168.1.64); loginInfo.wPort 8000; strcpy(loginInfo.sUserName, admin); strcpy(loginInfo.sPassword, your_password); LONG userId NET_DVR_Login_V40(loginInfo, deviceInfo); if (userId 0) { printf(login failed, error code: %d\n, NET_DVR_GetLastError()); return -1; }登錄成功返回的userId是一個(gè)全局唯一的會(huì)話句柄后續(xù)所有預(yù)覽、回放、云臺(tái)控制等操作都要用到它。請(qǐng)務(wù)必維護(hù)好這個(gè)句柄的生命周期不要隨意覆蓋。我一般會(huì)把它放在一個(gè)設(shè)備對(duì)象的成員變量里并加互斥鎖保護(hù)避免多個(gè)線程同時(shí)登出或重新登錄導(dǎo)致句柄失效。默認(rèn)端口通常是8000。如果你的設(shè)備改過(guò)端口記得同步修改。還有一個(gè)細(xì)節(jié)登錄時(shí)設(shè)備信息結(jié)構(gòu)體里會(huì)返回設(shè)備的通道數(shù)量、設(shè)備類(lèi)型、能力集這些信息可以用來(lái)動(dòng)態(tài)生成預(yù)覽界面非常有用。3.4 拉流預(yù)覽與實(shí)況顯示實(shí)時(shí)預(yù)覽是最核心也最容易出問(wèn)題的一步。SDK支持兩種方式第一種是直接渲染到窗口句柄。最簡(jiǎn)單的調(diào)用NET_DVR_PREVIEWINFO previewInfo {0}; previewInfo.hPlayWnd hWnd; // 窗口句柄 previewInfo.lChannel 1; // 通道號(hào) previewInfo.dwStreamType 0; // 主碼流 previewInfo.dwLinkMode 0; // TCP方式 LONG playHandle NET_DVR_RealPlay_V40(userId, previewInfo, nullptr, nullptr, nullptr); if (playHandle 0) { printf(real play failed, error code: %d\n, NET_DVR_GetLastError()); }這種方式最簡(jiǎn)單SDK內(nèi)部自動(dòng)完成取流、解碼、渲染。只要傳入的窗口句柄是有效的基本都能立刻出畫(huà)面。需要注意如果窗口句柄是Qt的winId()或者Win32的HWND必須保證它在UI線程中沒(méi)有被銷(xiāo)毀。第二種方式是不給窗口句柄通過(guò)回調(diào)函數(shù)拿到原始碼流數(shù)據(jù)。這種方式適合做視頻分析、轉(zhuǎn)碼或自研播放器NET_DVR_RealPlay_V40(userId, previewInfo, RealDataCallback, nullptr, nullptr); void CALLBACK RealDataCallback(LONG lRealHandle, DWORD dwDataType, BYTE *pBuffer, DWORD dwBufSize, void *pUser) { // dwDataType 區(qū)分頭數(shù)據(jù)和碼流數(shù)據(jù) // 這里拿到 H.264/H.265 裸流后可以交給自己的解碼器 }這種方式踩坑更多。首先你必須正確處理dwDataType頭數(shù)據(jù)和碼流數(shù)據(jù)要區(qū)分開(kāi)其次回調(diào)線程不能被阻塞否則SDK內(nèi)部緩沖區(qū)溢出會(huì)丟幀最后如果你想做截圖直接從這個(gè)回調(diào)里保存的裸流不一定是I幀最好用SDK自帶的抓圖接口或者自己在回調(diào)里做I幀判斷。4. 常見(jiàn)問(wèn)題與排查技巧實(shí)錄4.1 登錄失敗網(wǎng)絡(luò)不通 vs 賬號(hào)密碼錯(cuò)誤登錄失敗是最常見(jiàn)的開(kāi)頭問(wèn)題。很多人報(bào)“連接不上”但實(shí)際原因千差萬(wàn)別。我通常按照以下順序排查用ping 設(shè)備IP確認(rèn)網(wǎng)絡(luò)層通不通。用telnet 設(shè)備IP 8000確認(rèn)目標(biāo)端口是否開(kāi)放。如果端口不通檢查設(shè)備是不是改了默認(rèn)端口或者網(wǎng)段隔離了。登錄接口返回NET_DVR_NETWORK_FAIL_CONNECT錯(cuò)誤碼7一般就是網(wǎng)絡(luò)不通或端口不對(duì)返回NET_DVR_NETWORK_ERRORDATA錯(cuò)誤碼30通常是賬號(hào)密碼錯(cuò)誤或設(shè)備未激活。有的設(shè)備默認(rèn)開(kāi)啟“非法登錄鎖定”連續(xù)輸錯(cuò)密碼會(huì)鎖定IP一段時(shí)間這時(shí)候即使密碼對(duì)了也登錄不上。等幾分鐘再試。還有一個(gè)我吃過(guò)虧的細(xì)節(jié)如果電腦開(kāi)了防火墻Windows Defender可能攔截SDK的UDP廣播和TCP連接。可以在開(kāi)發(fā)機(jī)上臨時(shí)關(guān)閉防火墻或放行SDK程序驗(yàn)證能不能通但正式部署時(shí)一定要按軟件發(fā)布規(guī)范配置防火墻例外規(guī)則。4.2 播放黑屏解碼器與GPU加速預(yù)覽黑屏問(wèn)題排在第二位。畫(huà)面無(wú)顯示但登錄成功、通道號(hào)正確這時(shí)候大概率是解碼和渲染環(huán)節(jié)出了問(wèn)題。先看調(diào)用NET_DVR_RealPlay_V40返回的句柄是不是有效。如果句柄有效但黑屏優(yōu)先檢查播放窗口句柄是否正確比如Qt程序里要拿this-winId()而不是控件對(duì)象本身。再看SDK目錄下是否包含解碼相關(guān)的動(dòng)態(tài)庫(kù)例如H.265解碼庫(kù)如果被誤刪或隔離畫(huà)面就出不來(lái)。我遇到過(guò)一種情況顯卡驅(qū)動(dòng)版本太老SDK調(diào)用硬件解碼時(shí)失敗畫(huà)面黑屏但音頻正常。解決辦法是在SDK預(yù)覽配置里把dwStreamType設(shè)為輔助碼流或者嘗試關(guān)閉硬解碼強(qiáng)制走軟解。不同版本SDK關(guān)閉硬解碼的方式不同可以在初始化參數(shù)里找找相關(guān)開(kāi)關(guān)。快速判斷是解碼問(wèn)題還是網(wǎng)絡(luò)問(wèn)題的方法是用官方客戶端軟件連接同一臺(tái)設(shè)備如果官方客戶端能正常出圖說(shuō)明設(shè)備和網(wǎng)絡(luò)沒(méi)問(wèn)題問(wèn)題出在你的播放環(huán)境上。4.3 內(nèi)存泄漏與線程安全設(shè)備網(wǎng)絡(luò)SDK長(zhǎng)時(shí)間運(yùn)行比如7x24小時(shí)無(wú)人值守時(shí)最容易出現(xiàn)內(nèi)存增長(zhǎng)和句柄泄漏。我自己的經(jīng)驗(yàn)是每次預(yù)覽結(jié)束必須調(diào)用NET_DVR_StopRealPlay釋放預(yù)覽句柄。退出登錄前先關(guān)閉所有通道再調(diào)用NET_DVR_Logout。程序退出時(shí)記得NET_DVR_Cleanup否則全局緩沖區(qū)一直占著。SDK的很多回調(diào)函數(shù)運(yùn)行在私有線程為保證線程安全建議在業(yè)務(wù)側(cè)建立統(tǒng)一消息隊(duì)列不要在回調(diào)函數(shù)里直接操作UI控件。除了內(nèi)存還有一個(gè)容易忽略的坑同一個(gè)userId被多個(gè)線程同時(shí)使用時(shí)SDK內(nèi)置的信號(hào)量可能會(huì)競(jìng)爭(zhēng)激烈極端情況下導(dǎo)致接口阻塞或超時(shí)。我一般會(huì)做一個(gè)設(shè)備服務(wù)類(lèi)把登錄、預(yù)覽、控制操作串行化到一個(gè)工作線程避免并發(fā)調(diào)用同一個(gè)會(huì)話句柄。4.4 基于Win64依賴(lài)包沖突的實(shí)戰(zhàn)排查最后分享一個(gè)比較典型的排查案例希望大家別踩同樣的坑。之前負(fù)責(zé)一個(gè)項(xiàng)目需要從攝像頭抓圖并把圖片路徑寫(xiě)入Oracle數(shù)據(jù)庫(kù)。開(kāi)發(fā)機(jī)上裝了Win64的Instant Client 19.23 basic包同時(shí)因?yàn)橐獙?duì)接外部系統(tǒng)還安裝了OpenSSL v1.1.1 light。結(jié)果SDK初始化偶爾成功偶爾直接崩潰到客戶現(xiàn)場(chǎng)部署時(shí)甚至出現(xiàn)過(guò)登錄后馬上掉線的情況。后來(lái)我用Process Explorer查看進(jìn)程加載的DLL列表發(fā)現(xiàn)設(shè)備網(wǎng)絡(luò)SDK優(yōu)先加載了系統(tǒng)PATH里的libcrypto-1_1-x64.dll和libssl-1_1-x64.dll而它內(nèi)部邏輯校驗(yàn)的卻是SDK自帶的這幾個(gè)庫(kù)的符號(hào)版本。兩邊一旦不一致就出現(xiàn)隨機(jī)失敗。最終的解決辦法很簡(jiǎn)單把設(shè)備網(wǎng)絡(luò)SDK的所有動(dòng)態(tài)庫(kù)復(fù)制到應(yīng)用目錄最前面同時(shí)把OpenSSL的DLL放到libs/openssl子目錄并在加載SDK之前不把OpenSSL目錄加入PATH或者修改應(yīng)用啟動(dòng)邏輯優(yōu)先從應(yīng)用目錄加載SDK的依賴(lài)。同理Oracle Instant Client也做了目錄隔離確保它和SDK互不干擾。這個(gè)案例給我的教訓(xùn)是在Win64環(huán)境下做多組件集成不要指望系統(tǒng)PATH幫你管理依賴(lài)版本。每個(gè)SDK的DLL都要跟隨應(yīng)用發(fā)布并且放到自己可控的加載目錄中。哪怕一個(gè)很小的版本差異都可能在交付現(xiàn)場(chǎng)變成半夜兩點(diǎn)爬起來(lái)處理的事故。最后再分享一點(diǎn)個(gè)人體會(huì)設(shè)備網(wǎng)絡(luò)SDK這種類(lèi)型的開(kāi)發(fā)包雖然接口不少但真正需要每天都在用的其實(shí)就那么十幾個(gè)。新項(xiàng)目啟動(dòng)時(shí)我會(huì)先花半天時(shí)間把SDK自帶的Demo完整跑通再對(duì)照文檔里“事件回調(diào)”和“錯(cuò)誤碼”兩張表做一遍筆記最后才動(dòng)手寫(xiě)業(yè)務(wù)代碼。這樣看著慢實(shí)際后續(xù)開(kāi)發(fā)速度反而快很多。如果你現(xiàn)在剛拿到這個(gè)壓縮包不妨也照著這個(gè)思路先把環(huán)境和Demo打通再往里填自己的業(yè)務(wù)邏輯。本文還有配套的精品資源點(diǎn)擊獲取