【正文】 pe。 設(shè)備信息結(jié)構(gòu) ?設(shè)備結(jié)構(gòu)定義如下 typedef struct { BYTE sSerialNumber[SERIALNO_LEN]。 網(wǎng)絡(luò)客戶端 SDK 編程手冊(cè) 第 13 頁(yè) 共 93 頁(yè) 3 數(shù)據(jù)結(jié)構(gòu)定義 客戶端數(shù)據(jù)結(jié)構(gòu) ?通用云臺(tái)控制命令 typedef enum _PTZ_ControlType { PTZ_UP_CONTROL = 0, //上 PTZ_DOWN_CONTROL, //下 PTZ_LEFT_CONTROL, //左 PTZ_RIGHT_CONTROL, //右 PTZ_ZOOM_ADD_CONTROL, //變倍 + PTZ_ZOOM_DEC_CONTROL, //變倍 PTZ_FOCUS_ADD_CONTROL, //調(diào)焦 + PTZ_FOCUS_DEC_CONTROL, //調(diào)焦 PTZ_APERTURE_ADD_CONTROL, //光圈 + PTZ_APERTURE_DEC_CONTROL, //光圈 PTZ_POINT_MOVE_CONTROL, //轉(zhuǎn)至預(yù)置點(diǎn) PTZ_POINT_SET_CONTROL, //設(shè)置 PTZ_POINT_DEL_CONTROL, //刪除 PTZ_POINT_LOOP_CONTROL, //點(diǎn)間輪循 PTZ_LAMP_CONTROL, //燈光雨刷 }PTZ_ControlType。 ? 心跳功能 在本開發(fā)包中提供自動(dòng)心跳功能（ 20 秒一次心跳）當(dāng)設(shè)備斷開能及時(shí)回調(diào)給客戶端 。 ? 用戶登錄和注銷 用戶在訪問(wèn)前端設(shè)備之前必須通過(guò)調(diào)用 CLIENT_Login ()登錄到前端設(shè)備上，登錄成功后返回一個(gè)全局唯一的句柄。通過(guò)特定接口，應(yīng)用層可以通過(guò)本 SDK 獲取標(biāo)準(zhǔn)媒體數(shù)據(jù)（ FOURCC(‘D’、 ‘I’、 ‘V’、 ‘X’)視頻數(shù)據(jù)） ， 要 支持用各種通用播放器播放 ， 有了提供標(biāo)準(zhǔn)數(shù)據(jù) ， 應(yīng)用層只須打包標(biāo)準(zhǔn)數(shù)據(jù)到播放器支持的容器類型 (也就是文件格式 ,如 AVI 標(biāo)準(zhǔn) )就可以了 。必要的時(shí)候，可以轉(zhuǎn)單路監(jiān)視。 設(shè)備管理 ：遠(yuǎn)程升級(jí)、遠(yuǎn)程重啟 /關(guān)閉、設(shè)備參數(shù)配置（系統(tǒng)通用配置、報(bào)警 布 /撤防設(shè) 置、錄像配置、串口配置、圖像配置、日志管理、用戶管理、設(shè)備校時(shí)、動(dòng)態(tài)檢測(cè)配置、網(wǎng)絡(luò)配置） 等功能。我們將會(huì)定期更新 手冊(cè)的內(nèi)容。 本手冊(cè)可能包含技術(shù)上不準(zhǔn)確的地方或印刷錯(cuò)誤 ，歡迎指正。 網(wǎng)絡(luò)客戶端軟件開發(fā)包主要包括業(yè)務(wù)操作和設(shè)備管理兩大部分： 業(yè)務(wù)操作 ：狀態(tài)偵聽 、 實(shí)時(shí)監(jiān)視、實(shí)時(shí)預(yù)覽、字符疊加、音頻控制、錄像回放和下載、數(shù)據(jù)保存、云臺(tái)控制、語(yǔ)音對(duì)講、透明串口、碼流統(tǒng)計(jì)等功能。所謂多路預(yù)覽，就是在一個(gè)通道上把所有通道的數(shù)據(jù)組織在一起傳輸，等同于多路同時(shí)監(jiān)視。本 SDK 能夠解決這個(gè)問(wèn)題。 ? 操作句柄 系統(tǒng)設(shè)計(jì)上多處使用了句柄概念，很多操作均針對(duì)句柄，如回放、下載以及語(yǔ)音對(duì)講等。建立連接與登錄是同步的。 網(wǎng)絡(luò)客戶端 SDK 編程手冊(cè) 第 10 頁(yè) 共 93 頁(yè) 典型調(diào)用順序 A. 初始化 SDK 初始化 CLIENT_Init() B. SDK 功能設(shè)置或信息獲取 設(shè)置連接等待時(shí)間 CLIENT_SetConnectTime() 獲取 SDK 版本 CLIENT_GetSDKVersion() 設(shè) 置消息回調(diào) CLIENT_SetDVRMessCallBack() 設(shè)置自定義疊加畫板 CLIENT_RigisterDrawFun() C. 登錄 連接 設(shè)備 登錄設(shè)備 CLIENT_Login() 開始偵聽 CLIENT_StartListen() D. 設(shè)備功能操作與 信息 獲取 系統(tǒng)配置 CLIENT_QueryConfig() CLIENT_SetupConfig() 獲取設(shè)備狀態(tài) CLIENT_GetDEVWorkState() 獲取協(xié)議信息 CLIENT_QueryComProtocol() 查詢獲取系統(tǒng)信息 CLIENT_QuerySystemInfo() 查詢通道名稱 CLIENT_QueryChannelName() 查詢?nèi)罩? CLIENT_QueryLogCallback() CLIENT_QueryLog() 用戶管理 CLIENT_QueryUserInfo() CLIENT_OperateUserInfo() 云臺(tái)控制 CLIENT_PTZControl() CLIENT_DHPTZControl() 語(yǔ)音對(duì)講 CLIENT_StartTalk() CLIENT_SendTalkData_Custom() CLIENT_StopTalk() 設(shè)置限流 CLIENT_SetMaxFlux() 透明串口 CLIENT_CreateTransComChannel() CLIENT_SendTransComData() CLIENT_DestroyTransComChanne() 網(wǎng)絡(luò)客戶端 SDK 編程手冊(cè) 第 11 頁(yè) 共 93 頁(yè) E. 實(shí)時(shí)監(jiān)視通道 打開監(jiān)視通道 CLIENT_RealPlay() CLIENT_RealPlayEx() 保存監(jiān)視圖像數(shù)據(jù) CLIENT_SaveRealData() 監(jiān)視數(shù)據(jù)回調(diào)保存 CLIENT_SetRealDataCallBack() CLIENT_SetRealDataCallBackEx() 獲取視頻參數(shù)信息 CLIENT_ClientGetVideoEffect() 設(shè)置修改視頻參數(shù) CLIENT_ClientSetVideoEffect() 強(qiáng)制 I 幀 CLIENT_MakeKeyFrame() F. 多畫面預(yù)覽 通道 打開多畫面預(yù)覽 CLIENT_MultiPlay() 停止多畫面預(yù)覽 CLIENT_StopMultiPlay() G. 回放 /下載通道 查詢錄像 CLIENT_QueryRecordFile() 回放及控制 CLIENT_PlayBackByRecordFile() CLIENT_PlayBackByRecordFileEx() CLIENT_PlayBackByTime() CLIENT_PlayBackByTimeEx() CLIENT_GetPlayBackOsdTime() CLIENT_PausePlayBack() CLIENT_SeekPlayBack() CLIENT_StopPlayBack() CLIENT_StepPlayBack() CLIENT_FastPlayBack() CLIENT_SlowPlayBack() CLIENT_GetFramePlayBack() CLIENT_SetFramePlayBack() 下載 CLIENT_DownloadByRecordFile() CLIENT_DownloadByRecordFileEx() CLIENT_DownloadByTime() CLIENT_StopDownload() CLIENT_GetDownloadPos() 網(wǎng)絡(luò)客戶端 SDK 編程手冊(cè) 第 12 頁(yè) 共 93 頁(yè) H. 針對(duì) 顯示 圖像的操作 (監(jiān)視 /回放 /多畫面預(yù)覽 ) 抓圖 CLIENT_CapturePicture() 碼流統(tǒng)計(jì) CLIENT_GetStatiscFlux() 打開音頻 CLIENT_OpenSound() 設(shè)置音量 CLIENT_SetVolume() I. 遠(yuǎn)程控制 遠(yuǎn)程升級(jí) CLIENT_StartUpgrade CLIENT_SendUpgrade CLIENT_StopUpgrade 錄像控制 CLIENT_QueryRecordState CLIENT_SetupRecordState 系統(tǒng)校時(shí) CLIENT_QueryDeviceTime CLIENT_SetupDeviceTime IO 控制 CLIENT_QueryIOControlState CLIENT_IOControl J. 注銷斷開設(shè)備 停止偵聽 CLIENT_StopListen() 斷開連接 CLIENT_Logout() K. 釋放 SDK 資源 SDK 退出 CLIENT_Cleanup() 對(duì) D、 E、 F、 G、 H、 I 中的功能大部分 之間 沒有調(diào)用先后順序 ,當(dāng)然對(duì)同一個(gè)功能還是應(yīng)該按先打開再操作最后關(guān)閉的順序 。 ?查詢狀態(tài)類型 define DH_DEVSTATE_COMM_ALARM 0x0001 //查詢普通報(bào)警 define DH_DEVSTATE_SHELTER_ALARM 0x0002 //查詢遮擋報(bào)警 define DH_DEVSTATE_RECORDING 0x0003 //查詢錄象狀態(tài) define DH_DEVSTATE_DISK 0x0004 //查詢硬盤狀態(tài) ?錯(cuò)誤類型代號(hào)，用于 GetLastError 函數(shù)的返回 define _EC(x) (0x80000000|x) define NET_NOERROR 0 //沒有錯(cuò)誤 define NET_ERROR 1 //未知錯(cuò)誤 define NET_SYSTEM_ERROR _EC(1) //Windows系統(tǒng)出錯(cuò) define NET_NETWORK_ERROR _EC(2) //網(wǎng)絡(luò)錯(cuò)誤 define NET_DEV_VER_NOMATCH _EC(3) //設(shè)備協(xié)議不匹配 網(wǎng)絡(luò)客戶端 SDK 編程手冊(cè) 第 15 頁(yè) 共 93 頁(yè) define NET_INVALID_HANDLE _EC(4) //句柄無(wú)效 define NET_OPEN_CHANNEL_ERROR _EC(5) //打開通道失敗 define NET_CLOSE_CHANNEL_ERROR _EC(6) //關(guān)閉通道失敗 define NET_ILLEGAL_PARAM _EC(7) //用戶參數(shù)不合法 define NET_SDK_INIT_ERROR _EC(8) //SDK初始化出錯(cuò) define NET_SDK_UNINIT_ERROR _EC(9) //SDK清理出錯(cuò) define NET_RENDER_OPEN_ERROR _EC(10) //申請(qǐng) render資源出錯(cuò) define NET_DEC_OPEN_ERROR _EC(11) //打開解碼庫(kù)出錯(cuò) define NET_DEC_CLOSE_ERROR _EC(12) //關(guān)閉解碼庫(kù)出錯(cuò) define NET_MULTIPLAY_NOCHANNEL _EC(13) //多畫面預(yù)覽中檢測(cè)到通道數(shù)為 0 define NET_TALK_INIT_ERROR _EC(14) //錄音庫(kù)初始化失敗 define NET_TALK_NOT_INIT _EC(15) //錄音庫(kù)未經(jīng)初始化 define NET_TALK_SENDDATA_ERROR _EC(16) //發(fā)送音頻數(shù)據(jù)出錯(cuò) define NET_REAL_ALREADY_SAVING _EC(17) //實(shí)時(shí)數(shù)據(jù)已經(jīng)處于保存狀態(tài) define NET_NOT_SAVING _EC(18) /