【正文】 數(shù)字硬盤錄像機程序開發(fā)文檔基于《設(shè)備網(wǎng)絡(luò)SDK使用手冊 》概述設(shè)備網(wǎng)絡(luò)SDK是基于設(shè)備私有網(wǎng)絡(luò)通信協(xié)議開發(fā)的，為后端設(shè)備（嵌入式網(wǎng)絡(luò)硬盤錄像機、視頻服務(wù)器）、前端設(shè)備（網(wǎng)絡(luò)攝像機、網(wǎng)絡(luò)球機、IP模塊）等產(chǎn)品服務(wù)的配套模塊，用于遠程訪問和控制設(shè)備軟件的二次開發(fā)。 設(shè)備網(wǎng)絡(luò)SDK主要功能 序號功能備注1.圖像預(yù)覽2.文件回放和下載3.云臺控制、布防/撤防4.語音對講5.日志管理6.解碼卡7.遠程升級8.遠程重啟/關(guān)閉9.格式化硬盤10.參數(shù)配置（系統(tǒng)配置、通道配置、串口配置、報警配置、用戶配置）11.多路解碼器12.智能設(shè)備功能和獲取設(shè)備能力集設(shè)備網(wǎng)絡(luò)SDK包含網(wǎng)絡(luò)通訊庫、軟解碼庫、硬解碼庫等功能組件，我們提供Windows和Linux兩個版本的SDK，各自所包含的組件如下： Windows下設(shè)備網(wǎng)絡(luò)SDK： 網(wǎng)絡(luò)通訊庫頭文件 LIB庫文件 DLL庫文件hpr庫 LIB庫文件 DLL庫文件RTSP通訊庫 DLL庫文件軟解碼庫頭文件 LIB庫文件 DLL庫文件轉(zhuǎn)封裝庫 DLL庫文件硬解碼庫頭文件 LIB庫文件 DLL庫文件Linux下設(shè)備網(wǎng)絡(luò)SDK庫： 網(wǎng)絡(luò)通訊庫頭文件SO庫文件hpr庫SO庫文件RTSP通訊庫SO庫文件軟解碼庫頭文件SO庫文件轉(zhuǎn)封裝庫SO庫文件本版本的設(shè)備網(wǎng)絡(luò)SDK開發(fā)包中包含以上各個組件，以下將對各個組件在SDK中的作用和使用條件分別說明。網(wǎng)絡(luò)通訊庫是設(shè)備網(wǎng)絡(luò)SDK的主體，主要用于網(wǎng)絡(luò)客戶端與各類產(chǎn)品之間的通訊交互，負責(zé)遠程功能調(diào)控、遠程參數(shù)配置及碼流數(shù)據(jù)的獲取和處理等。 hpr庫是網(wǎng)絡(luò)通訊庫的依賴庫。 RTSP通訊庫是支持RTSP傳輸協(xié)議的網(wǎng)絡(luò)庫。當需要對支持RTSP協(xié)議的產(chǎn)品進行取流等操作時就必須加載該項組件。 軟解碼庫主要用于對實時碼流數(shù)據(jù)進行解碼顯示（實現(xiàn)預(yù)覽功能）和對錄像文件進行回放解碼等。用戶如果需要在SDK內(nèi)部進行對實時流和錄像碼流播放顯示時（即NET_DVR_RealPlay_V30接口的第二個結(jié)構(gòu)體參數(shù)的播放句柄設(shè)置成有效句柄時）必須加載該組件，而如果用戶僅需要用網(wǎng)絡(luò)通訊庫捕獲到數(shù)據(jù)后再外部自行處理就不需要加載該組件，這種情況下用戶在外部自行解碼將更靈活，可參見軟解碼庫函數(shù)說明《播放器SDK編程指南》。 轉(zhuǎn)封裝庫的功能可以分為兩種：一種是將標準碼流轉(zhuǎn)換成采用我們公司封裝格式的碼流。當用戶需要對支持RTSP協(xié)議的產(chǎn)品捕獲采用本公司封裝格式的碼流數(shù)據(jù)時（即當設(shè)置NET_DVR_RealPlay_V30接口中的回調(diào)函數(shù)捕獲數(shù)據(jù)或者調(diào)用NET_DVR_SetRealDataCallBack接口捕獲數(shù)據(jù)時）必須加載該組件。另一種功能是能將標準碼流轉(zhuǎn)換成其他格式的封裝，如3GPP、PS等。例如，當用戶需要對支持RTSP協(xié)議的產(chǎn)品實時捕獲指定封裝格式的碼流數(shù)據(jù)（對應(yīng)的SDK接口為NET_DVR_SaveRealData）時必須加載該項組件。 硬解碼庫需在配備硬解碼卡（MD卡）的前提下使用，通過解碼卡的解碼與輸出功能實現(xiàn)實時流的解碼顯示及向監(jiān)視器上矩陣輸出的功能。用戶如果需要在SDK內(nèi)部對實時流碼流播放顯示時必須加載該項組件。為更方便靈活地調(diào)用硬解碼的相關(guān)功能，建議用戶通過捕獲數(shù)據(jù)在外部處理解碼。相關(guān)硬解碼庫的功能函數(shù)可參見《板卡SDK編程指南》中解碼卡API相關(guān)介紹。Linux下無硬解功能。通用接口介紹接口功能支持的產(chǎn)品備注NET_DVR_Init初始化SDK全部NET_DVR_Cleanup釋放SDK資源全部NET_DVR_SetConnectTime設(shè)置SDK網(wǎng)絡(luò)連接超時時間和連接嘗試次數(shù)全部NET_DVR_SetReconnect設(shè)置SDK重連功能全部NET_DVR_GetDVRIPByResolveSvr通過解析服務(wù)器，獲取設(shè)備的動態(tài)IP地址全部NET_DVR_SetDVRMessage注冊接收異常、重連等消息的窗口句柄全部NET_DVR_SetExceptionCallBack_V30注冊接收異常、重連等消息的窗口句柄或回調(diào)函數(shù)全部NET_DVR_GetSDKVersion獲取SDK的版本信息全部NET_DVR_GetSDKBuildVersion獲取SDK的版本號和build信息全部NET_DVR_GetSDKState獲取當前SDK的狀態(tài)信息全部NET_DVR_GetSDKAbility獲取當前SDK的功能信息全部NET_DVR_SetLogToFile啟用SDK寫日志文件全部NET_DVR_GetLastError返回最后操作的錯誤碼全部NET_DVR_GetErrorMsg返回最后操作的錯誤碼信息全部NET_DVR_Login_V30注冊全部NET_DVR_Logout_V30注銷全部編程引導(dǎo)SDK主動注冊模式SDK接口調(diào)用的主要流程其中虛線框的流程是可選部分，不會影響其他流程和模塊的功能使用。按實現(xiàn)功能的不同可以分成十個模塊，實現(xiàn)每個模塊的功能時初始化SDK、用戶注冊設(shè)備、注銷設(shè)備和釋放SDK資源這4個流程是必不可少的。1) 初始化SDK（NET_DVR_Init）：對整個網(wǎng)絡(luò)SDK系統(tǒng)的初始化，內(nèi)存預(yù)分配等操作。2) 設(shè)置連接超時時間（NET_DVR_SetConnectTime）：這部分為可選，用于設(shè)置SDK中的網(wǎng)絡(luò)連接超時時間，用戶可以根據(jù)自己的需要設(shè)置該值。在不調(diào)用此接口設(shè)置超時時間的情況下，將采用SDK中的默認值。 3) 設(shè)置接收異常消息的回調(diào)函數(shù)（NET_DVR_SetDVRMessage或NET_DVR_SetExceptionCallBack_V30）：由于SDK中大部分模塊的功能都是由異步模式實現(xiàn)，所以我們提供此接口用于接收預(yù)覽、報警、回放、透明通道和語音對講等模塊發(fā)生異常信息。用戶可以在初始化SDK后就設(shè)置該回調(diào)函數(shù)，在應(yīng)用層對各個模塊異常消息的接收和處理。 4) 從解析服務(wù)器獲得設(shè)備的IP地址（NET_DVR_GetDVRIPByResolveSvr）：該接口提供一種在僅知道設(shè)備名稱和序列號的情況下，從解析服務(wù)器獲得設(shè)備IP地址的方法。如：當前設(shè)備是通過撥號上網(wǎng)方式獲取到動態(tài)IP地址，而運行了我公司IPServer軟件的服務(wù)器即為解析服務(wù)器，我們可以通過此接口輸入解析服務(wù)器的地址、設(shè)備的名稱和序列號等信息查詢該設(shè)備的IP地址。IPServer是我公司提供的一款域名解析服務(wù)器軟件。 5) 用戶注冊設(shè)備（NET_DVR_Login_V30）：實現(xiàn)用戶的注冊功能，注冊成功后，返回的用戶ID作為其他功能操作的唯一標識，SDK允許最大注冊用戶數(shù)為512個。就設(shè)備而言，而且同時最多允許128個用戶注冊；，而且同時最多允許128個用戶注冊。6) 預(yù)覽模塊：從前端服務(wù)器取實時碼流，解碼顯示以及播放控制等功能，同時支持軟解碼和解碼卡解碼。具體流程詳見預(yù)覽模塊流程。7) 回放和下載模塊：可以通過按時間和按文件名的方式遠程回放或者下載前端服務(wù)器的錄像文件，后續(xù)可以進行解碼或者存儲。同時還支持斷點續(xù)傳功能。具體流程詳見回放和下載模塊流程。8) 參數(shù)配置模塊：設(shè)置和獲取前端服務(wù)器的參數(shù)，主要包括設(shè)備參數(shù)、網(wǎng)絡(luò)參數(shù)、通道壓縮參數(shù)、串口參數(shù)、報警參數(shù)、異常參數(shù)、交易信息和用戶配置等參數(shù)信息。具體流程詳見參數(shù)配置模塊流程。9) 遠程設(shè)備維護模塊：實現(xiàn)關(guān)閉設(shè)備、重啟設(shè)備、恢復(fù)默認值、遠程硬盤格式化、遠程升級和配置文件導(dǎo)入/導(dǎo)出等維護工作。具體流程詳見遠程設(shè)備維護模塊流程。10) 語音對講轉(zhuǎn)發(fā)模塊：實現(xiàn)和前端服務(wù)器的語音數(shù)據(jù)對講和語音數(shù)據(jù)獲取，音頻編碼格式可以指定。具體流程詳見語音對講轉(zhuǎn)發(fā)模塊流程。11) 報警模塊：處理前端服務(wù)器上傳的各種報警信號。報警分為“布防”和“監(jiān)聽”兩種方式，在采用監(jiān)聽方式并且不需要獲取用戶ID的情況下，報警模塊可以無需進行“用戶注冊”操作步驟。具體流程詳見報警模塊流程。12) 透明通道模塊：透明通道是將IP數(shù)據(jù)報文解析后直接發(fā)送到串行口的一種技術(shù)。實際上起到了延伸串行設(shè)備控制距離的作用?？衫肐P網(wǎng)絡(luò)控制多種串行設(shè)備，如控制解碼器、矩陣、報警主機、門禁、儀器儀表等串行設(shè)備，對用戶來說，只看到點對點傳輸，無須關(guān)心網(wǎng)絡(luò)傳輸過程，所以稱為串口透明通道。 SDK提供485和232串口作為透明通道功能，其中要將232串口作為透明通道使用，首先必須在232串口的配置信息（NET_DVR_RS232CFG）中將工作模式選為透明通道，這樣232串口才可作為透明通道使用。具體流程詳見透明通道模塊流程。 13) 云臺控制模塊：實現(xiàn)對云臺的基本操作、預(yù)置點、巡航、軌跡和透明云臺的控制。SDK將云臺控制分為兩種模式：一種是通過圖像預(yù)覽返回的句柄進行控制；另一種是無預(yù)覽限制，通過用戶注冊ID號進行云臺控制。 14) 解碼器功能模塊：實現(xiàn)解碼器設(shè)備的配置、解碼控制等功能。SDK支持單路解碼器和多路解碼器，但目前以多路解碼器為主流產(chǎn)品。具體流程詳見多路解碼器功能模塊流程。 15) 智能行為分析功能模塊：實現(xiàn)對智能產(chǎn)品的參數(shù)配置、報警上傳和能力集獲取等功能。具體流程詳見智能行為分析功能模塊流程。 注：本手冊下文提供的代碼都是在VC環(huán)境下編譯的。預(yù)覽模塊流程l 實時預(yù)覽支持TCP、UDP、RTP、MULTICAST網(wǎng)絡(luò)傳輸模式。 l 實時預(yù)覽時，DS80xx、DS70xx、DS71xx、DS72xx、 DS60xx、DS61xx系列設(shè)備每個通道最多支持6路同時連接，每臺設(shè)備最多支持24路同時連接；DS81xx、DS71xxHV、72xxHV等系列設(shè)備每個通道最多支持6路同時連接，每臺設(shè)備最多支持18路同時連接；DS90xx混合型硬盤錄像機每個通道最多支持6路同時連接，每臺設(shè)備最多支持64路同時連接；DS91xx系列設(shè)備每個通道最多支持6路同時連接，每臺設(shè)備最多支持64路同時連接；IP設(shè)備每個通道最多支持6路同時連接；DS91xxST系列通道連接數(shù)沒有限制，每臺設(shè)備最多支持128路同時連接。 預(yù)覽和與預(yù)覽相關(guān)的模塊流程圖圖中虛線框部分的模塊是與預(yù)覽模塊相關(guān)，必須在啟動預(yù)覽后才能調(diào)用，這些模塊之間是并列的關(guān)系，各自完成相應(yīng)的功能。l 聲音控制功能主要實現(xiàn)獨占、共享聲音的打開和關(guān)閉；音量的控制。相關(guān)接口有：NET_DVR_OpenSound、NET_DVR_CloseSound、NET_DVR_OpenSoundShare、NET_DVR_CloseSoundShare、NET_DVR_Volume等。l 實時流數(shù)據(jù)捕獲和錄像模塊主要實現(xiàn)數(shù)據(jù)回調(diào)和本地錄像的功能，可以供用戶后續(xù)處理。相關(guān)接口有：NET_DVR_SetRealDataCallBack、NET_DVR_SetStandardDataCallBack、NET_DVR_SaveRealData等。l 抓圖功能主要實現(xiàn)對當前解碼圖像的捕獲，保存格式為BMP。相關(guān)接口有：NET_DVR_CapturePicture。l 云臺控制模塊主要是在開啟預(yù)覽的前提下實現(xiàn)對云臺控制的操作功能，包括云臺預(yù)置點、巡航、軌跡和透明云臺等。相關(guān)接口有：NET_DVR_PTZControl、NET_DVR_PTZControl_EX、NET_DVR_PTZPreset、NET_DVR_PTZPreset_EX、NET_DVR_PTZCruise、NET_DVR_PTZCruise_EX、NET_DVR_PTZTrack、NET_DVR_PTZTrack_EX、NET_DVR_TransPTZ、NET_DVR_TransPTZ_EX。實時流解碼方式l 方式一：在預(yù)覽接口NET_DVR_RealPlay_V30中預(yù)覽參數(shù)的播放窗口句柄賦成有效句柄，則由SDK實現(xiàn)解碼功能。在初始化SDK和注冊設(shè)備兩步驟后，直接調(diào)用啟動預(yù)覽和停止預(yù)覽接口。l 方式二：用戶可以通過設(shè)置預(yù)覽接口NET_DVR_RealPlay_V30中預(yù)覽參數(shù)的播放窗口句柄為空值，并通過調(diào)用捕獲數(shù)據(jù)的接口（即設(shè)置NET_DVR_RealPlay_V30接口中的回調(diào)函數(shù)或調(diào)用NET_DVR_SetRealDataCallBack、NET_DVR_SetStandardDataCallBack接口），獲取碼流數(shù)據(jù)進行后續(xù)解碼播放處理。下面示例代碼以設(shè)置NET_DVR_RealPlay_V30()接口中的回調(diào)為例進行說明。 示例代碼方式一(由SDK實現(xiàn)解碼顯示) include include iostreaminclude include include using namespace std。void CALLBACK g_ExceptionCallBack(DWORD dwType, LONG lUserID, LONG lHandle, void *pUser){ char tempbuf[256] = {0}。 switch(dwType) { case EXCEPTION_RECONNECT: //預(yù)覽時重連 print