产品彩页-ipcam sdk开发使用手册_v1.1

1、机SDK 开发使用手册版本 V1.1.32014/01/16版本说明版本修改日期修改人说明1.0.02012-12-19lgh初稿1.1.02013-02-25增加1.1.12013-04-07lgh1、修改编码设置，支持 2 路码流1.1.22013-12-16lgh修改编码信息1.1.32014-01-13lgh修改IO 输入端口为1个修改 OSD 字体大小最小为 24目录说明. - 5 -概述. - 6 -1 设备管理. - 7 -1.1 获取设备信息. - 7 -1.2 设备重新启动. - 8 -升级. - 8 -1.3网络设置. - 9 -2.1 获取网络参数. - 9 -22.2

2、设置网络参数. - 10 -网络服务. - 11 -3.1 获取http 端口. - 11 -3.2 设置http 端口. - 11 -3.3 获取 FTP 服务信息 . - 12 -3.4 设置 FTP 服务信息 . - 12 -3.5 获取 SNMP 服务信息 . - 13 -33.6 设置 SNMP 服务信息. - 14 -时间设置. - 15 -4.1 获取系统时间. - 15 -44.2 获取系统时间设置方法. - 15 -4.3 设置系统时间. - 16 -5 串口参数. - 17 -5.1 获取串口参数. - 17 -5.2 设置串口参数. - 18 -5.3 写串口数据 （暂未

3、实现）. - 18 -6 移动侦测. - 19 -6.1 获取移动侦测参数. - 19 -6.2 设置移动侦测. - 21 -事件. - 22 -77.1 获取参数. - 22 -7.2 设置参数. - 25 -8 本地. - 27 -8.1 获取 SD 卡信息. - 27 -8.2 格式化 SD 卡. - 27 -8.3 备份配置文件到 SD 卡. - 28 -8.4 从 SD 卡恢复配置文件. - 28 -8.5 获取网络断开信息. - 29 -8.6 设置网络断开. - 30 -9. - 30 -9.1 获取流信息. - 30 -9.2 获取设备支持分辨率. - 32 -9.3 获取编码

4、信息. - 33 -9.4 配置编码. - 35 -9.5 获取通道OSD 设置. - 36 -9.6 设置通道OSD. - 38 -9.7 获取隐私遮蔽设置. - 39 -9.8 设置隐私遮蔽. - 41 -10 图像 . - 42 -10.1 获取图像参数. - 42 -10.2 设置图像参数. - 44 -11 音频 . - 45 -11.1 获取音频输入编码信息. - 45 -11.2 设置音频输入编码. - 46 -11.3 获取音频输出编码信息. - 46 -11.4 设置音频输出编码. - 47 -12 PTZ. - 48 -12.1 PTZ 操作. - 48 -12.2 预置位

5、设置. - 50 -说明当前本公司机开发遵循 ONVIF 2.0 协议和自有协议（本文主要内容）。机 SDK 开发包括三部分：1. 设备搜索设备搜索采用 WS-Discovery。2.采用 RTSP 协议，无用户管理；3. 信令控制信令采用 http 协议 CGI 命令。本文档将主要对基于 http 协议的 CGI 命令进行解释。概述HTTP API 是一种通用的开放协议，为机提供 WEB 服务。开发者在开发客户端时，实现与机的对接，只需按构造一条标准的 URI，便可与机进行交互。HTTP 端口 默认为 80。客户端与机的交互，是由客户端发起HTTP 请求开始的。HTTP 请求有以下两种方法：

6、GET 和T，这两种方法都可以用于获取信息和设置参数。但是，通常用 GET 获取信息，用T 设置参数。GET ：获取机配置信息及状态信息时，一般采用此种方式。例如：T：设置机参数时，一般采用此种方式。例如：服务器 HTTP 返回：返回状态由 RFC 2616 定义；正确返回数据格式为：查询返回数据= 设置返回数据错误返回为：http:/02/cgi-bin/network.cgi?action=set协议:/IP 地址/路径/命令?方法http:/02/cgi-bin/time.cgi?action=get协议:/IP 地址/路径/命令?方法1 设备管理1.1 获取设备信息2、机返回：HTTP

7、/1.0 200 OKContent-Type: text/plain服务器返回到客户端的参数如下：注：红色标记的参数暂未实现。3、示例：客户端请求获取：机返回：manufacturer=HDIPCDeviceM=HDIPCSerialNumber=unit0004630a96ecfirmwareVer= Build 131121firmwareReleaseDate=SDKVer=参数值说明manufacturer=生产厂家DeviceM=设备型号SerialNumber=设备序列号firmwareVer=固件版本firmwareReleaseDate=日期SDKVer=SDK 协议版本ON

8、VIFVer=ONVIF 协议版本IOInponnectors=IO 输入端口数IOOutputsConnectors=IO 输出端口数AudioInput=0,1音频输入：0 -无1 -有AudioOutput=0,1音频输出：0 -无1 -有macAddress=MAC 地址URL Syntaxhttp:/cgi-bin/system.cgi?action=getDeviceInfoHTTP MethodGET1.2 设备重新启动客户端发送到机的参数如下：2、机返回：HTTP/1.0 200 OKContent-Type: text/plain服务器返回到客户端的数据： Rebooting

9、3、示例：客户端发送：机返回：Rebooting1.3升级（暂未实现）客户端发送到机的参数如下：2、机返回：HTTP/1.0 200 OKContent-Type: text/plain参数值说明TFTPServerIPaddr=TFTP 服务 IPUpdatefilename=升级文件名称URL Syntaxhttp:/cgi-bin/updateFirmware.cgi?action=updateHTTP MethodGET/T参数值说明空URL Syntaxhttp:/cgi-bin/system.cgi?action=rebootHTTP MethodGET2 网络设置2.1 获取网络

10、参数客户端发送到机的参数如下：2、机返回：HTTP/1.0 200 OKContent-Type: text/plain服务器返回到客户端的参数如下：3、示例：客户端请求获取：机返回：ipv4.addr.type=0ipv4.addr=14 ipv4.submask= ipv4.getway= ipv4.dns.type=0 ipv4.dns.addr1=22ipv4.dns.addr2=参数值说明ipv4.addr.type=0,1 静态 IP DHCP，自动获取 IPipv4.addr=例如 47IP 地址ipv4.submask =例如 子网掩码ipv4.getway=例如 默认网关ip

11、v4.dns.type=0,1 手动设置 DNS 自动获取 DNSipv4.dns.addr1=例如 首选 DNS 服务器ipv4.dns.addr2=例如 备用 DNS 服务器参数值说明空URL Syntaxhttp:/cgi-bin/network.cgi?action=getHTTP MethodGet2.2 设置网络参数注： 中的参数项可选。客户端发送到机的参数如下:2、机返回：HTTP/1.0 200 OK服务器返回到客户端的数据：Sucs3、示例：客户端请求设置：=机返回：Sucs注：此时 IP 地址，DNS 已经设置成功。使用 GET 可以查看修改后的设置或者打开 WEB 查看。

12、客户端请求获取：机返回：ipv4.addr.type=0ipv4.addr=16 ipv4.submask= ipv4.getway= ipv4.dns.type=0 ipv4.dns.addr1=ipv4.dns.addr2=参数值说明ipv4.addr.type=0,1 静态 IP DHCP，自动获取 IPipv4.addr=例如 47IP 地址ipv4.submask=例如 子网掩码ipv4.getway=例如 默认网关ipv4.dns.type=0,1 手动设置 DNS 自动获取 DNSipv4.dns.addr1=例如 首选 DNS 服务器ipv4.dns.addr2=例如 备用 D

13、NS 服务器URL Syntaxhttp:/cgi-bin/network.cgi?action=set&=&.HTTP MethodGET/T3 网络服务3.1 获取 http 端口客户端发送到机的参数如下：2、机返回：HTTP/1.0 200 OKContent-Type: text/plain服务器返回到客户端的参数如下：3、示例：客户端请求获取：机返回：httpport=803.2 设置 http 端口客户端发送到机的参数如下:2、机返回：HTTP/1.0 200 OKContent-Type: text/plain参数值说明httpport=80http 端口URL Syntaxht

14、tp:/cgi-bin/netserver.cgi?action=httpportset&=HTTP MethodGET/T参数值说明httpport=80http 端口参数值说明空URL Syntaxhttp:/cgi-bin/netserver.cgi?action=httpportgetHTTP MethodGET服务器返回到客户端的数据：Sucs3、示例：客户端请求设置：机返回：Sucs注：此时 http 端口已经设置成功。使用 GET 可以查看修改后的设置或者打开 WEB 查看。3.3 获取 FTP 服务信息客户端发送到机的参数如下：2、机返回：HTTP/1.0 200 OKCont

15、ent-Type: text/plain服务器返回到客户端的参数如下：3、示例：客户端请求获取：机返回：ftpport=21ftpusername=anonymousftpusassword=3.4 设置 FTP 服务信息参数值说明ftpport=默认 21ftp 端口ftpusername=ftp 用户名ftpusassword=ftp 用户参数值说明空URL Syntaxhttp:/cgi-bin/netserver.cgi?action=ftpgetHTTP MethodGET客户端发送到机的参数如下:2、机返回：HTTP/1.0 200 OKContent-Type: text/pla

16、in服务器返回到客户端的数据：Sucs3、示例：客户端请求设置：机返回：Sucs注：此时 ftp 端口已经设置成功，使用 GET 可以查看修改后的设置。3.5 获取 SNMP 服务信息客户端发送到机的参数如下:2、机返回：HTTP/1.0 200 OKContent-Type: text/plain服务器返回到客户端的参数如下：参数值说明munity=读名munity=写名trap2sink=Trap 地址trap2name=Trap 团体名traptime=1 300Trap 发送间隔(1 300 秒)参数值说明空URL Syntaxhttp:/cgi-bin/netserver.cgi?a

17、ction=snmpgetHTTP MethodGet参数值说明ftpport=21ftp 端口URL Syntaxhttp:/cgi-bin/netserver.cgi?action=ftpset&=HTTP MethodGet3、示例：客户端请求获取：机返回：munity=hdipcmunity=hdipctrap2sink=trap2name=hdipc traptime=303.6 设置 SNMP 服务信息注： 中的参数项可选。客户端发送到机的参数如下:2、机返回： HTTP/1.0 200 OKContent-Type: text/plain服务器返回到客户端的参数如下：Sucs3、

18、示例：客户端请求设置：munity=HDIPC&traptime=50机返回：Sucs注：此时 SNMP 设置已经完成修改。使用 GET 可以查看修改后的设置或者打开 WEB 查看。参数值说明munity=读名munity=写名trap2sink=Trap 地址trap2name=Trap 团体名traptime=1 300Trap 发送间隔(1 300 秒)URL Syntaxhttp:/cgi-bin/netserver.cgi?action=snmpset&=&.HTTP MethodGET/T4 时间设置4.1 获取系统时间客户端发送到机的参数如下：2、机返回：HTTP/1.0 200

19、 OKContent-Type: text/plain服务器返回到客户端的参数如下：3、示例：客户端请求获取：机返回：time=2014-01-22 13:55:084.2 获取系统时间设置方法客户端发送到机的参数如下:2、机返回：HTTP/1.0 200 OKContent-Type: text/plain参数值说明空URL Syntaxhttp:/cgi-bime.cgi?action=gettimesetHTTP MethodGet参数值说明time=年-月-日 时:分:秒机当前时间参数值说明空URL Syntaxhttp:/cgi-bime.cgi?action=getsystimeH

20、TTP MethodGET服务器返回到客户端的参数如下：3、示例：客户端请求获取：机返回： synctype=1ntpaddr=4.3 设置系统时间注： 中的参数项可选。客户端发送到机的参数如下:2、机返回：HTTP/1.0 200 OKContent-Type: text/plain服务器返回到客户端的数据如下：Sucs3、示例：参数值说明synctype=0,1 手动 NTP 同步manual.year=1970 2031年manual.month=1 12月manual.day=1 31日manual.hour=0 23时manual.minute=0 59分manual.second=

21、0 59秒ntp.addr=IP 地址NTP 服务器地址URL Syntaxhttp:/cgi-bime.cgi?action=settime&=&.HTTP MethodT参数值说明synctype=0,1 手动同步 NTP 同步ntpaddr=IP 地址NTP 服务器地址如果同步方式为 NTP,则返回该项客户端请求设置：机返回： Sucs注意：此时系统时间已设置完成。使用 GET 可以查看修改后的设置或者打开 WEB 查看。5 串口参数5.1 获取串口参数客户端发送到机的参数如下：2、机返回：HTTP/1.0 200 OKContent-Type: text/plain服务器返回到客户端的

22、参数如下：3、示例：客户端请求获取：.cgi?action=get机返回:cameraid=1protocol=1 bandrate=9600参数值说明cameraid=1 255机地址protocol=0,1,2,3,4云台协议 透明通道 Pelco-D Pelco-P3 HD6004 PANASONICbandrate=2400,4800,9600,19200波特率参数值说明空URL Syntaxhttp:/.cgi?action=getHTTP MethodGET5.2 设置串口参数注： 中的参数项可选。客户端发送到机的参数如下:2、机返回：HTTP/1.0 200 OKContent-

23、Type: text/plain服务器返回到客户端的数据如下：Sucs3、示例：客户端请求设置：.cgi?action=set &cameraid=2&bandrate=4800机返回： Sucs注意：此时串口参数已设置完成。使用 GET 可以查看修改后的设置或者打开 WEB 查看。5.3 写串口数据 （暂未实现）URL Syntaxhttp:/.cgi?action=writedata&=&.HTTP MethodGET/T参数值说明cameraid=1 255机地址protocol=0,1,2,3,4云台协议 透明通道 Pelco-D Pelco-P3 HD6004 PANASONICba

24、ndrate=2400,4800,9600,19200波特率URL Syntaxhttp:/.cgi?action=set&=&.HTTP MethodGET/T注： 中的参数项可选。客户端发送到机的参数如下:2、机返回：HTTP/1.0 200 OKContent-Type: text/plain服务器返回到客户端的数据如下：Sucs3、示例：客户端请求设置：.cgi?action=writedata&bytecount=2机返回：Sucs注意：此时串口数据已写入。6 移动侦测6.1 获取移动侦测参数注：以上客户端不发送 参数值，机默认返回所有移动侦测区域信息。注：以上客户端发送 参数值，机

25、返回该参数值的移动侦测区域信息。客户端发送到机的参数如下：2、机返回：参数值说明regionid1 4移动侦测区域URL Syntaxhttp:/cgi-botiondetection.cgi?action=get&=HTTP MethodGETURL Syntaxhttp:/cgi-botiondetection.cgi?action=getHTTP MethodGET参数值说明bytecount=写字节数write=发送 16 进制字符0,1,2,3,4,5,6,7,8,9,a,b,c,d,e,f,A,B,C,D,E,FHTTP/1.0 200 OKContent-Type: text/p

26、lain服务器返回到客户端的参数如下：参数值说明region1.enable=0,1区域 1 控制关闭打开region1.sensitivity=0-100区域 1 灵敏度region1.threshold=0-100区域 1 临界region1.x=区域 1 左上 x 坐标region1.y=区域 1 左上 y 坐标region1.width=区域 1 宽度region1.height=区域 1 高度region2.enable=0,1区域 2 控制关闭打开region2.sensitivity=0-100区域 2 灵敏度region2.threshold=0-100区域 2 临界regio

27、n2.x=区域 2 左上 x 坐标region2.y=区域 2 左上 y 坐标region2.width=区域 2 宽度region2.height=区域 2 高度region3.enable=0,1区域 3 控制关闭打开region3.sensitivity=0-100区域 3 灵敏度region3.threshold=0-100区域 3 临界region3.x=区域 3 左上 x 坐标region3.y=区域 3 左上 y 坐标region3.width=区域 3 宽度region3.height=区域 3 高度region4.enable=0,1区域 4 控制关闭打开region4.se

28、nsitivity=0-100区域 4 灵敏度region4.threshold=0-100区域 4 临界region4.x=区域 4 左上 x 坐标region4.y=区域 4 左上 y 坐标region4.width=区域 4 宽度region4.height=区域 4 高度3、示例：a) 客户端请求获取：机返回： region1.enable=1region1.sensitivity=70 region1.threshold=10 region1.x=0 region1.y=0region1.WindowWidth=240 region1.WindowHeight=132 region4

29、.enable=1 region4.sensitivity=70 region4.threshold=10 region4.x=237 region4.y=132region4.WindowWidth=240region4.WindowHeight=132b) 客户端请求获取：（发送参数）机返回：region2.enable=1region2.sensitivity=70 region2.threshold=10 region2.x=0 region2.y=132 region2.width=240region2.height=1326.2 设置移动侦测注： 中的参数项可选。客户端发送到机的参

30、数如下：参数值说明URL Syntaxhttp:/cgi-botiondetection.cgi?action=set&=&.HTTP MethodGET/T2、机返回：HTTP/1.0 200 OK服务器返回到客户端的数据如下：Sucs3、示例：客户端请求设置：机返回：Sucs注意：此时移动侦测已设置完成。使用 GET 可以查看修改后的设置或者打开 WEB 查看。事件77.1 获取参数客户端发送到机的参数如下：2、机返回：HTTP/1.0 200 OK参数值说明空URL Syntaxhttp:/cgi-bin/alarm.cgi?action=getHTTP MethodGETregioni

31、d=1 4侦测区域，设置支持同 4 个侦测区域enable=0,1是否启用 关闭 打开sensitivity=0-100灵敏度threshold=0-100临界x=侦测区域起始 X 坐标y=侦测区域起始 Y 坐标width=宽度height=高度Content-Type: text/plain服务器返回到客户端的参数如下：参数值说明sddetect.enable=0,1SD 卡容量检测 关闭 打开sddetect.iooutput=0,1SD 卡容量联动：IO 端口输出 关闭 打开sddetect.messagecenter=0,1SD 卡容量联动：发送消息至消息中心 关闭 打开sddetec

32、t.=0,1SD 卡容量联动：发送邮件 关闭 打开motiondetect.enable=0,1移动侦测检测 关闭 打开motiondetect.iooutput=0,1移动侦测联动：IO 端口输出 关闭 打开motiondetect.messagecenter=0,1移动侦测 联动：发送消息至消息中心 0 关闭1 打开motiondetect.capturc=0,1移动侦测联动： 至卡 关闭 打开motiondetect.=0,1移动侦测联动：发送邮件 关闭 打开ioinput.enable=0,1IO 输入端口检测 关闭 打开=IO 输入端口描述（最多 32 个字符）3、示例：客户端请求获

33、取：机返回：sddetect.enable=0sddetect.iooutput=0 sddetect.messagecenter=0sddetect.=0motiondetect.enable=0motiondetect.iooutput=0 motiondetect.messagecenter=0 motiondetect.capturc=0 motiondetect.=0 ioinput.enable=0 =ALMIN1 ioinput.type=0 ioinput.iooutput=0ioinput.messagecenter=0ioinput.=0=ALMOUTiooutput.ty

34、pe=0 iooutput.holdtimesec=20ioinput.type=0,1IO 输入端口输入类型 常闭 常开ioinput.iooutput=0,1IO 输入端口联动：IO 端口输出 关闭 打开ioinput.messagecenter=0,1IO 输入端口联动：发送消息至消息中心 关闭 打开ioinput.=0,1IO 输入端口联动：发送邮件 关闭 打开=IO 输出端口描述（最多 32 个字符）iooutput.type=0,1IO 输出端口输入类型 开路 闭合iooutput.holdtimesec=1 60联动 IO 端口输出保持时间（1-60 秒）7.2 设置参数注： 中

35、的参数项可选。客户端发送到机的参数如下：参数值说明sddetect.enable=0,1SD 卡容量检测 关闭 打开sddetect.iooutput=0,1SD 卡容量联动：IO 端口输出 关闭 打开sddetect.messagecenter=0,1SD 卡容量联动：发送消息至消息中心 关闭 打开sddetect.=0,1SD 卡容量联动：发送邮件 关闭 打开motiondetect.enable=0,1移动侦测检测 关闭 打开motiondetect.iooutput=0,1移动侦测联动：IO 端口输出 关闭 打开motiondetect.messagecenter=0,1移动侦测 联动

36、：发送消息至消息中心 0 关闭1 打开motiondetect.capturc=0,1移动侦测联动： 至卡 关闭 打开URL Syntaxhttp:/cgi-bin/alarm.cgi?action=set&=&.HTTP MethodGET/T2、机返回：HTTP/1.0 200 OK服务器返回到客户端的数据如下：Sucs3、示例：客户端请求设置：机返回：Sucs注意：此警参数已设置完成。使用 GET 可以查看修改后的设置或者打开 WEB 查看。motiondetect.=0,1移动侦测联动：发送邮件 关闭 打开ioinput.enable=0,1IO 输入端口检测 关闭 打开=IO 输入端

37、口描述（最多 32 个字符）ioinput.type=0,1IO 输入端口输入类型 常闭 常开ioinput.iooutput=0,1IO 输入端口联动：IO 端口输出 关闭 打开ioinput.messagecenter=0,1IO 输入端口联动：发送消息至消息中心 关闭 打开ioinput.=0,1IO 输入端口联动：发送邮件 关闭 打开=IO 输出端口描述（最多 32 个字符）iooutput.type=0,1IO 输出端口输入类型 开路 闭合iooutput.holdtimesec=1 60联动 IO 端口输出保持时间（1-60 秒）8 本地8.1 获取 SD 卡信息客户端发送到机的参

38、数如下：2、机返回：HTTP/1.0 200 OKContent-Type: text/plain服务器返回到客户端的参数如下：3、示例：客户端请求获取：机返回：active=-1size=0 freesize=08.2 格式化 SD 卡客户端发送到机的参数如下：URL Syntaxhttp:/cgi-bin/sdcard.cgi?action=formatHTTP MethodGET参数值说明active=0,10：未安装1：安装size=空间大小MBfreesize=剩余空间MB参数值说明空URL Syntaxhttp:/cgi-bin/sdcard.cgi?action=getHTTP

39、MethodGET2、机返回：HTTP/1.0 200 OK服务器返回到客户端的数据如下：Sucs3、示例：客户端请求设置：机返回：Sucs8.3 备份配置文件到 SD 卡客户端发送到机的参数如下：2、机返回：HTTP/1.0 200 OK服务器返回到客户端的数据如下：Sucs3、示例：客户端请求备份：机返回：Sucs注意：该操作是将所有配置文件备份到 SD 卡中。8.4 从 SD 卡恢复配置文件参数值说明空URL SyntaxHttp:/cgi-bin/sdcard.cgi?action=backupconfigfileHTTP MethodGET参数值说明空客户端发送到机的参数如下：2、机

40、返回：HTTP/1.0 200 OK服务器返回到客户端的数据如下：Sucs3、示例：客户端请求恢复：机返回：Sucs注意：该操作是将所有配置文件从 SD 卡中恢复。8.5 获取网络断开信息客户端发送到机的参数如下：2、机返回：HTTP/1.0 200 OKContent-Type: text/plain服务器返回到客户端的参数如下：3、示例：客户端请求获取：机返回：streamid=1参数值说明streamid=1 - 2网络断开时，将到本地SD 上，该参数指明录制哪路码流参数值说明空URL Syntaxhttp:/cgi-bin/sdcard.cgi?action=getdisconnect

41、recordHTTP MethodGET参数值说明空URL Syntaxhttp:/cgi-bin/sdcard.cgi?action=restoreconfigfileHTTP MethodGET8.6 设置网络断开客户端发送到机的参数如下：2、机返回：HTTP/1.0 200 OK服务器返回到客户端的数据如下：Sucs3、示例：客户端请求设置：机返回：Sucs注意：此时网络断开已设置完成，使用 GET 可以查看修改后的设置或者打开WEB 查看。99.1 获取流信息客户端发送到机的参数如下：2、机返回：参数值说明空URL Syntaxhttp:/cgi-bin/streamuri.cgi?a

42、ction=getHTTP MethodGET参数值说明streamid=1 - 2网络断开时，将到本地 SD上，该参数指制哪路码流URL Syntaxhttp:/cgi-bin/sdcard.cgi?action=setdisconnectrecord&=HTTP MethodGETHTTP/1.0 200 OKContent-Type: text/plain服务器返回到客户端的参数如下：3、示例：客户端请求获取：机返回：chnl1.streamuri=rtsp:/13/stream1chnl2.streamuri=rtsp:/13/stream2 chnl3.streamuri=rtsp:

43、/13/stream3 chnl4.streamuri=rtsp:/13/stream4参数值说明chnl1.enable=0,1 关闭 打开chnl1.encoding=0,1编码格式0 H2641 MJPEGchnl1.h264profile=0,1MainHighchnl1.mjpegquality=1 100MJPEG 质量chnl1.resolutionwidth=清晰度宽chnl1.resolutionheight=清晰度高chnl1.framerate=1 - 60帧率chnl1.bitrate=256,512,1024,2048,4096,6144,8192,10240,143

44、36kbpschnl1.streamuri=rtsp:/stream1码流 1 的地址chnl2.enable=0,1 关闭 打开chnl2.encoding=0,1编码格式0 H2641 MJPEGchnl2.h264profile=0,1MainHighchnl2.mjpegquality=1 100MJPEG 质量chnl2.resolutionwidth=清晰度宽chnl2.resolutionheight=清晰度高chnl2.framerate=1 - 60帧率chnl2.bitrate=256,512,1024,2048,4096,6144,8192,10240,14336kbps

45、chnl2.streamuri=rtsp:/stream2码流 2 的地址9.2 获取设备支持分辨率注意：设置通道分辨率时，需参考设备列出的支持分辨率。注：以上客户端不发送 参数值，机默认返回所有可用码流的配置信息。注：以上客户端发送 参数值，机返回该参数的码流配置信息。客户端发送到机的参数如下：2、机返回：HTTP/1.0 200 OKContent-Type: text/plain服务器返回到客户端的参数如下：3、示例：a) 客户端请求获取：机返回：chnl1.resolutions=1920 x1080,1280 x960,1280 x720,1024x768 chnl2.resolut

46、ions=720 x576,702x576,720 x480,352x288b) 客户端请求获取：（发送参数）机返回：chnl1.resolutions=1920 x1080,1280 x960,1280 x720,1024x768参数值说明chnl1.resolutions=1920 x1080,1280 x720,通道 1 支持分辨率chnl2.resolutions=720 x480,352x288,通道 2 支持分辨率参数值说明chnl=1 - 2通道URL Syntaxhttp:/cgi-bin/capability.cgi?action=getResolutions&=HTTP M

47、ethodGETURL Syntaxhttp:/cgi-bin/capability.cgi?action=getResolutionsHTTP MethodGET9.3 获取编码信息客户端发送到机的参数如下：2、机返回：HTTP/1.0 200 OKContent-Type: text/plain服务器返回到客户端的参数如下：参数值说明cvbs.enable=0,1 关闭 打开cvbs.type=0,1制式： PAL NTSCcvbs.aspect=0,10 16:91 4:3cvbs.flip=0,1图像翻转：0 不旋转1 旋转 180 度chnl1.enable=0,1 关闭 打开chn

48、l1.flip=0,1图像翻转：0 不旋转1 旋转 180 度chnl1.format.codec=0,1编码格式：0 H2641 MJPEGchnl1.file=0,1MainHighchnl1.format.resolutionwidth=参考 9.2 设备支持分辨率chnl1.format.resolutionheight=参考 9.2 设备支持分辨率chnl1.format.framerate=1,2,3,4,5,6,10,12,13,15,20,帧率参数值说明空URL Syntaxhttp:/cgi-bin/channel.cgi?action=getHTTP MethodGET3、

49、示例：客户端请求获取：机返回：24,25,30chnl1.format.gop=1-255I 帧间隔chnl1.format.ratecontrol=0,1码率控制： CBR VBRchnl1.format.vbrminbitrate=256,512,1024,2048,4096,6144,8192,10240,14336VBR 最小码率 kbpschnl1.format.vbrmaxbitrate=256,512,1024,2048,4096,6144,8192,10240,14336VBR 最大码率 kbpschnl1.format.cbravgbitrate=256,512,1024,2

50、048,4096,6144,8192,10240,14336CBR 平均码率 kbpschnl1.format.mjpegquality=1 100MJPEG 质量chnl2.enable=0,1 关闭 打开chnl2.flip=0,1图像翻转：不旋转旋转 180 度chnl2.format.codec=0,1编码格式：0 H2641 MJPEGchnl2.file=0,10 Main1 High参考 9.2 设备支持分辨率chnl2.format.resolutionwidth=chnl2.format.resolutionheight=参考 9.2 设备支持分辨率chnl2.format.

51、framerate=1,2,3,4,5,6,10,12,13,15,20,24,25,30帧率chnl2.format.gop=1-255I 帧间隔chnl2.format. Bitratecontrol =0,10 - CBR 1 - VBRchnl2.format.vbrminbitrate=256,512,1024,2048,4096,6144,8192,10240,14336VBR 最小码率 kbpschnl2.format.vbrmaxbitrate=256,512,1024,2048,4096,6144,8192,10240,14336VBR 最大码率 kbpschnl2.form

52、at.cbravgbitrate=256,512,1024,2048,4096,6144,8192,10240,14336CBR 平均码率 kbpschnl2.format.mjpegquality=1 100MJPEG 质量cvbs.enable=0cvbs.type=0 cvbs.aspect=0 cvbs.flip=0chnl1.chnl1. chnl1. chnl1. chnl1. chnl1. chnl1. chnl1. chnl1. chnl1. chnl1. chnl1. chnl1.enable=1.flip=0.format.codec=0.file=0.format.res

53、olutionwidth=1920.format.resolutionheight=1080.format.framerate=25.format.gop=50.format.ratecontrol=0.format.cbravgbitrate=0.format.vbrminbitrate=4096.format.vbrmaxbitrate=6144.format.mjpegquality=09.4 配置编码注： 中的参数项可选。客户端发送到机的参数如下：2、服务器返回到客户端的数据如下：Sucs3、示例：客户端发送：chnl1.format.framerate=30机返回：Sucs注意：此时

54、编码已设置完成，使用 GET 可以查看修改后的设置或者打开 WEB 查看。参数值说明参考 9.3，服务器返回到客户端的参数以及值URL Syntaxhttp:/cgi-bin/channel.cgi?action=set&=&.HTTP MethodT9.5 获取通道 OSD 设置注：以上客户端不发送 参数值，机默认返回所有可用码流的 OSD 信息。注：以上客户端发送 参数值，机返回该参数码流的 OSD 信息。客户端发送到机的参数如下：2、机返回：HTTP/1.0 200 OKContent-Type: text/plain服务器返回到客户端的参数如下：参数值说明chnl1.fontSize2

55、4,32,42,48字体大小: 24,32,42,48 磅chnl1.time.enable0 ,1时间不显示显示chnl1.time.type0,1,2,3时间显示格式 年-月-日 时:分:秒 年/月/日 时:分:秒 月-日-年 时:分:秒 月/日/年 时:分:秒chnl1.time.WindowsX时间显示起始位置 Xchnl1.time.WindowsY时间显示起始位置 Ychnl1.title.enable0 ,1标题不显示显示chnl1.title.String叠加字符，最多 32 个字符（使用 utf-8 编码）chnl1.title.WindowsX显示位置 X 坐标chnl1.

56、title.WindowsY显示位置 Y 坐标chnl1.subtitle.enable0 ,1副标题0-不显示参数值说明chnl1 2通道URL Syntaxhttp:/cgi-bin/osd.cgi?action=get&=HTTP MethodGetURL Syntaxhttp:/cgi-bin/osd.cgi?action=getHTTP MethodGet3、示例：a) 客户端请求获取：机返回：chnl1.fontSize=48 chnl1.time.enable=1 chnl1.time.type=0 chnl1.time.Windows chnl1.time.Windows ch

57、nl1.title.enable=0 chnl1.title.String= chnl1.title.Windows chnl1.title.Windows chnl1.subtitle.enable=0chnl1.subtitle.String=X=0Y=0X=0Y=0chnl1.subtitle.Windowschnl1.subtitle.Windows客户端请求获取：机返回：chnl2.fontSize=32 chnl2.time.enable=1 chnl2.time.type=0 chnl2.time.Windows chnl2.time.Windows chnl2.title.en

58、able=0chnl2.title.String=X=0Y=0b)X=0Y=0chnl2.title.Windowschnl2.title.Windows chnl2.subtitle.enable=0 chnl2.subtitle.String=X=0Y=0chnl2.subtitle.Windowschnl2.subtitle.WindowsX=0Y=01-显示chnl1.subtitle.String叠加字符，最多 32 个字符（使用 utf-8 编码）chnl1.subtitle.WindowsX显示位置 X 坐标chnl1.subtitle.WindowsY显示位置 Y 坐标chnl

59、2chnl2 的参数项与 chnl1的参数项一样；若不传送 chnl 值，则返回 chnl1 和 chnl2 通道的 OSD 信息；9.6 设置通道 OSD注： 中的参数项可选。客户端发送到机的参数如下：2、机返回：HTTP/1.0 200 OK参数值说明chnl1 2通道fontSize24,32,42,48字体大小: 24,32,42,48磅time.enable0 ,1时间不显示显示time.type0,1,2,3时间显示格式 年-月-日 时:分:秒 年/月/日 时:分:秒 月-日-年 时:分:秒 月/日/年 时:分:秒time.WindowsX时间显示起始位置 Xtime.Window

60、sY时间显示窗口左上角 Y坐标应小于通道图像高度title.enable0 ,1标题不显示显示title.String叠加字符，最多 32 个字符（使用 utf-8 编码）title.WindowsX显示位置 X 坐标title.WindowsY显示位置 Y 坐标subtitle.enable0 ,1副标题不显示显示subtitle.String叠加字符，最多 32 个字符（使用 utf-8 编码）subtitle.WindowsX显示位置 X 坐标subtitle.WindowsY显示位置 Y 坐标URL Syntaxhttp:/cgi-bin/osd.cgi?action=set&=&HT