CGI

音视频 CGI

版本/作者/日期修改内容
1.0/David/2013-03-30初版

概述

用户可通过 CGI 来获取 IP Camera 的音视频

抓拍 IP Camera 的当前图像

snapshot.cgi

  • 权限要求:
拍照权限
  • 语法:
/snapshot.cgi[?user=&pwd=&session=&resolution=&filename=]
  • 参数:
user/pwd:参数认证方式中需用到的登录用户名/密码
	session:Session 认证方式需用到的 Session ID
resolution:拍照的图像大小,取值同stream1_resolution 参数,如没设置此参数或设为空,则使用缺

省的图像大小。
filename:返回的文件名称,如没设置此参数或设为空,则返回的文件名称格式为:snapshot_拍照时

间.jpg。例如:snapshot_20110708163405.jpg,拍照时间为 2011-7-8 16:34:05。
  • 返回:
返回图像文件。
  • 示例:
http://192.168.0.188/snapshot.cgi?session=1891048766
	IP Camera 返回文件名为 snapshot_20110708163405.jpg 的图像文件。

	http://192.168.0.188/snapshot.cgi?session=1891048766&resolution=4&filename=save.jpg
	IP Camera 返回文件名为 save.jpg 的 320*240 大小的图像文件。

请求 IP Camera 的音视频流。

request_av.cgi

  • 描述:
请求 IP Camera 的音视频流。用户可通过 av.asf 来获取 IP Camera 的音视频流,但在某些情况下,比如在网页中使用 vlc 控件来播放 av.asf 时,在不成功时,会无法得到出错的提示信息。此时可先使用 request_av.cgi 来向 IP Camera 请求音视频,如不成功,则会返回错误信息,如成功,IP Camera 会保留用户请求的信息,并返回一个 id 作为标识,然后,用户可使用此 id 来直接访问 IP Camera 的音视频。此 id 为一次性的并且 IP Camera 最长保留此 id 一分钟,即用户使用此 id 后,即失效,同样,如一分钟后,用户没有使用此 id,则 id 也会失效。
  • 权限要求:
视频访问权限/音频访问权限
  • 语法:
/request_av.cgi[?user=&pwd=&session=&json=&jsonp_callback=&video=&audio=&stream=&result=&id=]
  • 参数:
user/pwd:参数认证方式中需用到的登录用户名/密码
session:Session 认证方式需用到的 Session ID
json/jsonp_callback:返回 json 类型数据设置
video:是否需要视频;0:否,1:是;如没设置此参数或设为空,则缺省为是;如选择是,则需要视频访问权限。
audio:是否需要音频;0:否,1:是;如没设置此参数或设为空,则缺省为是;如选择是,则需要音频访问权限。
stream:视频流的编号,如没设置此参数或设为空,则缺省为第一条视频流。
result/id:返回的相应的变量名称设置。
  • 返回:
result:请求是否成功
0:成功
-1:当前时段对该用户不开放
-2:已达到最大同时观看路数
id:成功后回的标识。
  • 示例:
http://192.168.0.188/request_av.cgi?session=1891048766 用户请求视频流1和音频
	IP Camera 返回:
	var result=0;
  var id=1567918901;
  
  http://192.168.0.188/request_av.cgi?session=1891048766&video=1&audio=0&stream=2&result=ret 用户请求视频流2
	IP Camera 返回:
	var ret=0;
  var id=2084675952;

获取 IP Camera 的 MJPEG 流视频

videostream.cgi

  • 权限要求:
视频访问权限
  • 语法:
/videostream.cgi[?user=&pwd=&session=&id=&stream=]
  • 参数:
user/pwd:参数认证方式中需用到的登录用户名/密码
session:Session 认证方式需用到的 Session ID
id:request_av.cgi 返回的有效的 id
stream:视频流的编号,如没设置此参数或设为空,则缺省为第一条视频流,注意:指定的视频流必需是 MJPEG 编码格式的,否则会返回错误。
  • 返回:
HTTP Server Push 模式的jpeg 图片流。
  • 示例:
  http://192.168.0.188/request_av.cgi?session=1891048766&video=1&audio=0&stream=2&result=ret 用户请求视频流2,视频流2必需是 MJPEG 编码格式的
	IP Camera 返回:
	var ret=0;
  var id=2084675952;
  http://192.168.0.188/videostream.cgi?id=2084675952 使用之前 request_av.cgi 的参数来访问 IP Camera 的 MJPEG 流视频,即视频流2
  IP Camera 返回 HTTP Server Push 模式的jpeg 图片流
  
  http://192.168.0.188/videostream.cgi?session=1891048766&stream=2 访问 IP Camera 的视频流2(必需是 MJPEG 编码格式的)
IP Camera 返回 HTTP Server Push 模式的jpeg 图片流

获取 IP Camera 的音视频流

av.asf

  • 权限要求:
视频访问权限/音频访问权限
  • 语法:
/av.asf[?user=&pwd=&session=&id=&video=&audio=&stream=]
  • 参数:
user/pwd:参数认证方式中需用到的登录用户名/密码
session:Session 认证方式需用到的 Session ID
id:request_av.cgi 返回的有效的 id
video:是否需要视频;0:否,1:是;如没设置此参数或设为空,则缺省为是;如选择是,则需要视频访问权限。
audio:是否需要音频;0:否,1:是;如没设置此参数或设为空,则缺省为是;如选择是,则需要音频访问权限。
stream:视频流的编号,如没设置此参数或设为空,则缺省为第一条视频流。
  • 返回:
ASF 格式的音视频流。
  • 示例:
http://192.168.0.188/request_av.cgi?session=1891048766 用户请求视频流1和音频
IP Camera 返回:
var result=0;
var id=1567918901;
http://192.168.0.188/videostream.cgi?id=1567918901 使用之前 request_av.cgi 的参数来访问 IP Camera 的视频流1和音频
IP Camera 返回 ASF 格式的音视频流
http://admin:@192.168.0.188/av.asf?video=1&audio=0&stream=2 访问 IP Camera 的视频流2
IP Camera 返回 ASF 格式的视频流
版权所有:深圳市瑞彩电子科技有限公司

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