本篇介绍海康威视摄像机通过SDK开启关闭实时预览接口
下篇介绍实时预览的回调函数及解码库
测试环境:
系统:Centos 7
SDK:设备网络SDK Linux64
实时预览模块流程:
图中虚线框部分的模块是与预览模块相关,必须在启动预览后才能调用,这些模块之间是并列的 关系,各自完成相应的功能。
关于SDK初始化和设备登录可以看我上一篇博客
实时预览接口(NET_DVR_RealPlay_V40)
NativeLong NET_DVR_RealPlay_V40(NativeLong lUserID, NET_DVR_PREVIEWINFO lpPreviewInfo, FRealDataCallBack_V30 fRealDataCall, Pointer pUser);
实时预览接口需要设置回调函数(fRealDataCallBack_V30接口的实现类)
注意:该接口返回的视频数据流并不能直接使用,需要使用官方解码库或者第三方解码库才能得到图片帧数据
传入参数
1、lUserID (NET_DVR_Login_V40等登录接口的返回值)
2、lpPreviewInfo (预览参数)
3、fRealDataCallBack_V30 (码流数据回调函数)
4、pUser (用户数据)
返回参数
-1表示失败,其他值作为NET_DVR_StopRealPlay等函数的句柄参数
NET_DVR_StopRealPlay 停止实时预览接口
接口调用
/**
* 开始其实预览 设置实时流回调函数
*
* @param nativeLong
* @author 云深小麦
*/
private NativeLong startRealPlay(NativeLong nativeLong) {
HCNetSDK.NET_DVR_PREVIEWINFO previewInfo = new HCNetSDK.NET_DVR_PREVIEWINFO();
previewInfo.lChannel = new NativeLong(1);
previewInfo.dwStreamType = 0;
previewInfo.dwLinkMode = 0;
previewInfo.hPlayWnd = null;
previewInfo.bBlocked = false;
previewInfo.bPassbackRecord = true;
previewInfo.byPreviewMode = 0;
previewInfo.byProtoType = 1;
previewInfo.dwDisplayBufNum = 15;
previewInfo.write();
NativeLong realPlayV40 = HKNETSDK.NET_DVR_RealPlay_V40(nativeLong, previewInfo, cbRealData, null);
if (realPlayV40.intValue() < 0) {
log.error("streamServiceImpl.startRealPlay.NET_DVR_RealPlay_V40 error:{}", HKNETSDK.NET_DVR_GetLastError());
throw new StreamException(HKNETSDK.NET_DVR_GetLastError());
}
return realPlayV40;
}
NET_DVR_GetLastError:返回最后操作的错误码
建议没次调用SDK里的接口都打印一下这个接口,返回0代表没有错误,就怕打印别的
预览参数说明:NET_DVR_PREVIEWINFO
lChannel
通道号,目前设备模拟通道号从1开始,数字通道的起始通道号通过NET_DVR_GetDVRConfig(配置命令NET_DVR_GET_IPPARACFG_V40)获取(dwStartDChan)。
dwStreamType
码流类型:0-主码流,1-子码流,2-三码流,3-虚拟码流,以此类推
dwLinkMode
连接方式:0- TCP方式,1- UDP方式,2- 多播方式,3- RTP方式,4- RTP/RTSP,5- RTP/HTTP,6- HRUDP(可靠传输) ,7- RTSP/HTTPS,8- NPQ
hPlayWnd
播放窗口的句柄,为NULL表示不解码显示。
bBlocked
0- 非阻塞取流,1- 阻塞取流
若设为不阻塞,表示发起与设备的连接就认为连接成功,如果发生码流接收失败、播放失败等情况以预览异常的方式通知上层。在循环播放的时候可以减短停顿的时间,与NET_DVR_RealPlay处理一致。
若设为阻塞,表示直到播放操作完成才返回成功与否,网络异常时SDK内部connect失败将会有5s的超时才能够返回,不适合于轮询取流操作。
bPassbackRecord
是否启用录像回传:0-不启用录像回传,1-启用录像回传。ANR断网补录功能,客户端和设备之间网络异常恢复之后自动将前端数据同步过来,需要设备支持。
byPreviewMode
延迟预览模式:0- 正常预览,1- 延迟预览
byStreamID
流ID,为字母、数字和"_"的组合,lChannel为0xffffffff时启用此参数
byProtoType
应用层取流协议:0- 私有协议,1- RTSP协议。主子码流支持的取流协议通过登录返回结构参数NET_DVR_DEVICEINFO_V30的byMainProto、bySubProto值得知。设备同时支持私协议和RTSP协议时,该参数才有效,默认使用私有协议,可选RTSP协议。
byRes1
保留,置为0
byVideoCodingType
码流数据编解码类型:0- 通用编码数据,1- 热成像探测器产生的原始数据(温度数据的加密信息,通过去加密运算,将原始数据算出真实的温度值)
dwDisplayBufNum
播放库播放缓冲区最大缓冲帧数,取值范围:1、6(默认,自适应播放模式)、15,置0时默认为1
byNPQMode
NPQ模式:0- 直连模式,1-过流媒体模式
byRes
保留,置为0
备注
1、 dwStreamType(码流类型)、dwLinkMode(连接方式)、bPassbackRecord(录像回传)、byPreviewMode(延迟预览模式)、byStreamID(流ID)这些参数的取值需要设备支持。
2、 NET_DVR_RealPlay_V40支持多播方式预览(dwLinkMode设为2),不需要传多播组地址,底层自动从设备获取已配置的多播组地址(NET_DVR_NETCFG_V50中的参数struMulticastIpAddr)并以该多播组地址实现多播。
3、 码流类型包含主码流、子码流、三码流、事件码流和虚拟码流等,
4、 当dwLinkMode == 7的时候,同时byProtoType == 1的时候,表示RTP over HTTPS预览。
停止实时预览(NET_DVR_StopRealPlay)
传入参数
1、lRealHandle(NET_DVR_RealPlay或者NET_DVR_RealPlay_V30的返回值)
返回参数
true 表示成功,false 表示失败。
接口调用
/**
* 停止实时预览
*
* @return nativeLong
* @author 云深小麦
*/
private void stopRealPlay(NativeLong nativeLong) {
boolean response = HKNETSDK.NET_DVR_StopRealPlay(nativeLong);
if (!response) {
log.info("streamServiceImpl.stopRealPlay.NET_DVR_StopRealPlay error:{}", HKNETSDK.NET_DVR_GetLastError());
}
}
代码写的太乱,我还在整理中。。。
注意:so动态库是linux版本的,windows版本的有部分接口不一样