录像 CGI
版本/作者/日期 | 修改内容 |
---|---|
1.0/David/2013-03-30 | 初版 |
概述
用户可通过 CGI 将音视频手动录像到 IP Camera 上设置的地方;并且可通过 CGI 对存储在 SD 卡上的录像文件进行查询、下载、删除操作。
手动录像
start_record.cgi
- 描述:
手动录像,用户可通过本 CGI 在 IP Camera 上设置的指定位置手动录像一段时间,到时会自动结束手动录像任务,在此期间,也可通过 stop_record.cgi 来提前结束。
- 权限要求:
录像权限
- 语法:
/start_record.cgi[?user=&pwd=&session=&json=&jsonp_callback=&length=&result=&task=]
- 参数:
user/pwd:参数认证方式中需用到的登录用户名/密码 session:Session 认证方式需用到的 Session ID json/jsonp_callback:返回 json 类型数据设置 length:录像的时间;单位:秒;取值:10-900;如没设置此参数或设为空,则使用缺省参数 result/task:返回的相应的变量名称设置。
- 返回:
result:1 :操作成功,已开始录像;<=0:操作失败 task:>0:操作成功返回的任务 id,=0:操作失败。
- 示例:
http://192.168.0.188/start_record.cgi?session=1891048766&length=60&result=ret&task=id 用户请求手动录像 60 秒 IP Camera 返回: var ret=1; var id=1;
停止手动录像
stop_record.cgi
- 权限要求:
录像权限
- 语法:
/stop_record.cgi?task=[&user=&pwd=&session=&json=&jsonp_callback=&next_url=]
- 参数:
user/pwd:参数认证方式中需用到的登录用户名/密码 session:Session 认证方式需用到的 Session ID json/jsonp_callback:返回 json 类型数据设置 task:需停止的手动录像的任务 id next_url:成功操作后的返回页面。
- 返回:
操作结果的文本信息或指定页面
- 示例:
http://192.168.0.188/stop_record.cgi?session=1891048766&task=1 用户请求停止手动录像任务 1
查找 SD 卡上满足条件的录像文件
search_record.cgi
- 权限要求:
录像权限
- 语法:
/search_record.cgi[?user=&pwd=&session=&json=&jsonp_callback=&from=&to=&status=&result=&name=&path=&flag=&start_time=&end_time=&size= ]
- 参数:
user/pwd:参数认证方式中需用到的登录用户名/密码 session:Session 认证方式需用到的 Session ID json/jsonp_callback:返回 json 类型数据设置 from/to/status:查询的录像文件应满足的条件。 from:起始时间到 1970-1-1 00:00:00 GMT 所流逝的秒数 to:终止时间到 1970-1-1 00:00:00 GMT 所流逝的秒数 from 和 to 指定了在起始时间到终止时间之间录像的所有录像文件中查找;其中 from 应 <= to;如没设置此两参数或设为空,则查询所有录像文件 status:指定所查询的录像文件在录像期间是否满足指定状态 0:查询所有录像文件 Bit0:录像时是否有移动侦测报警 Bit1:录像时是否有外部报警 Bit2:录像时是否有声音侦测报警 result/name/path/flag/start_time/end_time/size:返回的相应的变量名称设置。
- 返回:
如果是返回 js 文本 result:<0 :操作失败,>=0:查找到的录像文件数目 name:数组变量,文件名称 path:数组变量,文件路径 flag:数组变量,录像文件的标志 Bit0:录像时是否有移动侦测报警 Bit1:录像时是否有外部报警 Bit2:录像时是否有声音侦测报警 start_time:数组变量,录像文件开始录像的时间到 1970-1-1 00:00:00 GMT 所流逝的秒数 end_time:数组变量,录像文件结束录像的时间到 1970-1-1 00:00:00 GMT 所流逝的秒数 size:数组变量,录像文件大小,单位:BYTE 如果是返回 json 文本 result:<0 :操作失败,>=0:查找到的录像文件数目 record 对象数组,record 对象包括: name, path, flag, start_time, end_time, size
- 示例:
http://192.168.0.188/search_record.cgi?session=1891048766 查询所有录像文件 IP Camera 返回: var result=3; var name=new Array(); var path=new Array(); var flag=new Array(); var start_time=new Array(); var end_time=new Array(); var size=new Array(); name[0]='000000000002_20110709162828_1310200108_59_4.asf'; path[0]='/mnt/sd/000000000002_20110709162828_1310200108_59_4.asf'; flag[0]=4; start_time[0]=1310200108; end_time[0]=1310200167; size[0]=16770513; name[1]='000000000002_20110709160243_1310198563_59_4.asf'; path[1]='/mnt/sd/000000000002_20110709160243_1310198563_59_4.asf'; flag[1]=4; start_time[1]=1310198563; end_time[1]=1310198622; size[1]=17780177; name[2]='000000000002_20110709154733_1310197653_59_0.asf'; path[2]='/mnt/sd/000000000002_20110709154733_1310197653_59_0.asf'; flag[2]=0; start_time[2]=1310197653; end_time[2]=1310197712; size[2]=16844241; http://192.168.0.188/search_record.cgi?session=1891048766&status=1 查询所有录像期间有移动侦测的录像文件 http://192.168.0.188/search_record.cgi?session=1891048766&from=1310190000&to=1310199999=status=7 查询在指定时间段内有报警的录像文件
删除 SD 卡上的指定录像文件
del_record.cgi
- 权限要求:
录像权限
- 语法:
/del_record.cgi?name=[&user=&pwd=&session=&json=&jsonp_callback=&next_url=]
- 参数:
user/pwd:参数认证方式中需用到的登录用户名/密码 session:Session 认证方式需用到的 Session ID json/jsonp_callback:返回 json 类型数据设置 name:需删除的录像文件的名称 next_url:成功操作后的返回页面。
- 返回:
操作结果的文本信息或指定页面
- 示例:
http://192.168.0.188/del_record.cgi?session=1891048766&name=000000000002_20110709154733_1310197653_59_0.asf 删除名称为 000000000002_20110709154733_1310197653_59_0.asf 的录像文件
下载 SD 卡上的指定录像文件
get_record.cgi
- 权限要求:
录像权限
- 语法:
/get_record.cgi?path=[&user=&pwd=&session=&name=]
- 参数:
user/pwd:参数认证方式中需用到的登录用户名/密码 session:Session 认证方式需用到的 Session ID path:需下载的录像文件的路径 name:下载录像文件的保存名称,如没设置此参数或设为空,则为原始名称。
- 返回:
录像文件
- 示例:
http://192.168.0.188/get_record.cgi?session=1891048766&path=/mnt/sd/000000000002_20110709154733_1310197653_59_0.asf&name=save.asf 下载指定录像文件并设置保存名称为 save.asf