海康摄像头监控视频播放详解

2019.12.09 更新（重要！！！）

一，此博文及对应代码写于2018年初，基于海康SDK V5.3.3.2版本（当时最新版本），只适用于2019年前海康监控设备；（海康监控产品更新换代，旧版SDK不再适用于新产品。故老款设备监控视频可正常查看，新款无法查看）

二，近期已重新开发此功能，已兼容新/旧款设备，支持单路/多路实时监控，以及单路历史监控视频回放，且采用不同方案实现。详情如下：

1. 单路视频预览（使用xml布局SurfaceView控件）
2. 单路视频预览（动态new View 添加到 ViewGroup）
3. 多路视频预览（动态new View 添加到 ViewGroup）
4. 多路视频预览（使用RecyclerView）
5. 单路视频回放（选择时间段）
6. 多路视频预览集成示例-在指定ViewGroup显示（动态new View 添加到 ViewGroup）

部分效果图如下：

 

由于某些原因不便开源，有问题的朋友可私聊交流；

 

---

 本篇文章讲述的是基于海康SDK播放监控视频，包含以下几个方面：

• 播放海康视频用到的API详解；
• 播放海康视频实践过程详解；
• 播放海康视频Cordova插件封装；

github地址：https://github.com/fangxiaopeng/fxp-plugin-video，包含完整代码及详细注释，欢迎star or fork

 

最近项目上有海康监控视频播放需求，包括Android 和 IOS两个版本。今天讲讲Android上的实现过程，后面有空了再讲讲IOS。

 

思路：基于海康视频SDK，使用AsyncTask登录设备后，获取实时流音视频数据，解码显示到SurfaceView。通过startActivityForResult的resultCode设置回调。

 

以下为工程文件目录结构及效果截图：

 

 

下面分阶段讲监控视频播放过程及需要用到的API。

1，登录设备

调用以下方法登录设备：

public int NET_DVR_Login_V30(String sDvrIp, int iDvrPort, ava.lang.String sUserName, String sPassword, NET_DVR_DEVICEINFO_V30 DeviceInfo)

参数说明：

[in] sDvrIp          设备 IP 地址或静态域名
[in] iDvrPort        设备端口号
[in] sUserName       登录的用户名
[in] sPassword       用户密码
[out] DeviceInfo     设备信息

返回值：

 -1表示失败，其他值表示返回的用户ID值。该用户ID具有唯一性，后续对设备的操作都需要通过此ID实现。

 

这里需要讲下用于获取设备信息的NET_DVR_Login_V30类。

 新建NET_DVR_Login_V30类对象，作为登录设备的一个参数传入，登录成功后即可返回设备详细信息，包含以下信息：

sSerialNumber        设备序列号
byAlarmInPortNum     报警输入个数
byAlarmOutPortNum    报警输出个数
byDiskNum            硬盘个数
byDVRType            设备类型
byChanNum            设备模拟通道个数
byStartChan          模拟通道起始通道号
byAudioChanNum       设备语音通道数
byIPChanNum          设备最大数字通道个数，低 8 位
byZeroChanNum        零通道个数
wDevType             设备类型
byStartDChan         起始数字通道号
byHighDChanNum       数字通道个数，高 8 位

 

2，获取实时流音视频数据

 登录设备成功后，调用NET_DVR_RealPlay_V40 
方法获取实时流音视频数据。

public int NET_DVR_RealPlay_V40(int lUserID, NET_DVR_PREVIEWINFO previewInfo, RealPlayCallBack CallBack)

参数说明：

[in] lUserID     NET_DVR_Login_V30 的返回值
[in] previewInfo    预览参数，包括码流类型、取流协议、通道号等
[in] CallBack       码流数据回调函数

返回值：

-1 表示失败，其他值作为 NET_DVR_StopRealPlay 等函数的句柄参数。

这里需要重点讲下以下两个类：

（1）NET_DVR_PREVIEWINFO：用于设置预览参数。

可设置项如下：

lChannel          通道号，目前设备模拟通道号从 1 开始，数字通道的起始通道号一般从 33 开始，具体取值在登录接口返回
dwStreamType      码流类型:0-主码流，1-子码流，2-码流 3，3-虚拟码流，以此类推 dwLinkMode       连接方式:0- TCP 方式，1- UDP 方式，2- 多播方式，3- RTP 方式，4-RTP/RTSP，5-RSTP/HTTP
bBlocked          0- 非阻塞取流，1- 阻塞取流
bPassbackRecord   0-不启用录像回传，1-启用录像回传。ANR 断网补录功能，客户端和设备之间网络异常恢复之后自动将前端数据同步过来，需要设备支持。
byPreviewMode     预览模式:0- 正常预览，1- 延迟预览
byProtoType       应用层取流协议:0- 私有协议，1- RTSP 协议 
hHwnd             播放窗口的句柄，为 NULL 表示不解码显示

（2）RealPlayCallback：用于获取实时音视频数据。实现的以下接口

public interface RealPlayCallBack {
    public void fRealDataCallBack(int iRealHandle, int iDataType, byte[] pDataBuffer, int iDataSize); 
}

参数说明：

[out] iRealHandle        当前的预览句柄
[out] iDataType          数据类型
[out] pDataBuffer        存放数据的缓冲区指针
[out] iDataSize          缓冲区大小

3，解码播放实时流音视频

调用NET_DVR_RealPlay_V40 方法获取实时流音视频数据成功后，通过播放库进行解码显示。

实现RealPlayCallback接口的fRealDataCallback方法，拿到实时流音视频数据，调用以下方法解码播放。

private void processData(int iPlayViewNo, int iDataType, byte[] pDataBuffer, int iDataSize, int iStreamMode) {
        if (HCNetSDK.NET_DVR_SYSHEAD == iDataType) {
            if (m_iPort >= 0) {
                return;
            }
            m_iPort = Player.getInstance().getPort();
            if (m_iPort == -1) {
                Log.e(TAG, "getPort is failed with: " + Player.getInstance().getLastError(m_iPort));
                return;
            }
            Log.i(TAG, "getPort succ with: " + m_iPort);
            if (iDataSize > 0) {
                if (!Player.getInstance().setStreamOpenMode(m_iPort, iStreamMode)) //set stream mode
                {
                    Log.e(TAG, "setStreamOpenMode failed");
                    return;
                }
                if (!Player.getInstance().openStream(m_iPort, pDataBuffer, iDataSize, 2 * 1024 * 1024)) //open stream
                {
                    Log.e(TAG, "openStream failed");
                    return;
                }
                while (!m_bSurfaceCreated) {
                    try {
                        Thread.sleep(100);
                    } catch (InterruptedException e) {
                        // TODO Auto-generated catch block
                        e.printStackTrace();
                    }
                    Log.i(TAG, "wait 100 for surface, handle:" + iPlayViewNo);
                }

                if (!Player.getInstance().play(m_iPort, getHolder())) {
                    Log.e(TAG, "play failed,error:" + Player.getInstance().getLastError(m_iPort));
                    return;
                }
                if (!Player.getInstance().playSound(m_iPort)) {
                    Log.e(TAG, "playSound failed with error code:" + Player.getInstance().getLastError(m_iPort));
                    return;
                }
            }
        } else {
            if (!Player.getInstance().inputData(m_iPort, pDataBuffer, iDataSize)) {
                Log.e(TAG, "inputData failed with: " + Player.getInstance().getLastError(m_iPort));
            }
        }
    }

4，停止获取实时流音视频数据

 调用以下方法停止获取实时流：

public boolean NET_DVR_StopRealPlay(int iRealHandle)

参数说明：

[in] iRealHandle         预览句柄，NET_DVR_RealPlay_V40 的返回值

返回值：

 TRUE表示成功，FALSE表示失败。

 

5，停止本地播放
 停止获取实时流音视频数据后，还需要手动关闭本地解码播放。可调用以下方法：

    private void stopPlayer() {
        Player.getInstance().stopSound();
        if (!Player.getInstance().stop(this.m_iPort)) {
            Log.e(TAG, "stop is failed!");
            return;
        }
        if (!Player.getInstance().closeStream(this.m_iPort)) {
            Log.e(TAG, "closeStream is failed!");
            return;
        }
        if (Player.getInstance().freePort(this.m_iPort)) {
            this.m_iPort = -1;
            return;
        }
        Log.e(TAG, "freePort is failed!" + this.m_iPort);
    }

6，注销登录

 单个设备可同时连接的用户数量是有限制的，达到限制后其他用户无法再登录（登录返回错误码5）。所以我们不再预览时，应该注销登录。调用以下方法即可：

public boolean NET_DVR_Logout_V30 (int lUserID)

参数说明：

[in]lUserID        用户 ID 号，NET_DVR_Login_V30 的返回值

返回值：

TRUE 表示成功，FALSE表示失败。 

 

至此，海康摄像头监控视频实时预览过程算是讲完了。下面讲部分具体实现：

 

1，项目架构

 为了更好的支持后续功能拓展，也为了降低类的复杂度，提升代码可维护性，尽可能的秉持了单一职责原则和接口隔离原则。以下为部分类说明：

LoginAsyncTask.java            异步任务类登录设备
AsyncTaskExecuteListener.java  异步任务类执行结果监听接口
PlaySurfaceView.java           自定义SurfaceView播放视频
MonitorVedioActivity.java      界面交互Activity
MethodUtils.java               工具类
VideoInfo.java                 设备实体类

2，登录设备

 登录设备，然后根据登录返回信息获取实时流，这里用异步任务类再合适不过了。我是写了一个异步任务类配合接口完成设备

登录及登录结果获取功能，具体实现可查看github代码。

3，自动适配单路/多路视频，自定义播放列数

/**
     * 开始播放实时监控视频
     *
     * @param chanNum   通道数目
     * @param columnNum 展示列数
     */
    private void startPreview(int chanNum, int columnNum) {

        playView = new PlaySurfaceView[chanNum];
        // 建立frameLayout容纳所有通道视频画面
        FrameLayout videoLayout = new FrameLayout(this);
        for (int i = 0; i < chanNum; i++) {
            if (playView[i] == null) {
                // 第i通道SurfaceView
                playView[i] = new PlaySurfaceView(this);
                // 设置第i通道监控画面尺寸，单路时全屏播放，多路时分列4：3播放
                playView[i].setViewSize(metric.widthPixels / columnNum, columnNum == 1 ? metric.heightPixels : 3 * metric.widthPixels / (4 * columnNum));
                // 设置第i通道监控画面布局参数
                FrameLayout.LayoutParams videoItemParams = new FrameLayout.LayoutParams(LayoutParams.WRAP_CONTENT, LayoutParams.WRAP_CONTENT);
                videoItemParams.topMargin = i / columnNum * playView[i].getCurHeight();
                videoItemParams.leftMargin = i % columnNum * playView[i].getCurWidth();
                videoItemParams.gravity = Gravity.TOP | Gravity.LEFT;
                // 将第i通道SurfaceView添加到FrameLayout
                videoLayout.addView(playView[i], videoItemParams);
            }
            // 播放第i通道视频
            playView[i].startPreview(iLogId, i + iStartChan);
        }
        // 设置scrollView布局参数
        FrameLayout.LayoutParams scrollViewParams = new FrameLayout.LayoutParams(LayoutParams.WRAP_CONTENT, LayoutParams.WRAP_CONTENT);
        ScrollView scrollView = new ScrollView(this);
        // 将含有多通道视频画面的frameLayout添加到scrollView
        scrollView.addView(videoLayout);
        // 动态添加scrollView布局
        addContentView(scrollView, scrollViewParams);
        // 获取起始通道监控视频播放状态码
        iPlayId = playView[0].m_iPreviewHandle;
    }

4，获取实时流音视频数据

public void startPreview(int iLogId, int chanNum) {
        RealPlayCallBack realPlayCallBack = getRealPlayerCbf();
        if (realPlayCallBack == null) {
            Log.e(TAG, "fRealDataCallBack object is failed!");
            return;
        }
        Log.i(TAG, "preview channel:" + chanNum);
        NET_DVR_PREVIEWINFO netDVRPreviewInfo = new NET_DVR_PREVIEWINFO();
        // 通道号，模拟通道号从1开始，数字通道号从33开始，具体取值在登录接口返回
        netDVRPreviewInfo.lChannel = chanNum;
        // 码流类型
        netDVRPreviewInfo.dwStreamType = 1;
        // 连接方式，0-TCP方式，1-UDP方式，2-多播方式，3-RTP方式，4-RTP/RTSP，5-RSTP/HTTP
        // previewInfo.dwLinkMode = 5;
        // 0-非阻塞取流，1-阻塞取流
        netDVRPreviewInfo.bBlocked = 1;
        // 实时预览，返回值-1表示失败
        this.m_iPreviewHandle = HCNetSDK.getInstance().NET_DVR_RealPlay_V40(iLogId, netDVRPreviewInfo, realPlayCallBack);

        if (m_iPreviewHandle < 0) {
            Log.e(TAG, "NET_DVR_RealPlay is failed!Err:" + HCNetSDK.getInstance().NET_DVR_GetLastError());
        }
    }

5，解码播放实时流音视频

 见前面过程讲解部分，或github代码，不再赘述。

6，SurfaceView播放视频

 SurfaceView是View的子类，功能非常强大。它允许在其上添加层，允许其他线程更新视图对象，使用了双缓冲机制，非常适

合我们的需求。创建SurfaceView的时候需要实现SurfaceHolder.Callback接口，它可以用来监听SurfaceView的状态，比如：SurfaceView

的改变 、SurfaceView的创建 、SurfaceView 销毁等，我们可以在相应的方法中做一些操作。

 这里我实现了SurfaceHolder.Callback接口，并重写了以下几个方法：

@Override
public void surfaceCreated(SurfaceHolder paramSurfaceHolder) {
                videoSurfaceview.getHolder().setFormat(-3);
                if ((-1 != iPort) && (paramSurfaceHolder.getSurface().isValid()))
                    Player.getInstance().setVideoWindow(iPort, 0, paramSurfaceHolder);
            }

@Override
public void surfaceChanged(SurfaceHolder paramSurfaceHolder, int paramInt1, int paramInt2, int paramInt3) {

            }

@Override
public void surfaceDestroyed(SurfaceHolder paramSurfaceHolder) {
                if ((-1 != iPort) && (paramSurfaceHolder.getSurface().isValid()))
                    Player.getInstance().setVideoWindow(iPort, 0, null);
            }

注意：必须实现SurfaceHolder.Callback接口并重写以上方法，不然会出现诸如锁屏再进入或切换到后台再进入后黑屏问题。

7，获取错误信息

（1）返回最后操作的错误码NET_DVR_GetLastError

// 调用 NET_DVR_GetLastError 获取错误码，通过错误码判断出错原因
int errorCode = HCNetSDK.getInstance().NET_DVR_GetLastError();

错误码详见《设备网络编程指南（Android）》第4章。

 

至此，Android平台的海康视频播放功能开发完成了。下面讲讲封装为Cordova插件。

 

 我以前写过几篇封装Cordova插件的博文，业务需求虽不同，但方法是一样的，所以这里就不再重复写了。海康视频播放插件已上传到github，所有代码均有详细注释，github地址：https://github.com/fangxiaopeng/fxp-plugin-video。如果大家对Cordova插件开发有兴趣的话，可以看看我的另外几篇博文：

 Cordova插件开发（1）-Android插件开发详解

 Cordova插件开发（2）-Android插件安装包制作详解

 Cordova插件开发（3）-将Cordova插件发布到npm

 

这里需要讲的是将视频播放结果设置到js回调。

 

思路：以startActivityForResult的方式启动视频播放Avtivity，在视频播放Activity退出时设置resultCode并传递信息，

在onActivityResult回调中获取对应Activity传递的信息，通过callbackContext设置js回调。

 

下面是具体实现：

（1）在继承于CordovaPlugin的类中，以startActivityForResult的方式启动视频播放Avtivity

private void toMonitorVideoActivity(VideoInfo videoInfo) {
        Log.e(TAG, "toMonitorVideoActivity");

        Intent intent = new Intent(this.cordova.getActivity(), MonitorVedioActivity.class);
        Bundle bundle = new Bundle();
        bundle.putSerializable("videoInfo", videoInfo);
        intent.putExtras(bundle);
        if (this.cordova != null) {
            this.cordova.startActivityForResult((CordovaPlugin) this, intent, REQUEST_MonitorVideo);
        }
    }

（2）在视频播放Activity退出时设置resultCode并传递信息

    /**
     * 退出Activity，设置返回值
     *
     * @param activity  待退出activity
     * @param resultCode    返回码
     * @param msg   返回信息
     */
    public void quitActivity(Activity activity,int resultCode, String msg){
        Intent intent = new Intent();
        intent.putExtra("result",msg);
        activity.setResult(resultCode,intent);
        activity.finish();
    }

（3）在onActivityResult回调中获取对应Activity传递的信息

    @Override
    public void onActivityResult(int requestCode, int resultCode, Intent intent) {
        switch (requestCode){
            case REQUEST_HCVideo:
                Log.i(TAG,"back from HCVideoActivity");
                break;
            case REQUEST_MonitorVideo:
                Log.i(TAG,"back from MonitorVedioActivity");
                break;
        }
        setCallBack(resultCode,intent);
    }

（4）通过callbackContext设置js回调

    private void setCallBack(int resultCode, Intent intent){
        if (this.callbackContext != null){
            String resultMsg = intent.getExtras().getString("result");
            Log.i(TAG,"resultCode:" + resultCode);
            Log.i(TAG,"resultMsg:" + resultMsg);
            switch (resultCode){
                case RESULT_NORMAL:
                    Log.i(TAG,"RESULT_NORMAL");
                    callbackContext.success("success");
                    break;
                case RESULT_ERROR:
                    Log.e(TAG,"RESULT_ERROR");
                    callbackContext.error(resultMsg);
                    break;
            }
        }
    }

OK。

 

---

欢迎关注微信公众号交流讨论！