接口说明
录像查询（跨天）
注意：
仅1078设备支持跨天查询
数据权限说明
只能查询登录账号已有权限的设备数据
请求示例
https://v7.cmsv8.com/StandardApiAction_getVideoHistoryFile.action?DevIDNO=013300000001&LOC=2&CHN=0&YEAR=2024&MON=12&DAY=01&RECTYPE=-1&FILEATTR=2&BEG=0&END=86399&ARM1=0&ARM2=0&RES=0&STREAM=0&STORE=0&YEARE=2024&MONE=12&DAYE=01&jsession=66d754dd7f41473dbd2
请求参数
| 参数名称 | 参数类型 | 必须 | 示例 | 参数含义 |
|---|---|---|---|---|
| jsession | string | 是 | 66d754dd7f41473dbd2 | 会话号 |
| DevIDNO | string | 是 | 013300000001 | 设备号,当查询服务器上的录像时，则表示车牌号 |
| LOC | number | 是 | 1 | 搜索位置:1表示终端设备,2表示存储服务器,4表示下载服务器 |
| CHN | number | 是 | 0 | 搜索通道(从0开始),0表示通道1，1表示通道2，-1表示所有通道 |
| YEAR | string | 是 | 2024 | 搜索年份 |
| MON | string | 是 | 12 | 搜索月份 |
| DAY | string | 是 | 01 | 搜索日期 |
| RECTYPE | number | 是 | 0 | 录像类型,0表示常规，1表示报警，-1表示所有 |
| FILEATTR | number | 是 | 0 | 文件类型:1表示图像;2表示录像 |
| BEG | number | 是 | 0 | 开始秒数,单位秒 （0 - 86399） |
| END | number | 是 | 100 | 结束秒数,单位秒 （0 - 86399） |
| ARM1 | number | 是 | 0 | 非1078设备填0,报警标识1,二进制对应的十进制整数,二进制位数报警,1紧急报警2超速报警3疲劳驾驶4预警,5GNSS模块发生故障,6GNSS模块未接或被剪断7GNSS天线短路8终端主电源欠压,9终端主电源掉电10终端LCD或者显示器故障11TTS模块故障,12摄像头故障19当天累计驾驶超时20超时停车21进出区域,22进出路线报警23路线行驶时间不足/过长24路线偏离报警25车辆VSS故障,26车辆油量异常27车辆被盗报警28车辆非法点火报警29车辆非法位移报警30碰撞侧翻报警 |
| ARM2 | number | 是 | 0 | 非1078设备填0,报警标识2,二进制对应的十进制整数,二进制位数报警,1视频信号丢失报警2视频信号遮挡报警3存储单元故障报警,4其他视频设备故障报警5客车超员报警6异常驾驶行为报警,7特殊报警录像达到存储阀值报警 |
| RES | number | 是 | 0 | 非1078设备填0,媒体类型 0:音视频,1:音频,2:视频,3:视频或者音视频 |
| STREAM | number | 是 | -1 | 非1078设备填0,码流类型 -1:主或子码流,0:主码流,1:子码流 |
| STORE | number | 是 | 0 | 非1078设备填0,存储类型 0:主或者灾备存储器,1:主存储器,2:灾备存储器 |
| LABEL | string | 否 | test | 标签 |
| YEARE | string | 否 | 2024 | 搜索结束年份,yeare,mone,daye都不为空时，跨天查询 |
| MONE | string | 否 | 12 | 搜索结束月份,yeare,mone,daye都不为空时，跨天查询 |
| DAYE | string | 否 | 01 | 搜索结束日期,yeare,mone,daye都不为空时，跨天查询 |
| NOTYPE | number | 否 | 1 | 值1不判断设备类型 |
返回参数
| 参数名称 | 参数类型 | 参数含义 | |
|---|---|---|---|
| result | number | 接口状态码，0为正常 其他为异常(详情参见:[错误码说明](/helpCenter/doc/index.html?isStudy=1&pageType=3&docId=1321&type=1 "错误码说明")) | |
| cmsserver | number | ||
| files | array | 文件信息 | |
| arm | number | 报警信息 当为报警录像时有效。 loc == 1时，状态位解析报警：bit0:紧急按钮报警, bit1:超速报警, bit2:低速报警,bit3:振动报警,bit4:温度报警,bit5:移动侦测报警,bit6:UPS剪线报警,bit7:碰撞侧翻报警,bit8:疲劳驾驶报警,bit9:IO_1,bit10:IO_2,bit11:IO_3,bit12:IO_4,bit13:IO_5,bit14:IO_6,bit15:IO_7,bit16:IO_8; loc != 1时，(arm & 0xFFFF)的值获取报警类型。2:紧急按钮报警,11:超速报警,3:振动报警,9:温度报警,15:移动侦测报警,49:疲劳驾驶报警,19:IO_1,20:IO_2,21:IO_3,22:IO_4,23:IO_5,24:IO_6,25:IO_7,26:IO_8; | |
| arm1 | number | 1078设备返回 报警标识1,二进制对应的十进制整数,二进制位数报警 1紧急报警2超速报警3疲劳驾驶4预警5GNSS模块发生故障 6GNSS模块未接或被剪断7GNSS天线短路8终端主电源欠压 9终端主电源掉电10终端LCD或者显示器故障11TTS模块故障 12摄像头故障19当天累计驾驶超时20超时停车21进出区域 22进出路线报警23路线行驶时间不足/过长24路线偏离报警25车辆VSS故障 26车辆油量异常27车辆被盗报警28车辆非法点火报警29车辆非法位移报警30碰撞侧翻报警 | |
| arm2 | number | 1078设备返回 报警标识2,二进制对应的十进制整数,二进制位数报警 1视频信号丢失报警2视频信号遮挡报警3存储单元故障报警 4其他视频设备故障报警5客车超员报警6异常驾驶行为报警 7特殊报警录像达到存储阀值报警 | |
| beg | number | 文件开始时间 单位秒，如3600=1点 | |
| chn | number | 设备通道（从0开始） 0表示通道1，1表示通道2 | |
| chnMask | number | 通道掩码 1个文件同时存储多个通道的视频时有效，按位表示，第0位表示录像文件中有通道1的录像，以此类推。先判断chnMask，若chnMask=0，再解析chn | |
| day | number | 日 | |
| mulChn | number | 如果mulChn不为0，显示mulChn按位取值得到的通道信息，如果mulChn为0，要判断下当前时间段，有哪些通道有录像信息 | |
| mulPlay | number | 当 mulPlay>0时,则可以进行多路录像回放 | |
| devIdno | string | 设备号 当查询服务器上的录像时，则表示车牌号 | |
| end | number | 文件结束时间 单位秒，如7200=2点，结束时间可能会大于86400，这个表示出现了跨天的情况 | |
| file | string | ||
| len | number | 文件大小（单位byte） | |
| loc | number | 文件位置 1表示终端设备，2表示存储服务器，4表示下载服务器 | |
| mon | number | 月 | |
| recing | number | 是否正在录像 0表示没有录像，1表示正在录像。 | |
| res | number | 1078设备返回 媒体类型 0:音视频,1:音频,2:视频,3:视频或者音视频 | |
| store | number | 1078设备返回 存储类型 0:主或者灾备存储器,1:主存储器,2:灾备存储器 | |
| stream | number | 如果为1不能进行文件下载，只能分段下载 | |
| svr | number | 服务器ID 当查找存储服务器和下载服务器上录像时有效。 | |
| type | number | 录像类型 0表示常规，1表示报警。 | |
| year | number | 年 使用时加上2000 | |
| mediaType | number | 多媒体类型 0表示图片，1表示视频 | |
| sourceId | number | 当为从设备下载时有效，表示对应任务表里面的ID | |
| label | string | 标签 | |
| DownTaskUrl | string | 分段下载URL,服务器录像返回空,需要用户填写的参数：jsession(必须)sbtm(默认开始时间)setm(默认结束时间)lab(默认为空) | |
| DownUrl | string | 直接下载URL,1078设备返回空,需要用户填写的参数：jsession(必须)SAVENAME(必须) | |
| PlaybackUrl | string | 远程回放URL,需要用户填写的参数：jsession(必须)PLAYBEG(默认开始时间)PLAYEND(默认结束时间) | |
| PlaybackUrlWs | string | 远程回放Websocket URL有PlaybackUrlWs，优先用 PlaybackUrlWs 播放，PlaybackUrlWs 不支持flash,需要用户填写的参数：jsession(必须)PLAYBEG(默认开始时间)PLAYEND(默认结束时间) | |
返回示例
a.录像查询
{
"result": 0,
"cmsserver":1,
"files":[
{
"arm": 0
"beg": 31044
"chn": 1
"chnMask": 0
"day": 11
"devIdno": "013300000001"
"end": 32842
"file": "H20100628-083724P2N2P0.264"
"len": 23211837
"loc": 1
"mon": 1
"mulChn": 0
"mulPlay": 0
"recing": 0
"svr": 0
"type": 0
"year": 10
"mediaType": 1
"sourceId": 1
"label": ""
"DownTaskUrl": "https://v7.cmsv8.com/StandardApiAction_addDownloadTask.action?jsession=&did=013300000001&fbtm=2024-12-10 08:37:24&fetm=2024-12-10 09:07:22&sbtm=2024-12-10 08:37:24&setm=2024-12-10 09:07:22&lab=&fph=H20100628-083724P2N2P0.264&vtp=0&len=23211837&chn=1&dtp=1"
"DownUrl": "https://v7.cmsv8.com:16604/3/5?DownType=3&jsession=&DevIDNO=013300000001&FLENGTH=23211837&FOFFSET=0&MTYPE=1&FPATH=H20100628-083724P2N2P0.264&SAVENAME="
"PlaybackUrl": "https://v7.cmsv8.com:16604/3/5?DownType=5&&jsession=DevIDNO=013300000001&FILELOC=1&FILESVR=0&FILECHN=1&FILEBEG=31044&FILEEND=32842&PLAYIFRM=0&PLAYFILE=H20100628-083724P2N2P0.264&PLAYBEG=31044&PLAYEND=32842&PLAYCHN=0"
"PlaybackUrlWs": "ws://v7.cmsv8.com:16604/3/5?DownType=5&&jsession=DevIDNO=013300000001&FILELOC=1&FILESVR=0&FILECHN=1&FILEBEG=31044&FILEEND=32842&PLAYIFRM=0&PLAYFILE=H20100628-083724P2N2P0.264&PLAYBEG=31044&PLAYEND=32842&PLAYCHN=0"
}
]
}
b. 1078录像查询
{
"result": 0,
"cmsserver":1,
"files":[
{
"arm": 0
"arm1": 0
"arm2": 0
"beg": 31044
"chn": 1
"chnMask": 0
"day": 11
"mulChn": 0
"mulPlay": 0
"devIdno": "500000"
"end": 32842
"file": "H20100628-083724P2N2P0.264"
"len": 23211837
"loc": 1
"mon": 1
"recing": 0
"res": 0
"store": 0
"stream": -1
"svr": 0
"type": 0
"year": 10
"mediaType": 1
"sourceId": 1
"label": ""
"DownTaskUrl": "https://v7.cmsv8.com/StandardApiAction_addDownloadTask.action?jsession=&did=013300000001&fbtm=2024-12-10 08:37:24&fetm=2024-12-10 09:07:22&sbtm=2024-12-10 08:37:24&setm=2024-12-10 09:07:22&lab=&fph=H20100628-083724P2N2P0.264&vtp=0&len=23211837&chn=1&dtp=1"
"DownUrl": ""
"PlaybackUrl": "https://v7.cmsv8.com:16604/3/5?DownType=5&jsession=&DevIDNO=013300000001&FILELOC=1&FILESVR=0&FILECHN=1&FILEBEG=31044&FILEEND=32842&PLAYIFRM=0&PLAYFILE=H20100628-083724P2N2P0.264&PLAYBEG=31044&PLAYEND=32842&PLAYCHN=0"
"PlaybackUrlWs": "ws://v7.cmsv8.com:16604/3/5?DownType=5&&jsession=DevIDNO=013300000001&FILELOC=1&FILESVR=0&FILECHN=1&FILEBEG=31044&FILEEND=32842&PLAYIFRM=0&PLAYFILE=H20100628-083724P2N2P0.264&PLAYBEG=31044&PLAYEND=32842&PLAYCHN=0"
}
]
}
