解码器控制协议V2.0
关于认证
支持基本认证 basic authentication/摘要认证 digest authentication两种认证方式;
如果你对两种认证方式不了解,可通过GET传递user,pass参数方式认证,如http://ip/get_net?user=admin&pass=admin
1、 获取设备地址信息
http://ip/get_net
访问如上地址,设备会以XML形式返回地址信息如下:
192.168.1.169
255.255.255.0
192.168.1.1
00:13:14:15:D7:F4
0
192.168.1.1
8.8.8.8
8080
admin
其实中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
http://192.168.1.168/0.pte
其中wnd表示播放的窗口数,只能取值 1,4;audio指示是否播放对应uri的音频,当为4窗口时,只能一个为1,其它为0;
7、 设置播放列表
http://ip/set_playlist?wnd=1|4&uri0=&uri0_audio=&&uri1=&uri1_audio=&&uri2=&uri2_audio=&&uri3=&uri3_audio=
其中wnd表示播放的窗口数据,只能取值1,4;uri0指示播放地址,uri0_audio取值 为0,1,指示是否播放音频。
注uri0_audio,uri1_audio,uri2_audio,uri3_audio只启用一路音频播放。
8、 获取输出信息
http://ip/get_vo
1080P60
PAL
no
0
50
50
50
50
9、 设置输出信息
http://ip/set_vo?vo=&vo_cvbs=&vo_source=&vo_rotate=&Luma=&Contrast=&Hue=&Saturation=&vo_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
1.45.1
11、 获取硬件信息
http://ip/get_hardware
Hi3536C
XD5.1.45.1
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_type=0&osd_0_alpha=100&osd_0_x=10&osd_0_y=10&osd_0_font_size=36&osd_0_color=0&osd_0_bcolor=0&osd_0_txt=text&osd_1_enable=0&osd_1_type=0&osd_1_alpha=100&osd_1_x=10&osd_1_y=62&osd_1_font_size=36&osd_1_color=0&osd_1_bcolor=0&osd_1_txt=&osd_2_enable=0&osd_2_type=0&osd_2_alpha=100&osd_2_x=10&osd_2_y=114&osd_2_font_size=36&osd_2_color=0&osd_2_bcolor=0&osd_2_txt=&osd_3_enable=0&osd_3_type=0&osd_3_alpha=100&osd_3_x=10&osd_3_y=166&osd_3_font_size=36&osd_3_color=0&osd_3_bcolor=0&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 文本内容
返回
ok
16、 滚动OSD设置(具体参数可参考WEB)
GET http://ip/set_osd?osd_0_enable=1&osd_0_type=2&osd_0_alpha=100&osd_0_x=10&osd_0_y=10&osd_0_font_size=36&osd_0_color=0&osd_0_bcolor=0&osd_0_txt=text&osd_1_enable=0&osd_1_type=0&osd_1_alpha=100&osd_1_x=10&osd_1_y=62&osd_1_font_size=36&osd_1_color=0&osd_1_bcolor=0&osd_1_txt=&osd_2_enable=0&osd_2_type=0&osd_2_alpha=100&osd_2_x=10&osd_2_y=114&osd_2_font_size=36&osd_2_color=0&osd_2_bcolor=0&osd_2_txt=&osd_3_enable=0&osd_3_type=0&osd_3_alpha=100&osd_3_x=10&osd_3_y=166&osd_3_font_size=36&osd_3_color=0&osd_3_bcolor=0&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...
返回
ok
17、 图片OSD设置(具体参数可参考WEB)
GET http://ip/set_osd?osd_0_enable=1&osd_0_type=1&osd_0_alpha=100&osd_0_x=10&osd_0_y=10&osd_0_font_size=36&osd_0_color=0&osd_0_bcolor=0&osd_0_txt=text&osd_1_enable=0&osd_1_type=0&osd_1_alpha=100&osd_1_x=10&osd_1_y=62&osd_1_font_size=36&osd_1_color=0&osd_1_bcolor=0&osd_1_txt=&osd_2_enable=0&osd_2_type=0&osd_2_alpha=100&osd_2_x=10&osd_2_y=114&osd_2_font_size=36&osd_2_color=0&osd_2_bcolor=0&osd_2_txt=&osd_3_enable=0&osd_3_type=0&osd_3_alpha=100&osd_3_x=10&osd_3_y=166&osd_3_font_size=36&osd_3_color=0&osd_3_bcolor=0&osd_3_txt=&&_=1605593785184 HTTP/1.1
osd_0_alpha=100 透明度0~100
osd_0_x=10 显示位置,左上角为(0,0)坐标
osd_0_y=10显示位置,左上角为(0,0)坐标
osd_0_txt= 显示图片名
返回
ok
18、 通道布局控制
GET
http://ip/set_vopos?&enable=1&voposx0=0&voposy0=0&voposw0=424&voposh0=180&priority0=0&voposx1=428&voposy1=0&voposw1=424&voposh1=180&priority1=0&voposx2=854&voposy2=0&voposw2=424&voposh2=180&priority2=0&voposx3=0&voposy3=182&voposw3=1280&voposh3=538&priority3=0
enable 1表示启用自定义布局 0表示禁用自定义布局
第一路画面位置
voposx0=0 画面x坐标
voposy0=0 画面x坐标
voposw0=424 画面宽度
voposh0=180 画面高度
priority0=0 保留参数无用
其它3路画面参数类似,但设置过程需保证设置后的画面没有重叠。
19、 ndi流地址获取
GET
http://ip/ndifind
返回
ndi:192.168.20.122 (Stream1)
将接点地址解析出来,设置到解码地址中即可,参考7设置播放地址
20、 onvif设备列表获取
GET
http://ip/onvifcfind
返回
http://192.168.20.122/onvif/device_service
http://192.168.20.5/onvif/device_service
http://192.168.20.6/onvif/device_service
http://192.168.20.7/onvif/device_service
21、 将20获取到的device_service地址传入如下接口获取媒体地址
GET
http://ip/Onvifcrtsp?device_service=http://192.168.20.7/onvif/device_service&device_usr=admin&device_pwd=xc888888
返回
rtsp://admin:xc888888@192.168.20.5:554/Streaming/Channels/101?transportmode=mcast&profile=Profile_1
22、 强制重新打开指定通道
GET
http://ip/replay?chn=0
chn取值0,1,2,3分别对应 通道1地址, 通道2地址, 通道3地址, 通道4地址
返回
成功
ok
失败
failed