【正文】 NET_RECORDFILE_INFO, *LPNET_RECORDFILE_INFO。 //文件長度 NET_TIME starttime。 //本地顯示狀態(tài) 0正常,1不正常}NET_DEV_WORKSTATE,*LPNET_DEV_WORKSTATE。 //設(shè)備暫時不支持NET_DEV_CHANNELSTATE stChanStatic[MAX_CHANNUM]。 //硬盤的剩余空間DWORD dwStatus。 //客戶端連接的個數(shù), 暫時無效DWORD dwClientIP[MAX_LINK]。 //連接的信號狀態(tài),0正常,1 信號丟失BYTE byHardwareStatic。 //size:channelcount unsigned char *videolost。unsigned char diskerror[MAX_DISKNUM]。 //磁盤號 unsigned int startcluster。 //文件名 unsigned int size。 //分DWORD dwSecond。 //年DWORD dwMonth。 //DVR 硬盤個數(shù)BYTE byDVRType。 設(shè)備信息結(jié)構(gòu) ?設(shè)備結(jié)構(gòu)定義如下 typedef struct {BYTE sSerialNumber[SERIALNO_LEN]。 網(wǎng)絡(luò)客戶端 SDK 編程手冊第 13 頁 共 94 頁3 數(shù)據(jù)結(jié)構(gòu)定義 客戶端數(shù)據(jù)結(jié)構(gòu)?通用云臺控制命令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ù)置點 PTZ_POINT_SET_CONTROL, //設(shè)置 PTZ_POINT_DEL_CONTROL, //刪除 PTZ_POINT_LOOP_CONTROL, //點間輪循 PTZ_LAMP_CONTROL, //燈光雨刷}PTZ_ControlType。 ? 心跳功能在本開發(fā)包中提供自動心跳功能（20 秒一次心跳）當(dāng)設(shè)備斷開能及時回調(diào)給客戶端。? 用戶登錄和注銷用戶在訪問前端設(shè)備之前必須通過調(diào)用 CLIENT_Login ()登錄到前端設(shè)備上，登錄成功后返回一個全局唯一的句柄。通過特定接口，應(yīng)用層可以通過本 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))就可以了。必要的時候，可以轉(zhuǎn)單路監(jiān)視。設(shè)備管理 ：遠(yuǎn)程升級、遠(yuǎn)程重啟/關(guān)閉、設(shè)備參數(shù)配置（系統(tǒng)通用配置、報警布 /撤防設(shè)置、錄像配置、串口配置、圖像配置、日志管理、用戶管理、設(shè)備校時、動態(tài)檢測配置、網(wǎng)絡(luò)配置）等功能。我們將會定期更新手冊的內(nèi)容。本手冊可能包含技術(shù)上不準(zhǔn)確的地方或印刷錯誤，歡迎指正。 網(wǎng)絡(luò)客戶端軟件開發(fā)包主要包括業(yè)務(wù)操作和設(shè)備管理兩大部分： 業(yè)務(wù)操作 ：狀態(tài)偵聽、實時監(jiān)視、實時預(yù)覽、字符疊加、音頻控制、錄像回放和下載、數(shù)據(jù)保存、云臺控制、語音對講、透明串口、碼流統(tǒng)計等功能。所謂多路預(yù)覽，就是在一個通道上把所有通道的數(shù)據(jù)組織在一起傳輸，等同于多路同時監(jiān)視。本 SDK 能夠解決這個問題。? 操作句柄系統(tǒng)設(shè)計上多處使用了句柄概念，很多操作均針對句柄，如回放、下載以及語音對講等。建立連接與登錄是同步的。 網(wǎng)絡(luò)客戶端 SDK 編程手冊第 10 頁 共 94 頁 典型調(diào)用順序A. 初始化 SDK 初始化 CLIENT_Init()B. SDK 功能設(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()云臺控制 CLIENT_PTZControl() CLIENT_DHPTZControl()語音對講 CLIENT_StartTalk() CLIENT_SendTalkData_Custom() CLIENT_StopTalk()設(shè)置限流 CLIENT_SetMaxFlux()透明串口 CLIENT_CreateTransComChannel() CLIENT_SendTransComData() CLIENT_DestroyTransComChanne() 網(wǎng)絡(luò)客戶端 SDK 編程手冊第 11 頁 共 94 頁E. 實時監(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 編程手冊第 12 頁 共 94 頁H. 針對顯示圖像的操作(監(jiān)視/回放/多畫面預(yù)覽)抓圖 CLIENT_CapturePicture()碼流統(tǒng)計 CLIENT_GetStatiscFlux()打開音頻 CLIENT_OpenSound()設(shè)置音量 CLIENT_SetVolume()I. 遠(yuǎn)程控制遠(yuǎn)程升級 CLIENT_StartUpgradeCLIENT_SendUpgradeCLIENT_StopUpgrade錄像控制 CLIENT_QueryRecordStateCLIENT_SetupRecordState系統(tǒng)校時 CLIENT_QueryDeviceTimeCLIENT_SetupDeviceTimeIO 控制 CLIENT_QueryIOControlStateCLIENT_IOControlJ. 注銷斷開設(shè)備停止偵聽 CLIENT_StopListen()斷開連接 CLIENT_Logout()K. 釋放 SDK 資源SDK 退出 CLIENT_Cleanup()對 D、E、F、G、H、I 中的功能大部分之間沒有調(diào)用先后順序,當(dāng)然對同一個功能還是應(yīng)該按先打開再操作最后關(guān)閉的順序。?查詢狀態(tài)類型define DH_DEVSTATE_COMM_ALARM 0x0001 //查詢普通報警define DH_DEVSTATE_SHELTER_ALARM 0x0002 //查詢遮擋報警define DH_DEVSTATE_RECORDING 0x0003 //查詢錄象狀態(tài)define DH_DEVSTATE_DISK 0x0004 //查詢硬盤狀態(tài)?錯誤類型代號 ，用于 GetLastError 函數(shù)的返回define _EC(x) (0x80000000|x)define NET_NOERROR 0 //沒有錯誤define NET_ERROR 1 //未知錯誤define NET_SYSTEM_ERROR _EC(1) //Windows 系統(tǒng)出錯define NET_NETWORK_ERROR _EC(2) //網(wǎng)絡(luò)錯誤define NET_DEV_VER_NOMATCH _EC(3) //設(shè)備協(xié)議不匹配 網(wǎng)絡(luò)客戶端 SDK 編程手冊第 15 頁 共 94 頁define NET_INVALID_HANDLE _EC(4) //句柄無效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 初始化出錯define NET_SDK_UNINIT_ERROR _EC(9) //SDK 清理出錯define NET_RENDER_OPEN_ERROR _EC(10) //申請 render 資源出錯define NET_DEC_OPEN_ERROR _EC(11) //打開解碼庫出錯define NET_DEC_CLOSE_ERROR _EC(12) //關(guān)閉解碼庫出錯define NET_MULTIPLAY_NOCHANNEL _EC(13) //多畫面預(yù)覽中檢測到通道數(shù)為 0define NET_TALK_INIT_ERROR _EC(14) //錄音庫初始化失敗define NET_TALK_NOT_INIT _EC(15) //錄音庫未經(jīng)初始化define NET_TALK_SENDDATA_ERROR _EC(16) //發(fā)送音頻數(shù)據(jù)出錯define NET_REAL_ALREADY_SAVING _EC(17) //實時數(shù)據(jù)已經(jīng)處于保存狀態(tài)define NET_NOT_SAVING _EC(18) /