NVR硬件录像机web无插件播放方案功能实现之相关接口注意事项说明

该篇博文主要用来说明EasyNVR硬件录像回放版本的相关接口说明和调用的demo；

方便用户的二次开发和集成。

软件根目录会包含接口文档的，因此，本文主要是对一些特定接口的说明和接口实现功能的讲解以及部分demo的展示说明；

对应接口说明；

支持设备类型

由于获取NVR录像机的相关功能是通过SDK来实现功能的，因此，无法想EasyNVR配置摄像机一样，走一个标准的协议去完成相应的全部功能，因此，我们 都是 通过不同的 SDK来实现对应品牌的录像机的接入，我们 无法做到，满足全部的录像机接入，但是可以做到支持市面大多数主流录像机的接入。因此我们 也通过接口返回目前支持的摄像机的类型，方便用户后续的对应的功能的获取；

实现接口

• 接口：/api/v1/gethwnvrsupportlist

• 返回：200 OK

  {
      "EasyDarwin": {
          "Body": {
              "DeviceCount": "1",
              "Devices": [
                  {
                      "Id": 1,
                      "Name": "HIK_IPC_NVR"
                  }
              ]
          },
          "Header": {
              "CSeq": "1",
              "ErrorNum": "200",
              "ErrorString": "Success OK",
              "MessageType": "MSG_DS_HWNVR_GET_SUPPORTLIST_ACK",
              "Version": "v1"
          }
      }
  }
  

目前只是支持海康录像机，随着需求的变化，后续会不断增加的；

获取对应时间段录像信息

就接触到的客户反馈而言，大多数的客户都是直接了当的说明，只是希望获取到对应的时间段的录像信息，对于这种明明白白的需求，我们是必须要简简单单的实现的；

实现接口

• 接口:/api/v1/hwrecordplaystart
• 参数：

名称	含义	备注
id	设备号	NVR对应的设备号
channel	通道号	NVR对应的通道号
starttime	开始播放时间	精确到秒：20180328000000
endtime	结束播放时间	精确到秒：20180328235959

• 返回：

  {
  "EasyDarwin": {
      "Body": {
          "HLS": "/hls/nvr1_channel1_98960064/nvr1_channel1_98960064.m3u8",
          "Handle": "98960064",
          "RTMP": "rtmp://127.0.0.1:10935/hls/nvr1_channel1_98960064"
      },
      "Header": {
          "CSeq": "1",
          "ErrorNum": "200",
          "ErrorString": "Success OK",
          "MessageType": "MSG_DS_HWNVR_START_RECORD_PLAY_ACK",
          "Version": "v1"
      }
  }
  

• 操作：HLS表示HLS录像视频流，RTMP表示RTMP录像视频流，Handle表示流唯一标识

调用demo

/*
*param：当前播放通道号
*/
function recordPlayer(param){
        var rtmpport;//rtmp端口
        $.ajax(_url + "/hwrecordplaystart",{
            async : false,
            data : {
                id : deviceId,
                channel : param,
                starttime:recordDay+"000000",
                endtime:recordDay+"235959"
            }
        }).then(function(data){
            var ret = JSON.parse(data);
            handle = ret.EasyDarwin.Body.Handle;
            if(handle != 0){
                $("#playerPrompt").html("当前播放录像文件为：<div><span style='color:green'>通道号</span>：通道"+param+"</br>"+"<span style='color:green'>日&nbsp;&nbsp;&nbsp;&nbsp;期</span>："+recordDay+"</div>")
                $(".channel-title ul li span").remove();
                $(".see"+param).append("&nbsp;&nbsp;&nbsp;<span style='color:green'><i class='fa fa-eye'></i></span>")
                RecordTouch = setInterval(function() {
                    $.get(_url + "/hwrecordplaytouch", {
                        id: deviceId,
                        handle: handle
                    }, function(data) {
                        console.log(data);
                    })
                }, 30000);
            }
            $.ajax({
                url:_url + "/getbaseconfig",
                async:false,
                success : function(data){
                    var ret = JSON.parse(data);
                    rtmpport = ret.EasyDarwin.Body.NginxRTMPPort;
                }
            })
            // rtmp://127.0.0.1:10935/hls/nvr1_channel1_123045152//流地址 格式
            // /hls/nvr1_channel1_123045152/nvr1_channel1_123045152_live.m3u8//流地址 格式
            var IP = location.hostname;
            var urlid = "nvr"+deviceId+"_channel"+param+"_"+handle;
            var rtmpurl = "rtmp://"+IP+":"+rtmpport+"/hls/"+urlid;//rtmp地址
            var hlsurl =  location.protocol + "//" + location.host+"/hls/"+urlid+"/"+urlid+"_live.m3u8";//hls地址
            playerStream(rtmpurl)
        })
    }

注意：

成功调用改接口会放回一个RTMP流地址，但是并不完整，我们 需要 根据EasyNVR自身的rtmp端口，拼接出一个完整的RTMP；同时也会生成HLS流地址，根据自身需求，播放对应的地址来达到对应时间端录像的回放；

相信大家也注意到，在调用这个获取录像流地址时，我还一直在循环调用一个 “/api/v1/hwrecordplaytouch”接口，这是我们我来保证我们的流一直有人观看而设置的接口，默认是没30秒调用一次，如果没有调用，设备默认没有用户观看录像，将停止录像播放。这样有效的避免了用户直接关闭网页导致没有发送停止流播放接口而机器一直在输出流的尴尬行为，有效的节省消耗。

备注：

对应其他接口的使用，根据接口文档来就可以，需要注意的在上文也有所说明了；如果有什么具体的疑惑，可以直接联系相关人员；

---

获取更多：

关于EasyNVR

EasyNVR能够通过简单的网络摄像机通道配置，将传统监控行业里面的高清网络摄像机IP Camera、NVR等具有RTSP协议输出的设备接入到EasyNVR，EasyNVR能够将这些视频源的音视频数据进行拉取，转换为RTMP/HLS，进行全平台终端H5直播（Web、Android、iOS），并且EasyNVR能够将视频源的直播数据对接到第三方CDN网络，实现互联网级别的直播分发；

详细说明：http://www.easynvr.com

点击链接加入群【EasyNVR解决方案】：383501345