【正文】 大華網(wǎng)絡(luò) SDK 編程手冊VERSION (Build 070321)2022321版權(quán)所有 侵權(quán)必究 網(wǎng)絡(luò)客戶端 SDK 編程手冊第 2 頁 共 94 頁前 言非常感謝您使用我們公司的設(shè)備，我們將為您提供最好的服務(wù)。本手冊可能包含技術(shù)上不準(zhǔn)確的地方或印刷錯誤，歡迎指正。我們將會定期更新手冊的內(nèi)容。 網(wǎng)絡(luò)客戶端 SDK 編程手冊第 3 頁 共 94 頁修訂記錄日期 修訂內(nèi)容 作者20220530 創(chuàng)建 林峰202273 修訂接口描述 馮江202275 修訂概要描述 華立高2022726 修訂接口描述 劉杰 陳美英2022810 同步更新接口描述 陳美英2022821 修訂接口描述 陳美英2022823 增加典型調(diào)用順序描述 陳美英2022828 整理修訂 陳美英2022915 同步增加回調(diào)數(shù)據(jù)擴展接口,更新云臺控制說明陳美英2022921 同步增加登錄擴展接口 陳美英2022929 同步增加帶有配置結(jié)構(gòu)的配置功能接口說明陳美英20221016 增加單獨修改通道名稱的接口 趙均樹20221021 增加打開實時圖像的擴展接口 趙均樹20221028 增加按時間回放和下載接口增加設(shè)備配置的第三方接入和獲取設(shè)備的序列號功能趙均樹2022118 帶數(shù)據(jù)回調(diào)的按時間回放擴展接口帶數(shù)據(jù)回調(diào)的按文件回放擴展接口遠(yuǎn)程重啟接口錄像回放能夠播放音頻趙均樹、陳瓊施20221119 解決了反復(fù)修改第三方的 IP 地址時 DVR 比較容易死機的問題增加 485 接口通過網(wǎng)絡(luò)修改 IP 配置時 DVR 重啟趙均樹、陳瓊施20221127 增加 DDNS 查詢 IP 的功能 趙均樹、陳瓊施20221215 修正文檔中接口描述的錯誤,并增加鏈接 趙均樹、陳瓊施、林堅彥20221225 增加并修改語音對講的接口 葉浩、陳瓊施20221229 增加用戶管理接口 林堅彥、陳瓊施2022117 修改了 CLIENT_Login 的功能描述增加了CLIENT_FindFile、CLIENT_FindNextFile 、CLIENT_FindClose林堅彥、趙均樹、陳瓊施 網(wǎng)絡(luò)客戶端 SDK 編程手冊第 4 頁 共 94 頁202228 增加了設(shè)備參數(shù)配置的兩個接口：CLIENT_GetDevConfig CLIENT_SetDevConfig林堅彥、陳瓊施、趙均樹202237 修改了 CLIENT_StopListen 接口典型應(yīng)用的筆誤趙均樹20220319 增加了個查詢報警狀態(tài)的接口。 林堅彥、陳瓊施20220321 增加了語音對講中的音頻編碼接口增加了擴展報警偵聽接口葉浩、陳瓊施、林堅彥 網(wǎng)絡(luò)客戶端 SDK 編程手冊第 5 頁 共 94 頁目 錄1 簡 介 .............................................................7 概述 ..........................................................7 適用性 ........................................................7 特色功能 .......................................................82 設(shè)計原則 ...........................................................9 編程說明 .......................................................9 典型調(diào)用順序 ..................................................103 數(shù)據(jù)結(jié)構(gòu)定義 ......................................................13 客戶端數(shù)據(jù)結(jié)構(gòu) .................................................13 設(shè)備信息結(jié)構(gòu) ..............................................16 時間信息 ..................................................16 錄像文件信息 ..............................................17 設(shè)備狀態(tài)信息 ..............................................17 系統(tǒng)配置信息結(jié)構(gòu) ...........................................214 接口定義 ..........................................................21 SDK 初始化 ....................................................21 狀態(tài)偵聽 ......................................................23 字符疊加 ......................................................25 設(shè)備注冊 ......................................................26 實時監(jiān)視 ......................................................27 音頻控制 ......................................................31 數(shù)據(jù)保存 ......................................................32 視頻抓圖 ......................................................35 回放和下載 ....................................................36 回放控制 .....................................................46 云臺控制 .....................................................49 實時預(yù)覽 .....................................................51 系統(tǒng)配置 .....................................................52 日志管理 .....................................................57 透明串口 .....................................................58 遠(yuǎn)程控制 .....................................................60 錄像控制 .....................................................62 系統(tǒng)時間 .....................................................63 用戶管理 .....................................................63 網(wǎng)絡(luò)客戶端 SDK 編程手冊第 6 頁 共 94 頁 語音 對講 .....................................................65 碼流統(tǒng)計 .....................................................69 IO 控制 ......................................................70 強制 I 幀 .....................................................71 設(shè)置限流 .....................................................71 獲取設(shè)備狀態(tài) .................................................72 修改通道名稱 .................................................72 DDNS 查詢 IP .................................................73 設(shè)備參數(shù) 配置 .................................................735 示例功能實現(xiàn) ......................................................87 連接設(shè)備 ......................................................88 報警信息獲取 ..................................................88 系統(tǒng)配置 ......................................................88 實時監(jiān)視 ......................................................88 數(shù)據(jù)保存 ......................................................89 回放/下載和進(jìn)度指示 ............................................89 播放控制 ......................................................89 預(yù)覽 .........................................................89 字符疊加 ......................................................89 網(wǎng)絡(luò)客戶端 SDK 編程手冊第 7 頁 共 94 頁1 簡 介 概述歡迎使用大華網(wǎng)絡(luò) SDK 編程手冊，網(wǎng)絡(luò)客戶端軟件開發(fā)包（ DVR 客戶端 SDK）是大華網(wǎng)絡(luò)硬盤錄像機、網(wǎng)絡(luò)視頻服務(wù)器的配套產(chǎn)品，本文檔詳細(xì)描述了開發(fā)包中各個函數(shù)實現(xiàn)的功能、接口及其函數(shù)之間的調(diào)用關(guān)系和示例實現(xiàn)。 網(wǎng)絡(luò)客戶端軟件開發(fā)包主要包括業(yè)務(wù)操作和設(shè)備管理兩大部分： 業(yè)務(wù)操作 ：狀態(tài)偵聽、實時監(jiān)視、實時預(yù)覽、字符疊加、音頻控制、錄像回放和下載、數(shù)據(jù)保存、云臺控制、語音對講、透明串口、碼流統(tǒng)計等功能。設(shè)備管理 ：遠(yuǎn)程升級、遠(yuǎn)程重啟/關(guān)閉、設(shè)備參數(shù)配置（系統(tǒng)通用配置、報警布 /撤防設(shè)置、錄像配置、串口配置、圖像配置、日志管理、用戶管理、設(shè)備校時、動態(tài)檢測配置、網(wǎng)絡(luò)配置）等功能。 開發(fā)包所包括的文件有：網(wǎng)絡(luò)庫：、解碼庫：、 、 、輔助庫： 、 適用性 ? 支持所有大華網(wǎng)絡(luò)硬盤錄像機（DVR） 、網(wǎng)絡(luò)視頻服務(wù)器（NVS） 、網(wǎng)絡(luò)報警 服務(wù)器（NAS） ? 只支持 TCP 網(wǎng)絡(luò)傳輸模式 ? 客戶端可以采用多種分辨率進(jìn)行圖像預(yù)覽，支持的分辨率包括： QCIF、CIF 、2CIF、 、HalfDD1，VGA（640480）等? 客戶端支持多種圖像編碼，包括 MPEG4 和 等 特色功能支持設(shè)備的以下特色功能：? 多路預(yù)覽在窄帶條件下，同時多路實時監(jiān)視對帶寬的要求比較高，一般的處理情況有兩種，其一，輪巡。其二，多路預(yù)覽。所謂多路預(yù)覽，就是在一個通道上把所有通道的數(shù)據(jù)組織在一起傳輸，等同于多路同時監(jiān)視。必要的時候，可以轉(zhuǎn)單路監(jiān)視。大華 DVR 支持多路預(yù)覽功能。? 支持標(biāo)準(zhǔn)的 MP4 數(shù)據(jù)一般情況下，同一平臺集成不同廠商的前端設(shè)備（如 DVR） ，由于各廠商采用 網(wǎng)絡(luò)客戶端 SDK 編程