guoqingyan

本篇介绍海康威视摄像机通过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版本的有部分接口不一样

相关文章: