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