Download it:
解码器控制协议.pdf (Size: 336.22 KB / Downloads: 39)
http-commands.txt (Size: 8.61 KB / Downloads: 30)
解码器控制协议V2.0
关于认证
支持基本认证 basic authentication/摘要认证 digest authentication两种认证方式；
如果你对两种认证方式不了解，可通过GET传递user,pass参数方式认证，如http://ip/get_net?user=admin&pass=admin
1、 获取设备地址信息
http://ip/get_net
访问如上地址，设备会以XML形式返回地址信息如下：
<?xml version="1.0" encoding="UTF-8"?>
<net>
<ip>192.168.1.169</ip>
<netmask>255.255.255.0</netmask>
<gateway>192.168.1.1</gateway>
<mac>00:13:14:15
7:F4</mac>
<dhcp_enable>0</dhcp_enable>
<dns0>192.168.1.1</dns0>
<dns1>8.8.8.8</dns1>
<http_port>8080</http_port>
<html_password>admin</html_password>
</net>
其实中dhcp_enable为0时表示禁用，为1时表示启用DHCP功能。
2、 设置设备地址信息
http://ip/set_net?ip=& netmask=& gateway=& dhcp_enable=& dns0=& dns1& http_port
3、 获取WIFI信息
http://ip/get_wifi
4、 设置WIFI信息
http://ip/set_wifi? wifi_enable=0|1&wifi_ip=&wifi_netmask=&wifi_gateway=&wifi_dhcp_enable=&wifi_essid=&wifi_psk=
其中wifi_enable表示是否启用wifi，1启用0禁用；
wifi_ip缺省ip
wifi_netmask缺省netmask
wifi_gateway缺省gateway
wifi_dhcp_enable取值1或0，1启用0禁用DHCP功能
wifi_essid为wifi的essid
wifi_psk为wifi的密码
5、 获取热点
http://ip/get_ap
6、 获取播放列表
http://ip/get_playlist
<?xml version="1.0" encoding="UTF-8"?>
<playlist wnd="1">
<uri0 cache="0" audio="1" apid="0" vpid="0" pwd="">http://192.168.1.168/0.pte</uri0>
<uri1 cache="0" audio="0" apid="0" vpid="0" pwd=""></uri1>
<uri2 cache="0" audio="0" apid="0" vpid="0" pwd=""></uri2>
<uri3 cache="0" audio="0" apid="0" vpid="0" pwd=""></uri3>
</playlist>
其中wnd表示播放的窗口数，只能取值 1，4；audio指示是否播放对应uri的音频，当为4窗口时，只能一个为1，其它为0；
7、 设置播放列表
http://ip/set_playlist?wnd=1|4&uri0=&uri...uri3_audio=
其中wnd表示播放的窗口数据，只能取值1，4；uri0指示播放地址，uri0_audio取值 为0，1，指示是否播放音频。
注uri0_audio，uri1_audio，uri2_audio，uri3_audio只启用一路音频播放。
8、 获取输出信息
http://ip/get_vo
<?xml version="1.0" encoding="UTF-8"?>
<hdmi>
<vo>1080P60</vo>
<vo_cvbs>PAL</vo_cvbs>
<vo_source>no</vo_source>
<vo_rotate>0</vo_rotate>
<Luma>50</Luma>
<Contrast>50</Contrast>
<Hue>50</Hue>
<Saturationvo>50</Saturationvo>
</hdmi>
9、 设置输出信息
http://ip/set_vo?vo=&vo_cvbs=&vo_source=..._scale=0|1
vo指示HDMI输入的分辨率及帧率取值为480P60、576P50、720P50、720P60、1080P25、1080P30、1080I50、1080P50、1080I60、1080P60、1440P30、2160P30
vo_cvbs指示cvbs输出参数取值为PAL 或 NTSC
vo_source指示是否按源分辨率输出取值为YES 或 NO
vo_rotate指示旋转角度取值为0、90、180、270
vo_scale指示是否按比例旋转1表示按比较，0不按比例
Luma亮度0~100
Contrast对比度0~100
Hue色度0~100
Saturation饱和度
10、 获取设备状态
http://ip/get_version
<?xml version="1.0" encoding="UTF-8"?>
<version>1.45.1</version>
11、 获取硬件信息
http://ip/get_hardware
<?xml version="1.0" encoding="UTF-8"?>
<hardware>
<cpu>Hi3536C</cpu>
<module>XD5.1.45.1</module>
</hardware>
12、 获取裁剪信息
http://ip/get_crop
13、 设置裁剪信息
http://ip/set_crop?
crop0_enable=1|0&crop0_x=&&crop0_y=&&crop0_w=&&crop0_h&
crop1_enable=1|0&crop1_x=&&crop1_y=&&crop1_w=&&crop1_h&
crop1_enable=2|0&crop2_x=&&crop2_y=&&crop2_w=&&crop2_h&
crop1_enable=3|0&crop3_x=&&crop3_y=&&crop3_w=&&crop3_h
注 x,y, w, h均是针对视频原始大小而言的。
14、 设置全单路全屏播放
http://ip/set_full?chn=0|1|2|3|1000
注：http://ip/set_full?chn=0表示显示第一路
http://ip/set_full?chn=1000表示显示4画面
15、 文本OSD设置（具体参数可参考WEB）
GET http://ip/set_osd?osd_0_enable=1&osd_0_t...&osd_3_txt=
osd_0_enable=0|1表示启用|禁用
osd_0_alpha=100 透明度0~100
osd_0_x=10 显示位置，左上角为（0，0）坐标
osd_0_y=10显示位置，左上角为（0，0）坐标
osd_0_font_size=36，字体大小
osd_0_color=0 字体颜色
osd_0_bcolor=0 字体背景色
osd_0_txt=text 文本内容
返回
<?xml version="1.0" encoding="UTF-8"?><return>ok</return>
16、 滚动OSD设置（具体参数可参考WEB）
GET http://ip/set_osd?osd_0_enable=1&osd_0_t...&osd_3_txt=
osd_0_enable=0|1表示启用|禁用
osd_0_alpha=100 透明度0~100
osd_0_x=10 显示位置，左上角为（0，0）坐标
osd_0_y=10滚动速度
osd_0_font_size=36，字体大小
osd_0_color=0 字体颜色
osd_0_bcolor=0 字体背景色
osd_0_txt=text 文本内容
注osd_0..表示第一个，osd_1..表示第二个OSD...
返回
<?xml version="1.0" encoding="UTF-8"?><return>ok</return>
17、 图片OSD设置（具体参数可参考WEB）
GET http://ip/set_osd?osd_0_enable=1&osd_0_t...5593785184 HTTP/1.1
osd_0_alpha=100 透明度0~100
osd_0_x=10 显示位置，左上角为（0，0）坐标
osd_0_y=10显示位置，左上角为（0，0）坐标
osd_0_txt= 显示图片名
返回
<?xml version="1.0" encoding="UTF-8"?><return>ok</return>
18、 通道布局控制
GET
http://ip/set_vopos?&enable=1&voposx0=0&...riority3=0
enable 1表示启用自定义布局 0表示禁用自定义布局
第一路画面位置
voposx0=0 画面x坐标
voposy0=0 画面x坐标
voposw0=424 画面宽度
voposh0=180 画面高度
priority0=0 保留参数无用
其它3路画面参数类似，但设置过程需保证设置后的画面没有重叠。
19、 ndi流地址获取
GET
http://ip/ndifind
返回
<?xml version="1.0" encoding="UTF-8"?>
<discover>
<d>ndi:192.168.20.122 (Stream1)</d>
</discover>
将<d></d>接点地址解析出来，设置到解码地址中即可，参考7设置播放地址
20、 onvif设备列表获取
GET
http://ip/onvifcfind
返回
<?xml version="1.0" encoding="UTF-8"?>
<discover>
<d>http://192.168.20.122/onvif/device_service</d>
<d>http://192.168.20.5/onvif/device_service</d>
<d>http://192.168.20.6/onvif/device_service</d>
<d>http://192.168.20.7/onvif/device_service</d>
</discover>
21、 将20获取到的device_service地址传入如下接口获取媒体地址
GET
http://ip/Onvifcrtsp?device_service=http...d=xc888888
返回
<?xml version="1.0" encoding="UTF-8"?>
<rtsp>rtsp://admin:xc888888@192.168.20.5:554/Streaming/Channels/101?transportmode=mcast&profile=Profile_1</rtsp>
22、 强制重新打开指定通道
GET
http://ip/replay?chn=0
chn取值0，1，2，3分别对应 通道1地址， 通道2地址， 通道3地址， 通道4地址
返回
成功
<?xml version="1.0" encoding="UTF-8"?><return>ok</return>
失败
<?xml version="1.0" encoding="UTF-8"?><return>failed</return>
解码器控制协议.pdf (Size: 336.22 KB / Downloads: 39)
http-commands.txt (Size: 8.61 KB / Downloads: 30)
解码器控制协议V2.0
关于认证
支持基本认证 basic authentication/摘要认证 digest authentication两种认证方式；
如果你对两种认证方式不了解，可通过GET传递user,pass参数方式认证，如http://ip/get_net?user=admin&pass=admin
1、 获取设备地址信息
http://ip/get_net
访问如上地址，设备会以XML形式返回地址信息如下：
<?xml version="1.0" encoding="UTF-8"?>
<net>
<ip>192.168.1.169</ip>
<netmask>255.255.255.0</netmask>
<gateway>192.168.1.1</gateway>
<mac>00:13:14:15
7:F4</mac><dhcp_enable>0</dhcp_enable>
<dns0>192.168.1.1</dns0>
<dns1>8.8.8.8</dns1>
<http_port>8080</http_port>
<html_password>admin</html_password>
</net>
其实中dhcp_enable为0时表示禁用，为1时表示启用DHCP功能。
2、 设置设备地址信息
http://ip/set_net?ip=& netmask=& gateway=& dhcp_enable=& dns0=& dns1& http_port
3、 获取WIFI信息
http://ip/get_wifi
4、 设置WIFI信息
http://ip/set_wifi? wifi_enable=0|1&wifi_ip=&wifi_netmask=&wifi_gateway=&wifi_dhcp_enable=&wifi_essid=&wifi_psk=
其中wifi_enable表示是否启用wifi，1启用0禁用；
wifi_ip缺省ip
wifi_netmask缺省netmask
wifi_gateway缺省gateway
wifi_dhcp_enable取值1或0，1启用0禁用DHCP功能
wifi_essid为wifi的essid
wifi_psk为wifi的密码
5、 获取热点
http://ip/get_ap
6、 获取播放列表
http://ip/get_playlist
<?xml version="1.0" encoding="UTF-8"?>
<playlist wnd="1">
<uri0 cache="0" audio="1" apid="0" vpid="0" pwd="">http://192.168.1.168/0.pte</uri0>
<uri1 cache="0" audio="0" apid="0" vpid="0" pwd=""></uri1>
<uri2 cache="0" audio="0" apid="0" vpid="0" pwd=""></uri2>
<uri3 cache="0" audio="0" apid="0" vpid="0" pwd=""></uri3>
</playlist>
其中wnd表示播放的窗口数，只能取值 1，4；audio指示是否播放对应uri的音频，当为4窗口时，只能一个为1，其它为0；
7、 设置播放列表
http://ip/set_playlist?wnd=1|4&uri0=&uri...uri3_audio=
其中wnd表示播放的窗口数据，只能取值1，4；uri0指示播放地址，uri0_audio取值 为0，1，指示是否播放音频。
注uri0_audio，uri1_audio，uri2_audio，uri3_audio只启用一路音频播放。
8、 获取输出信息
http://ip/get_vo
<?xml version="1.0" encoding="UTF-8"?>
<hdmi>
<vo>1080P60</vo>
<vo_cvbs>PAL</vo_cvbs>
<vo_source>no</vo_source>
<vo_rotate>0</vo_rotate>
<Luma>50</Luma>
<Contrast>50</Contrast>
<Hue>50</Hue>
<Saturationvo>50</Saturationvo>
</hdmi>
9、 设置输出信息
http://ip/set_vo?vo=&vo_cvbs=&vo_source=..._scale=0|1
vo指示HDMI输入的分辨率及帧率取值为480P60、576P50、720P50、720P60、1080P25、1080P30、1080I50、1080P50、1080I60、1080P60、1440P30、2160P30
vo_cvbs指示cvbs输出参数取值为PAL 或 NTSC
vo_source指示是否按源分辨率输出取值为YES 或 NO
vo_rotate指示旋转角度取值为0、90、180、270
vo_scale指示是否按比例旋转1表示按比较，0不按比例
Luma亮度0~100
Contrast对比度0~100
Hue色度0~100
Saturation饱和度
10、 获取设备状态
http://ip/get_version
<?xml version="1.0" encoding="UTF-8"?>
<version>1.45.1</version>
11、 获取硬件信息
http://ip/get_hardware
<?xml version="1.0" encoding="UTF-8"?>
<hardware>
<cpu>Hi3536C</cpu>
<module>XD5.1.45.1</module>
</hardware>
12、 获取裁剪信息
http://ip/get_crop
13、 设置裁剪信息
http://ip/set_crop?
crop0_enable=1|0&crop0_x=&&crop0_y=&&crop0_w=&&crop0_h&
crop1_enable=1|0&crop1_x=&&crop1_y=&&crop1_w=&&crop1_h&
crop1_enable=2|0&crop2_x=&&crop2_y=&&crop2_w=&&crop2_h&
crop1_enable=3|0&crop3_x=&&crop3_y=&&crop3_w=&&crop3_h
注 x,y, w, h均是针对视频原始大小而言的。
14、 设置全单路全屏播放
http://ip/set_full?chn=0|1|2|3|1000
注：http://ip/set_full?chn=0表示显示第一路
http://ip/set_full?chn=1000表示显示4画面
15、 文本OSD设置（具体参数可参考WEB）
GET http://ip/set_osd?osd_0_enable=1&osd_0_t...&osd_3_txt=
osd_0_enable=0|1表示启用|禁用
osd_0_alpha=100 透明度0~100
osd_0_x=10 显示位置，左上角为（0，0）坐标
osd_0_y=10显示位置，左上角为（0，0）坐标
osd_0_font_size=36，字体大小
osd_0_color=0 字体颜色
osd_0_bcolor=0 字体背景色
osd_0_txt=text 文本内容
返回
<?xml version="1.0" encoding="UTF-8"?><return>ok</return>
16、 滚动OSD设置（具体参数可参考WEB）
GET http://ip/set_osd?osd_0_enable=1&osd_0_t...&osd_3_txt=
osd_0_enable=0|1表示启用|禁用
osd_0_alpha=100 透明度0~100
osd_0_x=10 显示位置，左上角为（0，0）坐标
osd_0_y=10滚动速度
osd_0_font_size=36，字体大小
osd_0_color=0 字体颜色
osd_0_bcolor=0 字体背景色
osd_0_txt=text 文本内容
注osd_0..表示第一个，osd_1..表示第二个OSD...
返回
<?xml version="1.0" encoding="UTF-8"?><return>ok</return>
17、 图片OSD设置（具体参数可参考WEB）
GET http://ip/set_osd?osd_0_enable=1&osd_0_t...5593785184 HTTP/1.1
osd_0_alpha=100 透明度0~100
osd_0_x=10 显示位置，左上角为（0，0）坐标
osd_0_y=10显示位置，左上角为（0，0）坐标
osd_0_txt= 显示图片名
返回
<?xml version="1.0" encoding="UTF-8"?><return>ok</return>
18、 通道布局控制
GET
http://ip/set_vopos?&enable=1&voposx0=0&...riority3=0
enable 1表示启用自定义布局 0表示禁用自定义布局
第一路画面位置
voposx0=0 画面x坐标
voposy0=0 画面x坐标
voposw0=424 画面宽度
voposh0=180 画面高度
priority0=0 保留参数无用
其它3路画面参数类似，但设置过程需保证设置后的画面没有重叠。
19、 ndi流地址获取
GET
http://ip/ndifind
返回
<?xml version="1.0" encoding="UTF-8"?>
<discover>
<d>ndi:192.168.20.122 (Stream1)</d>
</discover>
将<d></d>接点地址解析出来，设置到解码地址中即可，参考7设置播放地址
20、 onvif设备列表获取
GET
http://ip/onvifcfind
返回
<?xml version="1.0" encoding="UTF-8"?>
<discover>
<d>http://192.168.20.122/onvif/device_service</d>
<d>http://192.168.20.5/onvif/device_service</d>
<d>http://192.168.20.6/onvif/device_service</d>
<d>http://192.168.20.7/onvif/device_service</d>
</discover>
21、 将20获取到的device_service地址传入如下接口获取媒体地址
GET
http://ip/Onvifcrtsp?device_service=http...d=xc888888
返回
<?xml version="1.0" encoding="UTF-8"?>
<rtsp>rtsp://admin:xc888888@192.168.20.5:554/Streaming/Channels/101?transportmode=mcast&profile=Profile_1</rtsp>
22、 强制重新打开指定通道
GET
http://ip/replay?chn=0
chn取值0，1，2，3分别对应 通道1地址， 通道2地址， 通道3地址， 通道4地址
返回
成功
<?xml version="1.0" encoding="UTF-8"?><return>ok</return>
失败
<?xml version="1.0" encoding="UTF-8"?><return>failed</return>