getRecordList.lua
[返回首页]

API说明

获得指定磁盘上的所有录像文件列表

参数

HTTP提交参数:GET; POST

通过HTTP测试该API调用 (URL):

Device
字符串 (必需参数)

要获取录像文件列表的磁盘设备号(请参考 getDisks.lua

测试值:

Stream
字符串

可选。指定要获取录像文件列表的码流。如未指定,或值为空,表示获取所有码流的录像文件列表。

main

主码流

sub

子码流

all

全部

测试值:

返回

返回JSON格式的结果。该JSON数据的格式如下:

{
/*对象*/

"Result":
数值

200表示OK, 其它错误码含义类似于HTTP Response.

"Status":
"字符串"

状态消息。反馈API执行的结果状态,如有错误,将描述出错的原因。

"Data": [
/*数组*/

数组。每一项代表一个录像序列信息。这些信息格式如下:

{
/*对象*/

"Stream":
"字符串"

当前序列对应的码流

main

主码流

sub

子码流

"RecordDevice":
"字符串"

录像磁盘的设备号

"SequenceID":
"字符串"

录像序列号。

每一次录像称为一个“序列”,考虑到文件切割的情况,一个序列中可能有多个录像文件。SequenceID代表该序列的唯一编号。
"RecordPath":
"字符串"

录像文件存放位置(目录)。该目录同时映射在HTTP的访问目录下。

"Files": [
/*数组*/

当前序列中的所有文件清单,数组。每一个元素为以下格式:

{
/*对象*/

"Filename":
"字符串"

文件名

"Size":
整数

文件大小(KB)

}
]
"TotalSize":
整数

当前序列所有文件的大小(KB)

"TotalDuration":
整数

当前序列的持续录像时间(秒)

"StartTime":
"字符串"

整个序列的开始录像时间(yyyy-mm-dd hh:nn:ss)

"Format":
"字符串"

录像文件格式

ts

TS文件格式

mp4

MP4文件格式(暂不支持)

"IsCurrent":
整数

是否为当前正在录像的序列。1表示True, 0表示False

}
]
}

说明

录像文件的完整访问地址是 "RecordPath/Filename",例如 RecordPath = /media/usb/sda1/RECORD/M-20170611-150311-0001,对应文件名为 REC00000001.ts,则访问地址为 /media/usb/sda1/RECORD/M-20170611-150311-0001/REC00000001.ts,您可以通过http直接得到(下载)该文件。

其它说明

Device HTTP API, v1.0