簡介面向視頻監(jiān)控開發(fā)者的海康網(wǎng)絡(luò)高清攝像機字符疊加OSD例程演示在BCB6.0集成環(huán)境中調(diào)用?？礢DK實現(xiàn)OSD文字信息顯示。壓縮包共56個文件約11.61MB主要包含動態(tài)庫、靜態(tài)鏈接庫、頭文件、C源碼及工程配置另附可直接運行的測試程序方便對照觀察實際疊加效果。細致閱讀源碼可以理清從SDK初始化、設(shè)備連接、字體顏色位置設(shè)置到實時刷新、錯誤處理的完整調(diào)用流程工程預(yù)留了界面擴展思路便于動態(tài)調(diào)整疊加文字與坐標(biāo)貼近真實項目需求。目前已有7562人學(xué)習(xí)下載適合具備C基礎(chǔ)、從事安防或視頻監(jiān)控開發(fā)的工程師作為入門參考也能為需要定制OSD功能的項目提供可直接借鑒的代碼框架。1. 字符疊加OSD例程BCB6.0老項目的救火方案做安防上位機開發(fā)的人遲早會遇到“字符疊加OSD”這個需求把點位編號、時間戳、車牌號這些文字實時壓在攝像頭畫面里。某開發(fā)者接手過一套用BCB6.0寫的老安防客戶端用戶要求在十幾臺網(wǎng)絡(luò)高清攝像機的預(yù)覽畫面上疊加大門編號和當(dāng)前時間最初以為是視頻編碼層的活實際上設(shè)備SDK早就把OSD能力封裝好了。這份?？稻W(wǎng)絡(luò)高清攝像機字符疊加OSD例程核心就是把設(shè)備登錄、OSD配置下發(fā)、中文編碼轉(zhuǎn)換串起來代碼量不大但每一步都有講究。適合兩類人一類是要在BCB6.0老工程里補OSD功能的上位機開發(fā)者另一類是剛接觸設(shè)備SDK、想快速跑通字符疊加的集成商。看完可以照著把OSD跑起來再往上改業(yè)務(wù)。2. 工程結(jié)構(gòu)與SDK選型BCB6.0如何接住?？礢DK先說為什么這個例程選擇BCB6.0而不是C#或Java。很多安防客戶端是十多年前用C Builder寫起來的窗體、串口、報表模塊都在里面。接一個OSD功能最大的約束不是語言本身而是要讓新代碼能和老工程一起編譯、用同一套VCL窗體。2.1 設(shè)備SDK的組成頭文件、導(dǎo)入庫和動態(tài)庫的分工?？翟O(shè)備網(wǎng)絡(luò)SDK對外提供的是純C接口動態(tài)庫。在BCB6.0工程里SDK被拆成三個角色頭文件負責(zé)聲明函數(shù)和結(jié)構(gòu)體導(dǎo)入庫負責(zé)在鏈接期生成符號地址動態(tài)庫在運行時真正完成網(wǎng)絡(luò)通訊。寫代碼時include的是HCNetSDK.h編譯時鏈接HCNetSDK.lib運行時把HCNetSDK.dll等一系列動態(tài)庫放到exe同目錄。這里給一張文件分工表文件作用使用時機HCNetSDK.h聲明所有接口函數(shù)與結(jié)構(gòu)體編譯期includeHCNetSDK.lib導(dǎo)入庫鏈接期定位函數(shù)入口鏈接期HCNetSDK.dll設(shè)備網(wǎng)絡(luò)通訊主動態(tài)庫運行時PlayCtrl.dll預(yù)覽/回放解碼庫預(yù)覽時hlog.dll / hconfig.dll日志與配置輔助模塊運行時有一點容易誤解字符疊加OSD功能并不依賴PlayCtrl.dll它走的是設(shè)備配置通道不是視頻通道。所以例程里如果沒做預(yù)覽只需要HCNetSDK.dll加輔助模塊就能跑。做了預(yù)覽才需要PlayCtrl.dll。工程里常看到這兩個動態(tài)庫一起出現(xiàn)是因為老工程本身就要顯示畫面。2.2 例程的工程文件長什么樣BCB6.0的工程和現(xiàn)代IDE不太一樣。打開工程要看.bpr文件里面有編譯器參數(shù)、源文件列表、鏈接庫配置。例程目錄里通常還帶.dfm文件存放窗體布局.cpp和.h是邏輯代碼。第一次編譯前要把SDK路徑配進Project Options的include目錄和lib目錄否則編譯器會先報“找不到HCNetSDK.h”。新手最容易犯的錯是直接雙擊.cpp打開源碼然后按F9編譯BCB會提示“Project has no .bpr file”。正確做法是打開整個工程文件讓IDE按.bpr里的配置組織編譯。老工程里如果已經(jīng)有自定義的AppDir宏或公共頭文件目錄把SDK頭文件目錄追加進去即可不要新建工程否則VCL窗體框架要重搭一遍。2.3 搭建環(huán)境與首次編譯編譯和運行有兩條線要同時準(zhǔn)備好。第一條是編譯期確認(rèn)HCNetSDK.lib能被BCB6.0鏈接器接受。第二條是運行期把HCNetSDK.dll、hlog.dll、hconfig.dll復(fù)制到exe輸出目錄。我一般會把SDK目錄固定放在工程下的三層結(jié)構(gòu)里SDK/ include/HCNetSDK.h lib/HCNetSDK.lib dll/HCNetSDK.dll這樣.bpr里的include路徑寫相對路徑工程拷到別的機器不用改絕對路徑。首次編譯如果報“Unable to open file HCNetSDK.lib”先檢查lib目錄路徑如果報“Illegal characters in path”多半是路徑里帶了中文或空格把SDK目錄改到純英文路徑。運行階段最常見的錯誤是啟動時彈窗提示“找不到HCNetSDK.dll”這不是代碼問題而是dll復(fù)制路徑錯了。BCB6默認(rèn)輸出在Debug目錄或工程目錄確認(rèn)dll和exe在同一目錄即可。調(diào)試時建議先把NET_DVR_SetConnectTime調(diào)短比如500毫秒這樣設(shè)備不在線時登錄失敗能立刻返回不用等兩秒超時。這里還要提醒一個和調(diào)用約定有關(guān)的知識點?？礢DK導(dǎo)出的接口統(tǒng)一是__stdcall約定BCB6里封裝函數(shù)指針時要記得加這個修飾。漏掉的話函數(shù)參數(shù)壓棧順序不對輕則返回錯誤重則直接崩潰而且這種問題非常難查。老工程里如果全景有宏定義確保沒有把__stdcall重定義成別的。3. 核心代碼拆解從設(shè)備登錄到OSD字符下發(fā)完整鏈路OSD疊加的完整鏈路可以拆成四步初始化SDK、登錄設(shè)備、構(gòu)造疊加結(jié)構(gòu)體、下發(fā)配置。下面按例程的實際調(diào)用來走一遍。3.1 設(shè)備初始化與登錄拿到操作會話登錄成功后返回的lUserID是全局會話句柄后續(xù)所有操作都掛在它下面。代碼// 初始化SDK返回TRUE代表成功 NET_DVR_Init(); // 連接超時設(shè)為2秒失敗后每10秒嘗試重連 NET_DVR_SetConnectTime(2000, 1); NET_DVR_SetReconnect(10000, TRUE); NET_DVR_USER_LOGIN_INFO struLogin {0}; NET_DVR_DEVICEINFO_V40 struDevice {0}; struLogin.wPort 8000; strcpy(struLogin.sDeviceAddress, 192.168.1.64); strcpy(struLogin.sUserName, admin); strcpy(struLogin.sPassword, 12345678); LONG lUserID NET_DVR_Login_V40(struLogin, struDevice); if (lUserID -1) { ShowMessage(登錄失敗錯誤碼 AnsiString(NET_DVR_GetLastError())); return; } // lUserID 是后續(xù)所有配置操作含OSD下發(fā)的會話句柄參數(shù)說明8000是?？翟O(shè)備的默認(rèn)SDK端口和Web訪問端口不一定相同改過端口的設(shè)備要在設(shè)備端確認(rèn)實際值。sDeviceAddress只填I(lǐng)P不帶協(xié)議頭。NET_DVR_SetReconnect處理的是斷線后的TCP會話重建它能自動恢復(fù)網(wǎng)絡(luò)連接但不會自動重發(fā)OSD配置這一點到后面避坑章節(jié)會展開。登錄成功之后還要留個心眼如果老工程里同時登錄了多臺設(shè)備每個lUserID要分開保存不能共用一個全局變量。OSD下發(fā)是按會話走的覆蓋了別的設(shè)備的配置會讓人抓狂。3.2 OSD疊加核心NET_DVR_SHOWSTRING_V30與配置下發(fā)疊加內(nèi)容放在NET_DVR_SHOWSTRING_V30結(jié)構(gòu)體里。一次最多可以放8條字符串每條字符串最長16字節(jié)含結(jié)尾0。下發(fā)指令用的是NET_DVR_SetDVRConfigNET_DVR_SHOWSTRING_V30 struShow {0}; NET_DVR_SHOWSTRING_INFO struInfo {0}; // 第0行疊加Gate-01 strcpy((char*)struInfo.sShowString, Gate-01); struInfo.wShowStringSize 7; struInfo.wShowStringTopLeftX 0; struInfo.wShowStringTopLeftY 0; struShow.dwSize sizeof(NET_DVR_SHOWSTRING_V30); struShow.wShowStringNum 1; struShow.wShowStringCharMode 0; struShow.struShowStringInfo[0] struInfo; BOOL bRet NET_DVR_SetDVRConfig( lUserID, NET_DVR_SET_SHOWSTRING, 0, struShow, sizeof(NET_DVR_SHOWSTRING_V30));幾個容易忽略的點dwSize必須正確填充很多配置下發(fā)失敗都是這里漏了第三個參數(shù)是通道號網(wǎng)絡(luò)攝像機填0wShowStringSize單位是字節(jié)不是字符數(shù)中文字符串要按字節(jié)算。坐標(biāo)系以畫面的左上角為原點X向右Y向下具體取值范圍和主碼流分辨率有關(guān)建議先用(0,0)跑通再微調(diào)位置。下發(fā)是否成功不能只看返回值嚴(yán)格的做法是用NET_DVR_GET_SHOWSTRING把設(shè)備端配置回讀出來逐字段比一次。有些固件版本對超長字符串會靜默截斷回讀時能看到sShowString被切掉一半。這個回讀動作在例程里通常注釋掉了實際項目里建議打開。3.3 中文編碼與坐標(biāo)計算避免亂碼和錯位設(shè)備端OSD字符默認(rèn)按GBK處理這一點在BCB6.0下反而有優(yōu)勢AnsiString的c_str()就是GBK字符集直接賦值給sShowString數(shù)組沒有問題。如果工程是Unicode模式比如后來換到BCB2009以上就不能直接拷要先把UnicodeString轉(zhuǎn)成GBK// UnicodeString - GBK再寫入結(jié)構(gòu)體 UnicodeString wsText L出口道閘; char szBuf[32]; WideCharToMultiByte( CP_ACP, 0, wsText.c_str(), -1, szBuf, sizeof(szBuf), NULL, NULL ); strncpy((char*)struInfo.sShowString, szBuf, 16); struInfo.wShowStringSize (WORD)strlen(szBuf);WideCharToMultiByte的CP_ACP表示當(dāng)前系統(tǒng)ANSI代碼頁中文系統(tǒng)下就是GBK。如果不做這步轉(zhuǎn)換直接把Unicode的緩沖區(qū)指針強轉(zhuǎn)后寫入設(shè)備端顯示的就是亂碼或空字符。代碼里szBuf長度32sShowString上限16所以拷入前要確認(rèn)字符串不超過15個字節(jié)否則會截斷。坐標(biāo)計算按主碼流分辨率來。?？稻W(wǎng)絡(luò)高清攝像機主碼流常見1920x1080X、Y字段最大不要超過畫面寬高超過后部分固件會自動裁剪部分會下發(fā)失敗。多行疊加時我一般讓每行Y遞增30到40像素實際行高受設(shè)備字體大小影響先設(shè)一個固定值再在預(yù)覽里觀察struInfo.wShowStringTopLeftX 10; struInfo.wShowStringTopLeftY 10 nLine * 30; // nLine從0開始wShowStringCharMode這個字段例程里通常填0對應(yīng)設(shè)備的默認(rèn)字符集兼容性最好。部分設(shè)備支持1或2代表UTF-8或Unicode具體以設(shè)備能力集為準(zhǔn)。真遇到了就一個個試試到不亂碼為止。4. 避坑指南OSD疊加最常見的5個翻車現(xiàn)場寫這一章是因為OSD功能本身不復(fù)雜但跑不通時定位問題非常費時間而且不少坑和BCB6.0的編譯器特性攪在一起。4.1 登錄與配置下發(fā)三個最容易翻車的點第一條exe啟動就報找不到HCNetSDK.dll?，F(xiàn)象是程序一跑起來直接彈錯誤框還沒走到界面。原因幾乎都是dll沒復(fù)制全或者復(fù)制了32位dll到64位進程。解決確認(rèn)exe和dll同目錄確認(rèn)SDK位數(shù)和exe編譯位數(shù)一致。BCB6.0默認(rèn)生成32位程序就去SDK的32位目錄拿dll不要拿64位的。第二條登錄返回-1NET_DVR_GetLastError()返回的常見錯誤碼集中在7網(wǎng)絡(luò)不通、23賬號或密碼錯誤這類。原因IP不對、SDK端口被改、賬號密碼錯誤。解決先在命令行ping設(shè)備IP再用設(shè)備廠商工具確認(rèn)端口和賬號最后把錯誤碼對照SDK包里的錯誤碼表定位。這種情況大概率是環(huán)境問題不是代碼問題別一上來改代碼。第三條NET_DVR_SetDVRConfig返回TRUE畫面里卻沒有字符。這是OSD疊加最曖昧的失敗接口認(rèn)為成功了設(shè)備端沒生效。原因通常是設(shè)備編碼通道的字符疊加總開關(guān)沒打開。解決登錄設(shè)備Web管理頁在“視頻參數(shù)-字符疊加”或類似位置開啟字符疊加開關(guān)再回到程序下發(fā)一次。部分老固件還需要設(shè)備重啟后才能生效。4.2 編碼與鏈接兩個隱蔽問題第四條中文變成亂碼?，F(xiàn)象英文正常中文顯示為“???”或方塊。原因調(diào)用方把UTF-8或Unicode數(shù)據(jù)直接寫入sShowString。解決統(tǒng)一轉(zhuǎn)成GBK再填結(jié)構(gòu)體。如果還是亂碼檢查代碼里是否有中間層把AnsiString轉(zhuǎn)成了char后丟失代碼頁信息。BCB6里AnsiString::c_str()返回的是char本身就是按當(dāng)前代碼頁解釋的字符串通常不需要額外轉(zhuǎn)碼怕的就是有人先轉(zhuǎn)成了wchar_t*再拷回來。第五條BCB6.0鏈接HCNetSDK.lib報格式錯誤?，F(xiàn)象編譯到鏈接階段報類似“Bad object file format”的提示。原因SDK自帶導(dǎo)入庫是VC的COFF格式BCB6.0的ilink32默認(rèn)期望OMF格式兩者不兼容。解決有兩個一是用轉(zhuǎn)換工具把lib轉(zhuǎn)成OMF格式后再鏈接二是繞開lib運行時用LoadLibrary和GetProcAddress動態(tài)加載函數(shù)。第二種在BCB6.0下更省事typedef BOOL (__stdcall *pfnNetDVR_Init)(void); typedef LONG (__stdcall *pfnNetDVR_Login_V40)( NET_DVR_USER_LOGIN_INFO*, NET_DVR_DEVICEINFO_V40*); HMODULE hSdk LoadLibraryA(HCNetSDK.dll); pfnNetDVR_Init pNetDVR_Init (pfnNetDVR_Init)GetProcAddress(hSdk, NET_DVR_Init); pfnNetDVR_Login_V40 pLogin (pfnNetDVR_Login_V40)GetProcAddress(hSdk, NET_DVR_Login_V40);注意這段代碼里NET_DVR_USER_LOGIN_INFO仍然來自頭文件所以頭文件要能正常編譯通過。如果連頭文件都在BCB6.0上報錯把#include HCNetSDK.h用extern C包一層并統(tǒng)一加__stdcall調(diào)用約定。這樣能繞開絕大多數(shù)兼容性問題代價是每個接口都要手寫一個函數(shù)指針類型略繁瑣但可控。5. 二次開發(fā)實戰(zhàn)把靜態(tài)OSD升級成業(yè)務(wù)信息看板例程跑通后最直接的改造是把字符疊加封裝成類把結(jié)構(gòu)體細節(jié)藏起來。我一般會在例程代碼外再包一層TOSDOverlay暴露SetText和Apply兩個方法class TOSDOverlay { public: TOSDOverlay(LONG lUserID) : m_lUserID(lUserID) { memset(m_struShow, 0, sizeof(m_struShow)); m_struShow.dwSize sizeof(NET_DVR_SHOWSTRING_V30); m_struShow.wShowStringNum 8; m_struShow.wShowStringCharMode 0; } bool SetText(int nLine, const AnsiString asText, int nX, int nY) { if (nLine 0 || nLine 7) return false; strncpy((char*)m_struShow.struShowStringInfo[nLine].sShowString, asText.c_str(), 16); m_struShow.struShowStringInfo[nLine].wShowStringSize asText.Length(); m_struShow.struShowStringInfo[nLine].wShowStringTopLeftX nX; m_struShow.struShowStringInfo[nLine].wShowStringTopLeftY nY; return true; } bool Apply() { return NET_DVR_SetDVRConfig(m_lUserID, NET_DVR_SET_SHOWSTRING, 0, m_struShow, sizeof(m_struShow)); } private: LONG m_lUserID; NET_DVR_SHOWSTRING_V30 m_struShow; };封裝之后業(yè)務(wù)代碼只需要管“第幾行顯示什么內(nèi)容”。比如做一個1秒刷新一次的時鐘疊加用BCB6.0的Timer組件在OnTimer里更新字符串并調(diào)用Applyvoid __fastcall TFormMain::Timer1Timer(TObject *Sender) { AnsiString asTime Now().FormatString(yyyy-mm-dd hh:nn:ss); m_osd.SetText(0, asTime, 10, 10); m_osd.Apply(); }下發(fā)的頻率不能太快1秒一次已經(jīng)算高頻了。OSD配置每次都要走一遍網(wǎng)絡(luò)請求到設(shè)備端生產(chǎn)環(huán)境建議改成內(nèi)容變化時才下發(fā)或者用單獨的線程限流否則設(shè)備CPU占用會明顯升高。再往前走一步可以把OSD和業(yè)務(wù)聯(lián)動刷卡開門時把卡號、姓名疊到對應(yīng)畫面上再抓圖報警觸發(fā)時疊加報警類型和時間再保存圖片。這樣事后翻錄像時畫面里的文字本身就是證據(jù)不用再對著時間軸對表。抓圖用NET_DVR_CaptureJPEGPicture疊加邏輯復(fù)用上面的類就行抓圖的路徑和時間戳也可以一并拼進OSD字符串。最后說一個習(xí)慣。從前做完OSD集成我只會對著實時畫面肉眼看字有沒有出來。后來有一次畫面正常但回放錄像里沒有字符才發(fā)現(xiàn)是沒做回讀校驗。從那以后每次改完配置我都會強制用NET_DVR_GET_SHOWSTRING回讀一次設(shè)備端配置確認(rèn)下發(fā)內(nèi)容和設(shè)備存儲一致。這個習(xí)慣幫我少踩了很多陰晴不定的坑希望幫到你。本文還有配套的精品資源點擊獲取