海康摄像头监控视频播放详解 |
您所在的位置：网站首页 › 监控怎么正常播放 › 海康摄像头监控视频播放详解 |
海康摄像头监控视频播放详解
|
2019.12.09 更新（重要！！！） 一，此博文及对应代码写于2018年初，基于海康SDK V5.3.3.2版本（当时最新版本），只适用于2019年前海康监控设备；（海康监控产品更新换代，旧版SDK不再适用于新产品。故老款设备监控视频可正常查看，新款无法查看） 二，近期已重新开发此功能，已兼容新/旧款设备，支持单路/多路实时监控，以及单路历史监控视频回放，且采用不同方案实现。详情如下： 单路视频预览（使用xml布局SurfaceView控件）单路视频预览（动态new View 添加到 ViewGroup）多路视频预览（动态new View 添加到 ViewGroup）多路视频预览（使用RecyclerView）单路视频回放（选择时间段）多路视频预览集成示例-在指定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。
欢迎关注微信公众号交流讨论！
|
【本文地址】
今日新闻 |
点击排行 |
|
推荐新闻 |
图片新闻 |
|
专题文章 |