二次開發(fā)接口文檔

1、接口開發(fā)文檔一、開發(fā)包目錄結(jié)構(gòu)1.1 demo 文件夾包含了 sdk 接口調(diào)用源代碼，可供二次開發(fā)參考。使用 C+開發(fā)的 MFC 程序。1.2 dll 文件夾包含了二次開發(fā)所需的所有動態(tài)庫，demo 編譯好的 exe 文件需要放在該文件夾內(nèi)才可 以運行。1.3 include 文件夾包含了二次開發(fā)所需要的頭文件。1.4 lib 文件夾包含了二次開發(fā)所需要的 lib 靜態(tài)庫。1.5 DSS 二次開發(fā)指南(C+).pdf指導(dǎo)二次開發(fā)用戶如何新建 VS2005 工程運行 demo 文件夾中的 demo。1.6 Version.xmldpsdk 開發(fā)包的程序版本信息。1.7 常見問題解答.pdf二次開

2、發(fā)常見問題以及解決方式。1.8 大華平臺 SDK 開發(fā)手冊(C+版).chm二次開發(fā)接口使用說明。二、術(shù)語和縮略語1、 DPSDK：DSS 平臺二次開發(fā) SDK 包2、 CMS：中心管理服務(wù)3、 DMS： 設(shè)備管理模塊4、 demo：程序示例（功能類似 DSS 平臺客戶端）5、 web 管理員端：在瀏覽器中輸入 DSS 平臺的 ip 即可打開管理員端6、 CameraID：通道 id，形如：10000010$1$0$0 7、 DeviceID：設(shè)備 id三、Demo 操作方法3.1 運行 demo把“demo/bin/” 目錄下面的 3 個文件，如下圖所示拷貝到“dll”文件夾下面，運行Tes

3、t_DPSDK_Core.exe。3.2 登陸平臺登陸界面如圖 1 所示，其中： IP：DSS 平臺 ip 地址； 端口：9000；圖 1 登陸界面用戶名：web 管理員端配置的用戶；密碼：web管理員端配置的用戶對應(yīng)的密碼。 點擊“登錄”按鈕，登陸平臺。登陸成功的界面如圖 2 所示：1235圖 2 主界面上圖選中的 5個模塊分別是：1、組織樹；2、實時視頻；3、本地錄像；4、云臺操作；5、執(zhí)行結(jié)果。3.3 主界面功能介紹3.3.1、組織樹操作步驟：點擊“加載所有組織結(jié)構(gòu)”按鈕 加載組織結(jié)構(gòu)是其他操作的前提，是為了獲取 DSS平臺上所有的設(shè)備信息。3.3.2、實時視頻模塊操作步驟：1）確保已經(jīng)

4、成功加載組織結(jié)構(gòu)。2）輸入 CamID(通道 ID)。3）點擊“打開 視頻”按鈕，即可打開視頻。如果打開視頻失敗會在“模塊5”的位置提示錯誤碼。注釋 1:CamID(通道 ID)的獲取方式有 1）展開模塊 1 組織樹，尋找到對應(yīng)的編碼器通道，即可看到該通道對應(yīng)的通道 ID；2）登陸 web 管理員端，選擇基本配置-設(shè)備管理-編碼器界 面，看到“編碼”列給出的是“設(shè)備 ID”。使用設(shè)備 ID 組成通道 ID 即：設(shè)備 ID$1$0$0。$1 代表編碼器，$0 代表單元序號，默認為 0，$0 代表通道號。具體信息參考“常見問題解答”。3.3.3、本地錄像模塊 操作步驟：1）確保已經(jīng)成功加載組織結(jié)構(gòu)

5、。2）確保已經(jīng)成功打開實時視頻。3）點擊“開始錄像”按鈕即可開始本地錄像。在打開實時視頻以后可以錄像，并保存到本地磁盤。3.3.4、云臺控制模塊 操作步驟：1）確保已經(jīng)成功加載組織結(jié)構(gòu)。2）確保已經(jīng)成功打開實時視頻。 打開實時視頻以后，針對球機設(shè)備可以操作八方向、調(diào)節(jié)球機鏡頭、設(shè)置預(yù)置點等。3.3.5、執(zhí)行結(jié)果模塊 將所有操作的結(jié)果輸出。并輸出對應(yīng)的操作失敗錯誤碼。3.4 回放界面功能介紹3.4.1 錄像查詢操作步驟：1）確保已經(jīng)成功加載組織結(jié)構(gòu)。2）輸入 CameraID（通道 ID）。3）選擇查 詢的開始和結(jié)束時間。4）選擇錄像來源。5）選擇錄像類型。點擊“查詢錄像”按鈕查詢錄像。3.4.

6、2 錄像回放操作步驟：1）確保已經(jīng)成功加載組織結(jié)構(gòu)。2）確保已經(jīng)查詢到錄像文件。3）選中錄 像文件，點擊“按文件回放”按鈕。3.4.2 錄像下載操作步驟：1）確保已經(jīng)成功加載組織結(jié)構(gòu)。2）確保已經(jīng)查詢到錄像文件。3）選中錄 像文件，點擊“按文件下載”按鈕。3.5 報警功能3.5.1 查詢報警操作步驟：1）確保已經(jīng)成功加載組織結(jié)構(gòu)。2）輸入 CamID（通道 ID）。3）選擇報警 類型，點擊“查詢”按鈕。需 要 注 意 的 是 查 詢 視 頻 類 報 警 （ 即： 視頻丟失 / 移動偵測 / 視頻遮擋） 時 CamID 為1000001$1$0$0，查詢其他報警（除上述 3 種報警類型）的時候

7、CamID 為 1000001$3$0$0。 因為視頻類報警是由“視頻通道”產(chǎn)生，其他報警是由“報警輸入通道”產(chǎn)生。3.5.2 報警布控操作步驟：1）確保已經(jīng)成功加載組織結(jié)構(gòu)。2）輸入設(shè)備 ID。3）輸入通道號，（視頻類報警使用“視頻通道號”，其他報警使用“報警通道號”）。4）選擇報警類型，點擊“布控” 按鈕即可。注釋：視頻類報警類型包含 1）視頻丟失 2）移動偵測 3）視頻遮擋。3.6 語音對講3.6.1 打開語音對講操作步驟：1）確保已經(jīng)成功加載組織結(jié)構(gòu)。2）輸入 CamID（通道 ID），選擇對講參數(shù)， 3）點擊“開始語音對講”按鈕。如果參數(shù)錯誤會彈窗提示正確參數(shù)信息。3.6.2 關(guān)閉語

8、音對講 操作步驟：1）確保已經(jīng)成功打開語音對講。2）點擊“根據(jù)序列號停止語音對講”或者“根據(jù)通道號停止語音對講”按鈕。3.7 電視墻目前Demo不能新建電視墻任務(wù)，只能獲取平臺配置好的電視墻信息。電視墻的任務(wù)需要在平臺客戶端添加。3.7.1 電視墻操作 操作步驟：1）確保已經(jīng)成功加載組織樹。2）點擊“獲取電視墻總數(shù)”按鈕。3）點擊“獲取電視墻信息”按鈕。4）選擇電視墻ID。5）點擊“獲取電視墻布局”按鈕。即可顯示電視墻對應(yīng)的屏幕分割信息。上圖顯示 ID 為 3 的電視墻的名字是 tt 狀態(tài)是 1（代表啟用）。電視墻有 4 塊屏幕，屏 id、 屏名稱、屏坐標(biāo)、是否綁定解碼器（1_1000943

9、代表綁定解碼器，解碼器 id 為 1000943）。3.7.2 屏幕分割和開窗操作 操作步驟：1）確保已經(jīng)成功獲取到電視墻屏幕信息。2）選擇一個屏幕。3）執(zhí)行分割和開窗操作。所有的融合屏<NVD 除外>都只做開窗。非融合和融合的 NVD 都只做分割。開窗操作（left，上）代表窗口左上角坐標(biāo)，width 和 Height 代表寬和高的比例，范圍是0-100。例如：（left，上）為（0,0）；（width,Height）為（50,50）。3.7.3 設(shè)置視頻源操作 操作步驟：1）確保已經(jīng)成功獲取到電視墻屏幕信息。2）輸入編碼器通道 ID。3）輸入窗口號（分割和開窗操作的窗口號從0開

10、始）。4）點擊“設(shè)置”按鈕。5）點擊“關(guān)閉”按鈕清除窗口視頻源。6）點擊“清屏”按鈕清除所有屏幕上的窗口和視頻源。四、常見問題1 概述本文檔列出了使用大華 SDK 進行二次開發(fā)時出現(xiàn)的常見問題以及對應(yīng)的解決方法。方 便第三方開發(fā)者快速定位問題，提高二次開發(fā)效率。2 問題列表2.1 WebDemo 問題匯總2.1.1 在 IE 瀏覽器中打開 webDemo 視頻窗口顯示因為沒有注冊 ocx。在 ocx 文件夾中雙擊 reg.bat 只有提示注冊成功才可以。2.2 OCX 控件問題匯總2.2.1 OCX 無法注冊1、OCX控件時微軟推出已久的技術(shù)，其注冊方法及出錯原因可在微軟官方文檔上查詢，或 者

11、可以自行在網(wǎng)上查找解決方法。OCX 注冊問題本不屬于 DPSDK 支持范疇。 2、不過我們還是提供一些建議，以便您快速排除問題：（1）用“管理員權(quán)限”打開“開始”-“附件”-“命令提示符”，輸入“regsvr32 ocx 的 全路徑”即可。（2）我們提供的 OCX 控件是 32 位程序，請確保系統(tǒng)有 32 位兼容庫，具體判斷方法為 C:WindowsSysWOW64 這個文件夾下是否有“regsvr32.exe”這個文件，若沒有，請重新安 裝系統(tǒng)。若有，請按（1）中的方式打開命令提示符，輸入“c:windowsSysWOW64regsvr32 ocx 全 路 徑 ” 即 可 ， 如 “ c:w

12、indowsSysWOW64regsvr32 Z:DPSDK_OCXocxDPSDK_OCX.ocx ”如以上 2 點仍然沒有能夠成功注冊，請在網(wǎng)上，根據(jù)自己的系統(tǒng)信息自行搜索解決方案。 3、在注冊 dll 或者 ocx 的時候，經(jīng)常會遇到這么一個問題：模塊已加載，但對 dllregisterServer 的調(diào)用失敗，錯誤代碼為 0x8004*解決方法：在批處理的第一行加入：cd /d %dp0 然后在批處理上右鍵選擇使用管理員權(quán)限 運行4、Windows7 出現(xiàn):應(yīng)用程序無法啟動,因為應(yīng)用程序的并行配置不正確有關(guān)詳細信息，請參 閱應(yīng)用程序事件日志，或使用命令行 sxstrace.exe 工具

13、?！?解決方法：出現(xiàn)這個問題是因為安裝 windows7 后，或使用 ghost 版本安裝后， windows7 沒有安裝 Visual C+ 庫，而有些軟件需要 Visual C+ 庫所以到微軟官方網(wǎng)站下載：Microsoft VisualC+2005SP1RedistributablePackage(x86)下載：13-984D-389C36F85647&displaylang=zh-cn 安裝2.2.2 64 位系統(tǒng)下 OCX 無法使用目前 OCX 控件只有 32 位的程序，所以在 64 位系統(tǒng)下，需要下載 32 位的 IE，用 32 位的 IE加載 OCX 控件即可。2.2.3

14、 Ocx 注冊成功但是在頁面加載失敗運行 IE,工具->Internet 選項->安全，確保 Internet 和本地 Intranet 和可信站點的自定義級別中 的 ActiveX 選項都不是禁止?fàn)顟B(tài)，將禁止?fàn)顟B(tài)改為提示狀態(tài)。2.2.4 Ocx 開發(fā)包 demo 程序運行不起來DPSDK_OCX.ocx 未注冊，可以采用一下兩種方法注冊： 運行->CMD，regsvr32DPSDK_OCX.ocx 絕對路徑運行 ocx 開發(fā)包文件夾里面的 reg.bat 批處理，注意：DPSDK_OCX.ocx 必須要和 reg.bat 放 在同一個路徑。如果仍舊注冊失敗需要安裝 vs 發(fā)

15、布包，vcredist_x86.exe，可以從微軟官網(wǎng)上直接下載2.2.5 如何獲通道 ID（CameraID）在瀏覽器輸入 DSS 平臺的 ip 打開 web 管理員端，用管理員身份登錄平臺，找到“基本 設(shè)置”-“設(shè)備管理”-“編碼器”頁面的“編碼”列是所有的設(shè)備 ID。而 CameraID 的格式 為:"設(shè)備 ID$1$0$通道號",如設(shè)備 ID 為“1000000”，且設(shè)備下有 3 個視頻通道，那么這 3 個 CameraID 為"1000000$1$0$0"、"1000000$1$0$1"、"1000000$1$0$

16、2"。2.2.6 是否可以不加載組織結(jié)構(gòu)不調(diào)用 DPSDK_LoadDGroupInfo 也是可以的，但僅限于實時視頻、錄像回放，其他操作，如操作云臺等功能無法使用。方法是 Get_RealStream_Info_t中的nRight設(shè)置為 DPSDK_CORE_NOT_CHECK_RIGHT 即可。2.2.7 OCX 無法保存抓圖或創(chuàng)建文件夾失敗win7 系統(tǒng)的安全控制導(dǎo)致 OCX 控件無法創(chuàng)建文件夾。需要使用administrator 賬號登陸win7系統(tǒng)開發(fā)使用（有管理員權(quán)限的普通賬戶也不行）。2.2.8 OCX 控件收不到報警1）需要先調(diào)用布控報警DPSDK_EnableAla

17、rm。 2）其次平臺或者設(shè)備觸發(fā)報警。2.2.9 OCX 請求視頻沒有聲音需要打開音頻（DPSDK_OpenAudioByWndNo，DPSDK_OpenAudioByHWND）2.2.10 加載監(jiān)控視頻成功時瀏覽器會死掉 瀏覽器兼容問題，目前 ocx 控件主要針對 IE8/IE9 環(huán)境。 2.2.11 IE 瀏覽器加載視頻成功，其他瀏覽器無法加載瀏覽器兼容問題，其他基于 IE 內(nèi)核或者多核模式的瀏覽器（遨游，360，搜狗瀏覽器等）需要選擇兼容模式瀏覽。2.2.12 OCX 操作導(dǎo)致 IE 崩潰目前 OCX 中我們已經(jīng)集成了在崩潰時生成 crash dump 的功能，OCX 崩潰時會彈出對話

18、框提示 dump 生成的位置，用戶只需在此位置下找到.dmp 文件，然后將對應(yīng)的 pdb 文件一同 發(fā)送給我們即可。2.2.13 目前 OCX 只支持 ie8 32 位瀏覽器在頁面中加上<meta http-equiv="X-UA-Compatible" content="IE=EmulateIE8" />， 讓 IE 瀏覽器以兼容 IE8 方式運行。2.2.14 一路視頻對應(yīng)兩路音頻情況缺少音頻通道標(biāo)識DPSDK_OCX之前的開發(fā)包中已經(jīng)提供了多音頻通道的接口， DPSDK_GetAudioChannelsByWndNo / 獲取音頻通道數(shù)

19、 DPSDK_GetAudioChannelStateByWndNo / 獲取某個音頻通道的狀態(tài) DPSDK_SetAudioChannelByWndNo / 打開某個音頻通道 界面上的按鈕只是單純的音頻開關(guān)，客戶如需切換聲道，需要手動調(diào)用以上幾個接口。2.2.15 DPSDK_SeekPlaybackBySeqByWndNo 無法定位?？典浵竦讓硬シ艓觳恢С趾？典浵竦亩ㄎ徊僮鳎贿^可以通過以下操作替代，以實現(xiàn)一個進度 條為例：拖動進度條時，直接先關(guān)閉回放，再以進度條的當(dāng)前時間重新按時間請求回放。此時由 于 重 新 請 求 ， DPSDK_GetPlaybackPosByWndNo 等接口獲取

20、的進度不準(zhǔn) 確，改用DPSDK_GetFrameTimeByWndNo 直接獲取幀時間，然后保存下最初的開始和結(jié)束時間，即可計 算正確的進度。2.2.16 DPSDK 斷線重連，不能打開視頻需要重新加載組織結(jié)構(gòu)(即在 OnDevStatusEvent 中，當(dāng)收到重連成功的事件后，調(diào)用 DPSDK_LoadDGroupInfo)。2.2.17 NVR 設(shè)備狀態(tài)和通道狀態(tài)不同NVR的通道狀態(tài)需要通過訂閱才能實時返回通道狀態(tài)。設(shè)備在線，不一定通道在線。 OCX：ChannelStatusCallback。2.2.18 YUV 碼流接口不支持?？翟O(shè)備Ext 層的 YUV 碼流的相關(guān)接口，只支持大華設(shè)備

21、。不支持?？翟O(shè)備。2.2.19 接口返回某個錯誤碼的含義1）接口返回 1010 錯誤是因為超時時間太短可以嘗試增加接口超時時間，特別是廣域網(wǎng)上操作。 2）調(diào)用DPSDK_StartRealplayByWndNo 返回 3502，3600 錯誤 未選中窗口或者窗口失去焦點。3）返回其它錯誤碼 我們開發(fā)文檔里面有針對錯誤碼的介紹。搜索一下錯誤碼即可。2.3 DPSDK_DLL 版本問題匯總2.3.1 通道 ID（CameraID）介紹通道 ID（CameraID）形如：1000010$1$0$0，其中1）1000010 是設(shè)備 ID，該設(shè)備 ID 可以在平臺 web 管理員端“基本配置-設(shè)備管理”

22、頁面的 “編碼”列查詢。2）$1 代表的是單元類型。1 是編碼單元、2 是解碼單元、3 是報警輸入單元、4 是報警輸出 單元。實時視頻都是$1。3）$0 默認全寫 0，代表的是單元類型的序號。4）$0 這個代表的是通道序號。從 0 開始計算。比如一個設(shè)備有 8 個通道，則通道序號是 0- 如何獲通道 ID（CameraID）1）DPSDK_DLL 開發(fā)包中，有 demo 程序，demo 程序中登錄后，選擇“分級加載組織結(jié)構(gòu)”， 即可看到組織和設(shè)備樹。雙擊直到最后一層即為 CameraId。demo 我們提供了源碼，你可以 根據(jù)源碼進行開發(fā)，源碼中涉及到的函數(shù)在開發(fā)文檔中都有詳細說

23、明。2）在瀏覽器中，用管理員身份登錄平臺，可以看到所有的設(shè)備 ID。而編碼器 CameraID 的 格式為:"設(shè)備 ID$1$0$通道號",如設(shè)備 ID 為“1000000”，且設(shè)備下有 3 個通道，那么這 3 個 CameraID 為"1000000$1$0$0"、"1000000$1$0$1"、"1000000$1$0$2"。2.3.3 NVR 設(shè)備狀態(tài)和通道狀態(tài)不同NVR的通道狀態(tài)需要通過訂閱才能實時返回通道狀態(tài)。設(shè)備在線，不一定通道在線。 dll：DPSDK_SetDPSDKNVRChnlStatusCal

24、lback。2.3.4 登錄之后打開視頻返回 rtsp 建立失敗如果是內(nèi)外網(wǎng)環(huán)境，可能網(wǎng)絡(luò)環(huán)境不正確。2.4 Android SDK 問題匯總2.5 IOS SDK 問題匯總2.5.1 點擊實時預(yù)覽崩潰可能是播放庫太老，需要更新播放庫。2.6 其它2.6.1 設(shè)備通道 ID（CameraID）如何獲?。揩@取方式：方法 1.打開 DPSDK 對應(yīng)的 Demo，加載組織樹，展開對應(yīng)的組織節(jié)點，找到設(shè)備即可看 到通道 ID方法 2.通道 ID 格式為：“設(shè)備 ID $1$0$通道號”。比如設(shè)備 ID 為 1000001，對應(yīng)第一 個視頻通道 ID 為 1000001$1$0$0，對應(yīng)第二個視頻通道為

25、 1000001$1$0$1，依次類推。設(shè)備 ID 可以從 DSS 管理員端“設(shè)備管理”頁面獲取。在管理員模式下，使用 system 用戶登陸進入：基本設(shè)置->設(shè)備管理查看設(shè)備ID。通道號：對于 IPC 設(shè)備，只有一個通道，通道號只有 0；對于 DVR 設(shè)備，有多個通道， 具體的通道個數(shù)是在 web 管理員平臺上配的，比如配了 4 個通道，通道號依次為 0,1,2,3。2.6.1 模擬器實時預(yù)覽花屏播放庫對模擬器支持不全，實時和回放需要在真機上運行。2.6.2 目前 DPSDK 不接受 UI 界面相關(guān)的定制開發(fā)，用戶需要自己實現(xiàn) UI界面2.6.3 目前提供的 DPSDK 相關(guān) Demo

26、 只有 C+版2.6.4 DPSDK 二次開發(fā)郵箱 dh_dss_sdk 暫不提供研發(fā) 手機號碼2.6.5 現(xiàn)在只維護平臺是 3.0 以后的 dpsdk2.X 平臺的 dpsdk 已經(jīng)不再維護。2.6.6 打開視頻的接口有兩種打開視頻的接口：1）使用 ext 層，用戶不需要關(guān)心碼流，VaxPlayer 庫解析之。2）不使用 ext層，設(shè)置碼流回調(diào)函數(shù)，客戶可以拿到碼流。DPSDK_GetRealStream() pDlg->PostMessage(WM_MEDIADATA_CB, nSeq, 0)CWndPlayer:OnMediaDataCallback(WPARAM wParam,

27、LPARAM lParam)2.6.7 按時間回放功能1）按時間回放平臺錄像，由于平臺存在問題，相關(guān)功能會出現(xiàn) bug。不建議用戶使用 該功能。2）按時間回放設(shè)備錄像沒有問題。2.6.8 平臺回調(diào)上來的碼流平臺回調(diào)上來的碼流是 PS 流+大華頭。直接使用 vaxPlayer 播放。如果前端是?？翟O(shè)備回調(diào)上來的碼流是大華頭+海康流。需要使用 mediaParser 庫去掉大華頭在用 vaxPlayer 播放或者使用海康的播放庫播放。2.6.9 組織樹 xml 中 status 字段不準(zhǔn)確加載組織樹以后可以拿到組織樹 xml，設(shè)備信息中的 status 字段無法正確顯示設(shè)備的狀 態(tài)。需要注冊設(shè)備狀態(tài)回調(diào)函數(shù)來實時獲取設(shè)備的狀態(tài)。接口：DPSDK_SetDPSDKDeviceStatusCallback（）初始化設(shè)置回調(diào)。在登陸平臺的時 候會收到設(shè)備狀態(tài)，任何設(shè)備狀態(tài)改變后會再次回調(diào)上來。NVR 通道狀態(tài)比較特殊，因為 NVR 設(shè)備在線的時候，通道狀態(tài)可以是離線的。需要使 用接口：DPSDK_SetDPSDKNVRChnlStatusCallback（）2.6.10 設(shè)備狀態(tài)和通道狀態(tài)1、設(shè)備在線狀態(tài)需要設(shè)置回調(diào)函數(shù)：DPSDK_SetDPSDKDeviceStatusCallback（）在登陸平臺時 DMS 會推