网络客户端SDK编程手册
位图文件名,当前只支持BMP位图
? 返回值:成功返回TRUE,失败返回FALSE ? 相关函数:CLIENT_RealPlay、
CLIENT_RealPlayEx、
CLIENT_PlayBackByRecordFile、CLIENT_PlayBackByRecordFileEx、CLIENT_PlayBackByTime、CLIENT_PlayBackByTimeEx
? 典型应用:对当前的显示画面进行瞬间抓图,无顺序要求
4.9 回放和下载
28. CLIENT_API BOOL CLIENT_QueryRecordFile(LONG lLoginID, int
nChannelId, int nRecordFileType, LPNET_TIME tmStart, LPNET_TIME tmEnd, char* pchCardid, LPNET_RECORDFILE_INFO nriFileinfo, int maxlen, int *filecount, int waittime=1200, bool bTime=false); ? 函数说明:查询录像文件 ? 参数说明:
lLoginID
CLIENT_Login的返回值
nChannelId
通道ID,从0开始 nRecordFileType
录像文件类型 0 所有录像文件 1 外部报警 2 动态检测报警 3 所有报警 4 卡号查询 5 组合条件查询 tmStart
录像开始时间 tmEnd
录像结束时间
pchCardid
卡号,只针对卡号查询有效 nriFileinfo
返回的录像文件信息,是一个NET_RECORDFILE_INFO结构数组 maxlen
nriFileinfo缓冲的最大长度;
filecount
返回的文件个数,属于输出参数最大只能查到缓冲满为止的录像记录;
第 37 页 共 93 页 网络客户端SDK编程手册
waittime
等待时间
bTime
是否按时间查(目前无效)
? 返回值:成功返回TRUE,失败返回FALSE
? 相关函数:CLIENT_Login、CLIENT_PlayBackByRecordFile、
CLIENT_PlayBackByRecordFileEx、CLIENT_PausePlayBackCLIENT_SeekPlayBack、CLIENT_StopPlayBackCLIENT_GetPlayBackOsdTime、CLIENT_StepPlayBackCLIENT_GetFramePlayBack、CLIENT_SetFramePlayBackCLIENT_SlowPlayBack、CLIENT_FastPlayBack
、、、、
? 典型应用:在回放之前需要先调用本接口查询录像记录,当根据输入的时间段
查询到的录像记录信息大于定义的缓冲区大小,则只返回缓冲所能存放的录像记录,可以根据需要继续查询
typedef void(CALLBACK *fDownLoadPosCallBack) (LONG lPlayHandle, DWORD dwTotalSize, DWORD dwDownLoadSize, DWORD dwUser);
29. CLIENT_API LONG CLIENT_PlayBackByRecordFile(LONG
lLoginID, LPNET_RECORDFILE_INFO lpRecordFile, HWND hWnd, fDownLoadPosCallBack cbDownLoadPos, DWORD dwUserData); ? 函数说明:网络回放,需要说明的是,用户登录一台设备后,每通道同一时间
只能播放一则录像,不能同时播放同一通道的多条记录。 ? 参数说明:
lLoginID
CLIENT_Login的返回值 lpRecordFile
录像文件信息, 当按时间播放是只需填充起始时间和结束时间, 其他项填0;
hWnd
回放窗口
cbDownLoadPos
进度回调函数 dwUserData
用户自定义数据
? 回调函数说明:
lPlayHandle
CLIENT_PlayBackByRecordFile的返回值
dwTotalSize
第 38 页 共 93 页 网络客户端SDK编程手册
指本次播放总大小,单位为KB dwDownLoadSize
指已经播放的大小,单位为KB,当其值为-1时表示本次回防结束 dwUser
用户数据,就是上面输入的用户数据
? 返回值:成功返回网络回放ID,失败返回0 ? 相关函数:CLIENT_Login、CLIENT_PausePlayBack,CLIENT_SeekPlayBack,
CLIENT_StopPlayBack、CLIENT_GetPlayBackOsdTime、
CLIENT_StepPlayBack、CLIENT_GetFramePlayBack、CLIENT_SetFramePlayBack、CLIENT_SlowPlayBack、CLIENT_FastPlayBack
? 典型应用:根据上面查询的记录,输入指定的显示窗口hWnd,调用本接口就可以播放了, 记录返回的播放ID,以下对本播放的控制都是要用此ID值,另外应用程序可以在此回调函数中处理和更新显示进度.
以下29、30、31为一组录像查询接口,和上面的录像查询接口独立
30. CLIENT_API LONG CALL_METHOD CLIENT_FindFile(LONG
lLoginID,int nChannelId,int nRecordFileType, char* cardid, LPNET_TIME time_start,LPNET_TIME time_end,bool bTime, int waittime); ? 函数说明:打开录像查询句柄 ? 参数说明:
lLoginID
CLIENT_Login的返回值
nChannelId
通道号,从0开始
nRecordFileType 录像文件类型 0 所有录像文件 1 外部报警 2 动态检测报警 3 所有报警 4 卡号查询 5 组合条件查询 Cardid
卡号,只针对卡号查询有效 Time_start
查询录像开始时间
第 39 页 共 93 页 网络客户端SDK编程手册
Time_end
查询录像结束时间
bTime
是否按时间查询(目前无效)
waittime
查询超时时间
? 返回值:成功返回查询句柄,失败返回0
? 相关函数:CLIENT_Login, CLIENT_FindNextFile, CLIENT_FindClose ? 典型应用:可以在回放之前先调用本接口查询录像记录,再调用
CLIENT_FindNextFile函数挨条返回录象记录用于播放,查询完毕可以调用CLIENT_FindClose关闭查询句柄。
31. CLIENT_API int CALL_METHOD CLIENT_FindNextFile(LONG
lFindHandle,LPNET_RECORDFILE_INFO lpFindData); ? 函数说明:查询下一条录像文件记录 ? 参数说明:
lFindHandle
CLIENT_FindFile的返回值
lpFindData
录象文件记录缓冲,用于输出查询到的录象文件记录
? 返回值:1:成功取回一条录象记录,0:录象记录已取完,-1:参数出错 ? 相关函数:CLIENT_FindFile
? 典型应用:调用本接口之前应先调用CLIENT_FindFile以打开查询句柄。
32. CLIENT_API BOOL CALL_METHOD CLIENT_FindClose(LONG
lFindHandle); ? 函数说明:关闭录象查询句柄 ? 参数说明:
lFindHandle
CLIENT_FindFile的返回值
? 返回值:成功返回TRUE,失败返回FALSE ? 相关函数:CLIENT_FindFile
? 典型应用:调用CLIENT_FindFile打开查询句柄,查询完毕后应调用本函数
以关闭查询句柄。
第 40 页 共 93 页