海康威视摄像机Java SDK拉流（二）开启关闭实时预览

上一篇：海康威视Java SDK拉流（一）初始化SDK

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