深圳新瑞彩网络科技有限公司

版本/作者/日期	修改内容
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 格式的视频流

深圳新瑞彩网络科技有限公司

CGI: 音视频 CGI