音视频 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 格式的视频流