CGI

录像 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
版权所有:深圳市瑞彩电子科技有限公司

信产部备案号:粤ICP备09050685号 技术支持:800069965