NET_DVR_PlayBackByTime_V40
按流ID和时间回放录像文件。
LONG NET_DVR_PlayBackByTime_V40(
LONG lUserID,
LPNET_DVR_VOD_PARA pVodPara
);
Parameters
- lUserID
- [in] NET_DVR_Login_V40等登录接口的返回值
- pVodPara
- [in] 查找条件
Return Values
-1表示失败,其他值作为NET_DVR_StopPlayBack等函数的参数。接口返回失败请调用NET_DVR_GetLastError获取错误码,通过错误码判断出错原因。
Remarks
- 该接口指定了当前要播放的录像文件,调用成功后,还必须调用NET_DVR_PlayBackControl_V40接口的开始播放控制命令(NET_DVR_PLAYSTART)才能实现回放。
当回放的是按事件搜索出的录像文件时,由于每个文件都会有预录和延迟的部分,因此在设置本接口的开始和结束时间参数时可以适当提前开始时间和延长结束时间。
建议值:最多10分钟,最少5秒。
在调用该接口成功后,可以通过接口NET_DVR_SetPlayDataCallBack_V40注册回调函数,捕获录像的码流数据并自行处理。
- 该接口如果传入了播放句柄而加载播放库失败,实际上失败的,但是接口会返回成功。错误会通过异常方式进行回调(NET_DVR_SetExceptionCallBack_V30),异常消息类型为:EXCEPTION_PLAYBACK,具体错误需要在异常消息回调函数中调用NET_DVR_GetLastError获取。
- Linux版本SDK开发,回放接口直接传入有效窗口句柄,在回放过程中,改变窗口大小时,需要调用NET_DVR_PlayBackControl_V40(命令:NET_DVR_CHANGEWNDRESOLUTION)通知底层播放库去获取窗口大小。Windows系统下开发不需要调用相关接口,可以自适应。
- ISAPI协议下,并不完全支持私有协议的相关功能,目前ISAPI协议下,该接口支持的回放控制命令如下:开始播放(NET_DVR_PLAYSTART)、暂停播放(NET_DVR_PLAYPAUSE)、恢复播放(NET_DVR_PLAYRESTART)、快放(NET_DVR_PLAYFAST)、慢放(NET_DVR_PLAYSLOW)、正常速度播放(NET_DVR_PLAYNORMAL)。其他不支持
See Also
NET_DVR_PlayBackControl_V40 NET_DVR_StopPlayBack NET_DVR_SetPlayDataCallBack_V40
NET_DVR_Login NET_DVR_Login_V40
Reference Interface
该接口扩展源于
NET_DVR_PlayBackByTime