【正文】 手冊(cè)第 8 頁(yè) 共 94 頁(yè)的視頻壓縮方法不同(包括算法、參數(shù)定義等)，導(dǎo)致解碼端回放必須采用廠商特定的工具，造成平臺(tái)開(kāi)發(fā)商無(wú)法自定義播放標(biāo)準(zhǔn)。本 SDK 能夠解決這個(gè)問(wèn)題。通過(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))就可以了。 網(wǎng)絡(luò)客戶端 SDK 編程手冊(cè)第 9 頁(yè) 共 94 頁(yè)2 設(shè)計(jì)原則 編程說(shuō)明? 初始化和清除 使用網(wǎng)絡(luò)客戶端軟件包首先調(diào)用 CLIENT_Init()對(duì)系統(tǒng)進(jìn)行初始化，應(yīng)用程序退出時(shí)調(diào)用 CLIENT_Cleanup()釋放所有占用的資源。 大多數(shù)函數(shù)調(diào)用均應(yīng)該在 CLIENT_Init()之后，CLIENT_Cleanup()之前，除了少數(shù)函數(shù)，譬如 CLIENT_SetConnectTime()在 CLIENT_Init()之前調(diào)用，而 CLIENT_GetSDKVersion()可以在任何時(shí)候調(diào)用等等。? 操作句柄系統(tǒng)設(shè)計(jì)上多處使用了句柄概念，很多操作均針對(duì)句柄，如回放、下載以及語(yǔ)音對(duì)講等。? 用戶登錄和注銷用戶在訪問(wèn)前端設(shè)備之前必須通過(guò)調(diào)用 CLIENT_Login ()登錄到前端設(shè)備上，登錄成功后返回一個(gè)全局唯一的句柄。此句柄就像一個(gè)會(huì)話通道，之后該用戶可通過(guò)此句柄訪問(wèn)前端設(shè)備。退出該會(huì)話時(shí)則通過(guò) CLIENT_Logout ()函數(shù)在前端設(shè)備上注銷此句柄以終止該會(huì)話通道的使用。建立連接與登錄是同步的。 ? 心跳功能在本開(kāi)發(fā)包中提供自動(dòng)心跳功能（20 秒一次心跳）當(dāng)設(shè)備斷開(kāi)能及時(shí)回調(diào)給客戶端。? 同步與異步異步以設(shè)置回調(diào)函數(shù)來(lái)響應(yīng)網(wǎng)絡(luò)數(shù)據(jù)，有些異步在設(shè)置后返回請(qǐng)求句柄，結(jié)束請(qǐng)求時(shí)將請(qǐng)求句柄提供給 SDK 以注銷相關(guān)資源。? SDK 提供協(xié)議探測(cè)和轉(zhuǎn)換? 回調(diào)函數(shù)一般都有 dwUser 參數(shù), 由用戶自定義需要的數(shù)據(jù), 一般用來(lái)傳入類對(duì)象指針, 方便回調(diào)處理在類中實(shí)現(xiàn),回調(diào)應(yīng)用都可以采取這種方式。 網(wǎng)絡(luò)客戶端 SDK 編程手冊(cè)第 10 頁(yè) 共 94 頁(yè) 典型調(diào)用順序A. 初始化 SDK 初始化 CLIENT_Init()B. SDK 功能設(shè)置或信息獲取設(shè)置連接等待時(shí)間 CLIENT_SetConnectTime()獲取 SDK 版本 CLIENT_GetSDKVersion()設(shè)置消息回調(diào) CLIENT_SetDVRMessCallBack()設(shè)置自定義疊加畫(huà)板 CLIENT_RigisterDrawFun()C. 登錄連接設(shè)備登錄設(shè)備 CLIENT_Login()開(kāi)始偵聽(tīng) 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è) 共 94 頁(yè)E. 實(shí)時(shí)監(jiān)視通道打開(kāi)監(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. 多畫(huà)面預(yù)覽通道打開(kāi)多畫(huà)面預(yù)覽 CLIENT_MultiPlay()停止多畫(huà)面預(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è) 共 94 頁(yè)H. 針對(duì)顯示圖像的操作(監(jiān)視/回放/多畫(huà)面預(yù)覽)抓圖 CLIENT_CapturePicture()碼流統(tǒng)計(jì) CLIENT_GetStatiscFlux()打開(kāi)音頻 CLIENT_OpenSound()設(shè)置音量 CLIENT_SetVolume()I. 遠(yuǎn)程控制遠(yuǎn)程升級(jí) CLIENT_StartUpgradeCLIENT_SendUpgradeCLIENT_StopUpgrade錄像控制 CLIENT_QueryRecordStateCLIENT_SetupRecordState系統(tǒng)校時(shí) CLIENT_QueryDeviceTimeCLIENT_SetupDeviceTimeIO 控制 CLIENT_QueryIOControlStateCLIENT_IOControlJ. 注銷斷開(kāi)設(shè)備停止偵聽(tīng) CLIENT_StopListen()斷開(kāi)連接 CLIENT_Logout()K. 釋放 SDK 資源SDK 退出 CLIENT_Cleanup()對(duì) D、E、F、G、H、I 中的功能大部分之間沒(méi)有調(diào)用先后順序,當(dāng)然對(duì)同一個(gè)功能還是應(yīng)該按先打開(kāi)再操作最后關(guān)閉的順序。 網(wǎng)絡(luò)客戶端 SDK 編程手冊(cè)第 13 頁(yè) 共 94 頁(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。?云臺(tái)控制擴(kuò)展命令typedef enum _EXTPTZ_ControlType{EXTPTZ_LEFTTOP = 0X20, // 左上EXTPTZ_RIGHTTOP , // 右上EXTPTZ_LEFTDOWN , // 左下EXTPTZ_RIGHTDOWN, // 右下EXTPTZ_ADDTOLOOP, // 加入預(yù)置點(diǎn)到巡航 巡航線路 預(yù)置點(diǎn)值EXTPTZ_DELFROMLOOP, // 刪除巡航中預(yù)置點(diǎn) 巡航線路 預(yù)置點(diǎn)值 EXTPTZ_CLOSELOOP, // 清除巡航 巡航線路EXTPTZ_STARTPANCRUISE, // 開(kāi)始水平旋轉(zhuǎn)EXTPTZ_STOPPANCRUISE, // 停止水平旋轉(zhuǎn)EXTPTZ_SETLEFTBORDER, // 設(shè)置左邊界EXTPTZ_RIGHTBORDER , // 設(shè)置右邊界EXTPTZ_STARTLINESCAN, // 開(kāi)始線掃 EXTPTZ_CLOSELINESCAN, // 停止線掃 網(wǎng)絡(luò)客戶端 SDK 編程手冊(cè)第 14 頁(yè) 共 94 頁(yè) EXTPTZ_SETMODESTART, // 設(shè)置模式開(kāi)始 模式線路 EXTPTZ_SETMODESTOP, // 設(shè)置模式結(jié)束 模式線路EXTPTZ_RUNMODE, // 運(yùn)行模式 模式線路EXTPTZ_STOPMODE, // 停止模式 模式線路EXTPTZ_DELETEMODE, // 清除模式 模式線路EXTPTZ_REVERSECOMM, // 翻轉(zhuǎn)命令EXTPTZ_FASTGOTO, // 快速定位 水平坐標(biāo) 垂直坐標(biāo) 變倍EXTPTZ_AUXIOPEN, // x34 輔助開(kāi)關(guān)開(kāi) 輔助點(diǎn)EXTPTZ_AUXICLOSE, // 0x35 輔助開(kāi)關(guān)關(guān) 輔助點(diǎn)EXTPTZ_OPENMENU = 0X36, // 打開(kāi)球機(jī)菜單EXTPTZ_CLOSEMENU , // 關(guān)閉菜單EXTPTZ_MENUOK, //菜單確定EXTPTZ_MENUCANCEL, //菜單取消EXTPTZ_MENUUP, //菜單上EXTPTZ_MENUDOWN, //菜單下EXTPTZ_MENULEFT, //菜單左EXTPTZ_MENURIGHT, //菜單右EXTPTZ_TOTAL, //最大命令值}EXTPTZ_ControlType。?IO 控制命令typedef enum _IOTYPE{ALARMINPUT = 1, //報(bào)警輸入ALARMOUTPUT = 2, //報(bào)警輸出}IOTYPE。?查詢狀態(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 //查詢硬盤(pán)狀態(tài)?錯(cuò)誤類型代號(hào) ，用于 GetLastError 函數(shù)的返回define _EC(x) (0x80000000|x)define NET_NOERROR 0 //沒(méi)有錯(cuò)誤def