接口说明

查询单个通道录像存在状态

前置条件

通道须视频通道

接口配套版本信息

智能物联综合管理平台iConnection Center V5.0.5及以上版本
视频业务系统V1.0.1及以上版本

接口版本

1.0.0

接口URL

/evo-apigw/admin/API/SS/Record/GetChannelMonthRecordStatus

请求Method

POST

数据提交格式

application/json

请求参数

其他字段无需关心

请求参数示例

{
    "data":    {
        "recordSource":    "3",
        "channelId":    "1000002$1$0$0",
        "month":    "202210"
    }
}

返回参数示例

ChannelMonthRecordStatusInfo

返回参数示例

• 返回参数结构与其他请求地址包含**/evo-xxxx/**的有差异，请知悉

{
    "code": 1000,
    "desc": "Success",
    "data": {
        "days": "1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0"
    }
}

接口说明

根据通道编码、录像来源、开始时间和结束时间等条件查询录像信息
录像文件是按照文件存储的，每个文件均有开始与结束时间，录像回放不支持跨文件（时间范围需在录像信息区间内），因此需先查询录像信息再获取录像回放流地址

前置条件

需配置录像计划 客户端时间区间内录像回放正常播放

接口配套版本信息

智能物联综合管理平台iConnection Center V5.0.5及以上版本
视频业务系统V1.0.1及以上版本

接口版本

1.0.0

接口更新说明

无

接口URL

/evo-apigw/admin/API/SS/Record/QueryRecords

请求类型

POST

数据格式

application/json

请求参数

请求参数示例

{
    "data": {
        "channelId":    "1000018$1$0$0",
        "recordSource":    "3",
        "startTime":    "1642559287",
        "endTime":    "1642645687",
        "streamType":    "0",
        "recordType":    "0"
    }
}

返回参数

返回参数示例（成功）

{
    "code": 1000,
    "desc": "Success",
    "data": {
        "records": [
            {
                "channelId": "1000018$1$0$0",
                "recordSource": "3",
                "recordType": "1",
                "startTime": "1642559426",
                "endTime": "1642559436",
                "recordName": "lijy_media_42/2022/01/19/183026_183036_1_0_1.dav",
                "fileLength": "7617",
                "planId": "0",
                "ssId": "1001",
                "diskId": "1642559426-1642559436",
                "streamId": "42",
                "forgotten": "0",
                "streamType": "6"
            }
        ]
    }
}

返回参数示例（失败）

{
  "code": 1001,
  "desc": "Failed"
}

接口说明

获取报警录像

前置条件

配置报警预案，联动录像

接口配套版本信息

智能物联综合管理平台iConnection Center V5.0.5及以上版本
视频业务系统V1.0.1及以上版本

接口版本

1.0.0

接口URL

/evo-apigw/admin/API/SS/Record/GetAlarmRecords

请求Method

POST

数据提交格式

application/json

请求参数

AlarmInfo

其他字段无需关心

请求参数示例

{
    "clientType":    "WINPC",
    "clientMac":    "30:9c:23:79:40:08",
    "clientPushId":    "",
    "project":    "PSDK",
    "method":    "SS.Record.GetAlarmRecords",
    "data":    {
        "alarmCode":    "{CC84DA5A-6B7D-4D7C-8447-1D7DC27EAE81}",
        "optional":    "/admin/API/SS/Record/GetAlarmRecords?token=4857b6fa9a6e4677affb6ef366b635b3"
    }
}

返回参数示例

AlarmRecordInfo

RecordVO

返回参数示例

• 返回参数结构与其他请求地址包含**/evo-xxxx/**的有差异，请知悉

{
  "code": 1000,
  "desc": "Success",
  "data": {
    "records": [
      {
        "channelId": "1004502$1$0$0",
        "recordSource": "3",
        "recordType": "6",
        "startTime": "1641350103",
        "endTime": "1641350109",
        "recordName": "huxiaolong_media_2542/2022/01/05/183421_6.dav",
        "fileLength": "87296",
        "planId": "0",
        "ssId": "1001",
        "diskId": "1641350103-1641350109",
        "streamId": "2542",
        "forgotten": "0",
        "streamType": "1",
        "videoRecordType": "82"
      }
    ]
  }
}

接口说明

根据通道编码和录像段文件名称等条件获取对应录像的RTSP流地址
中心录像存储推荐使用以文件形式回放录像
调此接口前需调用查询录像信息或查询报警录像获取录像信息，保证入参时间在录像时间内，跨文件可能无法播放

前置条件

客户端保证有录像、正常播放
端口必须通
    wsplayer对接：ws:9320端口，wss:9322端口
    dhplayer对接：固定端口9320

接口配套版本信息

智能物联综合管理平台iConnection Center V5.0.5及以上版本
视频业务系统V1.0.1及以上版本

接口版本

1.0.0

接口更新说明

无

接口URL

/evo-apigw/admin/API/SS/Playback/StartPlaybackByFile

请求类型

POST

数据格式

application/json

请求参数

请求参数示例

{
  "data": {
    "channelId": "1000018$1$0$0",
    "recordSource": "3",
    "startTime": "1642559426",
    "endTime": "1642559436",
    "streamType": "1",
    "recordType": "1",
    "fileName": "lijy_media_42/2022/01/19/183026_183036_1_0_1.dav",
    "ssId": "1001",
    "diskId": "1642559426-1642559436",
    "streamId": "42"
  }
}

返回参数

返回参数示例（成功）

{
    "code": 1000,
    "desc": "Success",
    "data": {
        "url": "rtsp://10.55.36.202:9320/playback/center/44",
        "session": "44",
        "protocol": "0",
        "token": "44"
    }
}

返回参数示例（失败）

{
  "code": 1001,
  "desc": "Failed"
}

demo下载参考支持与服务->资源中心->资源下载下的开发demo页

接口说明

根据通道编码、开始时间和结束时间等条件获取对应时间段录像的RTSP流地址
设备录像存储推荐使用以时间形式回放录像
调此接口前需调用查询录像信息获取录像信息，保证入参时间在录像时间内，跨文件可能无法播放

前置条件

客户端保证有录像、正常播放
端口必须通
    wsplayer对接：ws:9320端口，wss:9322端口
    dhplayer对接：固定端口9320

接口配套版本信息

智能物联综合管理平台iConnection Center V5.0.5及以上版本
视频业务系统V1.0.1及以上版本

接口版本

1.0.0

接口更新说明

无

接口URL

/evo-apigw/admin/API/SS/Playback/StartPlaybackByTime

请求类型

POST

数据格式

application/json

请求参数

请求参数示例

{
  "data": {
    "channelId": "1000018$1$0$0",
    "recordSource": "2",
    "startTime": "1642559426",
    "endTime": "1642559436",
    "streamType": "1",
    "recordType": "1"
  }
}

返回参数

返回参数示例（成功）

{
    "code": 1000,
    "desc": "Success",
    "data": {
        "url": "rtsp://10.55.36.202:9320/playback/center/44",
        "session": "44",
        "protocol": "0",
        "token": "44"
    }
}

返回参数示例（失败）

{
  "code": 1001,
  "desc": "Failed"
}

demo下载参考支持与服务->资源中心->资源下载下的开发demo页

接口说明

获取某视频通道的HLS和RTMP形式的录像回放流地址

接口配套版本信息

智能物联综合管理平台iConnection Center V5.0.12及以上版本
视频业务系统V1.1.2及以上版本

接口版本

1.0.0

接口更新说明

无

接口URL

/evo-apigw/admin/API/video/stream/record

• 注意：后端仅进行了URL的拼接工作，如果通过VLC播放失败，需要开发人员协助进行相关问题排查
• rtmp录像拉流接口仅支持H264编码模式，不能播放时请先确认设备的编码模式
• hlss表示使用https协议的HLS

请求类型

POST

数据格式

application/json

请求参数

请求参数示例

{
  "data": {
    "channelId": "1000018$1$0$0",
    "streamType": "1",
    "type": "hls",
    "recordType": "1",
    "beginTime": "2022-1-18 11:10:11",
    "endTime": "2022-1-20 11:10:11",
    "recordSource": "3"
  }
}

返回参数

返回参数示例（hls拉流成功）

{
    "code": 1000,
    "desc": "Success",
    "data": {
        "url": "http://10.35.239.81:7086/vod/center/cameraid/1000018%240/substream/1/recordtype/1/totallength/91439/begintime/1642475411/endtime/1642648211.m3u8"
    }
}

返回参数示例（rtmp拉流成功）

 {
   "code": 1000,
   "desc": "Success",
   "data": {
     "url": "rtmp://10.35.239.81:1975/vod/center/cameraid=1000018%240;substream=1;recordtype=1;begintime=1642475411;endtime=1642648211"
   }
 }

返回参数示例（未查询到录像）

{
    "code": 2239,
    "desc": "The record was null."
}

返回参数示例（失败）

{
  "code": 1001,
  "desc": "Failed"
}

demo下载参考支持与服务->资源中心->资源下载下的开发demo页

播放示例说明

• 接口返回url需拼接?token=鉴权认证接口返回的access_token，若要取消拼接token，参考FAQHLS/FLV/RTMP取消拼接token配置;

• 设备编码模式必须是H264;

• https播放需提供你安全证，按照HLS/FLV拉流https配置

• 无法播放参考FLV无法播放排查步骤

• 友商私有协议接入播放参考友商设备支持播放配置

接口配套版本信息

智能物联综合管理平台iConnection Center V5.0.12及以上版本
视频业务系统V1.1.2及以上版本

前置条件

7086/7096端口必须通

录像拼接规则

• 中心录像拼接规则

http(s)://[服务IP]:[服务端口]/vod/center/cameraid/[设备编码]%24[通道号]/substream/[码流类型]/recordtype/[中心录像类型]/totallength/[实际总录像时长]/begintime/[开始时间]/endtime/[结束时间].m3u8?token=鉴权token

设备录像拼接规则

http(s)://[服务IP]:[服务端口]/vod/device/cameraid/[设备编码]%24[通道号]/substream/[码流类型]/recordtype/[设备录像类型]/totallength/[实际总录像时长]/begintime/[开始时间]/endtime/[结束时间].m3u8?token=鉴权token

字段说明

[服务IP]：MES所在服务器的ip地址，若MES是分布式部署的话，IP为MESGW服务所在服务器的IP
[服务端口]：MES服务监听的http端口，默认7086，https端口是7096，若MES是分布式部署的话，端口为MESGW服务监听的Port
[设备编码]：通道编码第一个$前的内容，做下urlencode，例如通道编编码：1000001$1$0$1，设备编码是1000001；通道编码：1000001@001$1$0$1，则设备编码是1000001@001
[通道号]:通道编码最后一个$的数字，例如通道编编码：1000001$1$0$50，通道号是50；通道编码：1000001@001$1$0$46，则通道号是46
两者间以“%40”即“@”分隔 %24代表符号“$”，后面的0代表通道1（从0开始） [码流类型]：1表示主码流，2表示辅码流
[实际总录像时长] ：向SS查询到的实际总录像长度，单位秒，结束时间-开始时间
[中心录像类型]：1表示普通录像；2表示报警录像；81表示补录录像；82表示报警预录录像
[设备录像类型]：固定值0
[开始时间] 和 [结束时间] ：录像块的开始和结束时间，int类型表示的，单位秒；开始时间必须大于等于在实际录像文件的开始时间，结束时间必须小于等于在实际录像文件的结束时间，startTime与endTime不能跨文件
鉴权token:鉴权认证接口返回的access_token，若要取消拼接token，参考FAQHLS/FLV/RTMP取消拼接token配置中的HLS修改配置;

中心录像http流地址示例

http://10.35.51.112:7086/vod/center/cameraid/1000221%2450/substream/1/recordtype/1/totallength/300/begintime/1508774400/endtime/1508774700.m3u8?token=1:2cfa8e9b-e6c7-44d1-a676-6ae1cb9971e0

中心录像https流地址示例

https://20.2.42.185:7096/vod/center/cameraid/1000221%2450/substream/1/recordtype/1/totallength/300/begintime/1508774400/endtime/1508774700.m3u8?token=1:2cfa8e9b-e6c7-44d1-a676-6ae1cb9971e0

设备录像http流地址示例

http://10.35.51.112:7086/vod/device/cameraid/1000221%2450/substream/1/recordtype/0/totallength/300/begintime/1508774400/endtime/1508774700.m3u8?token=1:2cfa8e9b-e6c7-44d1-a676-6ae1cb9971e0

设备录像https流地址示例

https://10.35.51.112:7096/vod/device/cameraid/1000221%2450/substream/1/recordtype/0/totallength/300/begintime/1508774400/endtime/1508774700.m3u8?token=1:2cfa8e9b-e6c7-44d1-a676-6ae1cb9971e0

http取消token鉴权流地址示例

参考FAQHLS/FLV/RTMP取消拼接token配置中的HLS修改配置; http://10.35.51.112:7086/vod/center/cameraid/1000221%2450/substream/1/recordtype/1/totallength/300/begintime/1508774400/endtime/1508774700.m3u8

demo下载参考支持与服务->资源中心->资源下载下的开发demo页

播放示例说明

• 接口返回url需拼接?token=鉴权认证接口返回的access_token，若要取消拼接token，参考FAQHLS/FLV/RTMP取消拼接token配置;

• 设备编码模式必须是H264;

• https播放需提供你安全证，按照HLS/FLV拉流https配置

• 无法播放参考FLV无法播放排查步骤

• 友商私有协议接入播放参考友商设备支持播放配置

接口配套版本信息

智能物联综合管理平台iConnection Center V5.0.12及以上版本
视频业务系统V1.1.2及以上版本

前置条件

1975端口必须通

中心录像拼接规则

rtmp://[服务IP]:1975/vod/center/cameraid=[设备编码]%24[通道号];substream=[码流类型];recordtype=[中心录像类型];begintime=[开始时间];endtime=[结束时间];token=鉴权token

设备录像拼接规则

rtmp://[服务IP]:1975/vod/device/cameraid=[设备编码]%24[通道号];substream=[码流类型];recordtype=[设备录像类型];begintime=[开始时间];endtime=[结束时间];token=鉴权token

字段说明

[服务IP]：MES所在服务器的ip地址，若MES是分布式部署的话，IP为MESGW服务所在服务器的IP
[服务端口]：MES服务监听的http端口，默认7086，https端口是7096，若MES是分布式部署的话，端口为MESGW服务监听的Port
[设备编码]：通道编码第一个$前的内容，做下urlencode；例如通道编编码：1000001$1$0$48，设备编码是1000001；通道编码：1000001@001$1$0$1，则设备编码是1000001@001
[通道号]:通道编码最后一个$的数字，例如通道编编码：1000001$1$0$48，通道号是48；通道编码：1000001@001$1$0$50，则通道号是50
两者间以“%40”即“@”分隔 %24代表符号“$”，后面的0代表通道1（从0开始）
[码流类型]：1表示主码流，2表示辅码流
[中心录像类型]：1表示普通录像；2表示报警录像；81表示补录录像；82表示报警预录录像
[设备录像类型]：固定值0
[开始时间] 和 [结束时间] ：录像块的开始和结束时间，int类型表示的，单位秒；开始时间必须大于等于在实际录像文件的开始时间，结束时间必须小于等于在实际录像文件的结束时间，startTime与endTime不能跨文件
鉴权token:鉴权认证接口返回的access_token，若要取消拼接token，参考FAQHLS/FLV/RTMP取消拼接token配置中的HLS修改配置;

中心录像拉流拼接示例

rtmp://10.35.239.81:1975/vod/center/cameraid=1000018%240;substream=1;recordtype=1;begintime=1642475411;endtime=1642648211;token=1:2cfa8e9b-e6c7-44d1-a676-6ae1cb9971e0

设备录像拼接示例

rtmp://10.35.239.81:1975/vod/device/cameraid=1000018%240;substream=1;recordtype=0;begintime=1642475411;endtime=1642648211;token=1:2cfa8e9b-e6c7-44d1-a676-6ae1cb9971e0

http取消token鉴权流地址示例

参考FAQHLS/FLV/RTMP取消拼接token配置中的HLS修改配置; rtmp://10.35.239.81:1975/vod/center/cameraid=1000018%240;substream=1;recordtype=1;begintime=1642475411;endtime=1642648211

播放示例说明

• 接口返回url需拼接?token=鉴权认证接口返回的access_token，若要取消拼接token，参考FAQHLS/FLV/RTMP取消拼接token配置;

• 设备编码模式必须是H264;

• 无法播放参考FLV无法播放排查步骤

• 友商私有协议接入播放参考友商设备支持播放配置

接口配套版本信息

智能物联综合管理平台iConnection Center V5.0.6及以上版本
仅支持MP4格式录像下载

前置条件

安装录像下载服务包，可联系区域同事运维中心升级部署
纯软版本下载
国产化版本下载
最多支持5路同时下载

接口URL

/evo-apigw/evo-httpnode/vod/cam/download.mp4

请求类型

GET

数据格式

-

请求参数

注意参数顺序，不能错乱

请求参数示例

https://10.55.36.150/evo-apigw/evo-httpnode/vod/cam/download.mp4?vcuid=1000006%2425&subtype=1&starttime=2023_10_23_14_48_36&endtime=2023_10_23_15_2_57&videoType=3&token=1:drAtL4KDVMoj9fITDvE98gbzP4N1QbYp&recordType=1

示例代码

java示例代码