AIDA Imaging HTTP 访问指南
仅适用于 IP 摄像机
2024 年 XNUMX 月修订
本指南旨在帮助用户编写和制作自己的程序以直接连接到我们的相机。这种灵活性有助于增加您的创造力和控制相机的灵活性！
您不必使用本指南即可使用相机。本文档中的设置并非适用于每种型号，只有当型号具有特定功能时，才能访问这些功能。
适用产品清单：
POV：HD-NDI-200、HD3G-NDI-200l、HD-NDI-X20、HD-NDI-CUBE、HD-NDI-IP67、HD-NDI-MINI、HD-NDI-VF、HD-NDI-TF、HD-NDI3-120、HD-NDI3-IP67、UHD-NDI3-300、UHD-NDI3-IP67、超高清-NDI3-X30
云台：PTZ-X12-IP、PTZ-X20-IP、PTZ-NDI-X12、PTZ-NDI-X18、PTZ-NDI-X20、PTZ-NDI3-X20、PTZ4K-NDI-X12、PTZ4K-NDI-X30、PTZ4K12G-FNDI-X30
*NDI® 是 VIZRT AB 的注册商标
1.1 入门
使用本文档时应对http协议及其POST请求方法有一定的了解和掌握。
1.2 语法规则
HTTP 是客户端和服务器端之间请求和响应的标准。使用 web 浏览器， web 爬虫，或者其他工具，客户端向服务器的指定端口发起HTTP请求（默认端口为80），客户端一般称为用户代理程序，服务器响应客户端请求，并将一些资源存储在服务器上，比如HTML file和图像。这种类型的服务器通常称为 Web 服务器。
HTTP Request 请求需要遵循以下指令
所有参数请求都走post方式，通过func获取参数get和设置参数set两种方式区分
设置参数界面
http://cgi-bin/web.fcgi?func=set
获取参数接口
http://cgi-bin/web.fcgi?func=get
1.3 请求与响应简单示例ample
假设我们的摄像头 IP 是 192.168.1.180，根据 1.2 的语法规定
获取参数接口。
http://192.168.1.180/cgi-bin/web.fcgi?func=get
设置界面
http://192.168.1.180/cgi-bin/web.fcgi?func=set
**以前者身份登录请求amp勒**
本次请求是get方法，所以请求设置了接口 url，并以json格式传输内容参数
参数内容
“`
{
“系统”：
{
“登录”：“用户名：密码”，
}
}
“`
json字符串system代表调用主函数，login代表调用参数。user:password代表传入的参数。
例如ample，如果当前摄像机账号和密码均为admin，则最终传输格式为
“`
{
“系统”：
{
“登录”：“管理员：管理员”，
}
}
“`
返回内容是请求完成后返回的，根据调用函数的方法不同，返回内容返回不同的参数，login方法返回如下json内容
成功返回
“`
{
“状态”：真
“系统”：
{
“登录”：int
}
}
“`
无法返回
“`
{
“状态”：false
“系统”：
{
“登录”：false
}
}
“`
其中 status 是函数调用的状态，true 表示成功，false 表示失败。
返回格式跟请求格式一致，system是调用main函数，login是调用返回key
注意：除了login之外，其他任何命令交互都必须传递一个key，语法为“key”:int，“key”后面附加的int的值就是“login”操作返回的值
**以网络接口为例amp勒**
网络参数接口有两个，分别是获取网络接口参数和设置网络接口参数。从上面的例子中ample，可以看出
获取参数接口。
http://192.168.1.180/cgi-bin/web.fcgi?func=get
设置接口
http://192.168.1.180/cgi-bin/web.fcgi?func=set
**获取网络参数**
“`
{
“key”：“登录界面中登录字段对应的值”，
“以太网”：{“eth0”：true}
}
“`
这个请求的意思是：我要调用获取以太网eth0下的所有参数。
正常退货：
“`
{
“状态”：true，
“以太网”：
{
“eth0”：{
“dhcp”:int, //0 手动 1 自动
“IP地址”：“192.168.1.155”，
“网络掩码”：“192.168.1.1”，
“网关”：“192.168.1.1”，
“DNS”：“192.168.1.1”，
“httpPort”：int，
“web端口”:int,
“rtsp端口”：int，
“rtmp端口”：int
}
}
“`
当接口正常时，即status为ture时，获取网络所有接口参数
**设置网络参数**
“`
{
“key”：“登录界面中登录字段对应的值”，
“以太网”：
{
“eth0”：{
“dhcp”:int //0 手动 1自动
“IP地址”：“192.168.1.155”，
“网络掩码”：“192.168.1.1”，
“网关”：“192.168.1.1”，
“DNS”：“192.168.1.1”，
“mac”:”01:23:45:67:89:ab”,
“httpPort”：int，
“web端口”:int,
“rtsp端口”：int，
“rtmp端口”：int
}
}
}
“`
设置成功则返回json字符串
“`
{
“状态”：true，
“以太网”：
{
“eth0”：{
“dhcp”:int //0 手动 1 自动
“IP地址”：“192.168.1.155”，
“网络掩码”：“192.168.1.1”，
“网关”：“192.168.1.1”，
“DNS”：“192.168.1.1”，
“mac”:”01:23:45:67:89:ab”
“httpPort”：int，
“web端口”:int,
“主要amP“ort”：int，
“subStreamP“位置”：int
“rtsp端口”：int
“rtmp端口”：int
}
}
“`
1.4 测试描述
可以下载邮递员进行协议测试（https://www.getpostman.com/downloads/).
该软件的使用方法可参见随附的视频说明。
2 视频编码设置
2.1 编码参数设置
放
要求
{
“键”：int，
“venc”：{
“主要的”：{
“启用”：int，
“mode”:“h264”, //“h264”、“h265”、“mjpeg”
“col”:3840, //int
“line”:2160, //int
“比特率”:115200,//int
“frmrate”:30, //int
“rcmode”:“cbr”, //“cbr”、“vbr”
“亲file”:”MP”, //”baseline”、”MP”、”HP”
“间隔”:30//int
},
“子”：{
“启用”：int，
“模式”:”h264”，
“col”：1280，
“line”:720，
“比特率”：4096，
“frmrate”:30，
“rc模式”：“cbr”，
“亲file”:”MP”, //”baseline”、”MP”、”HP”
“间隔”：30
}
}
}
回复
设置成功，返回最新的编码参数
{
“状态”：真
“venc”：{
“主要的”：{
“启用”：int，
“模式”:”h264”，
“col”：3840，
“line”:2160，
“比特率”：115200，
“frmrate”:30，
“rc模式”：“cbr”，
“亲file”：“国会议员”，
“间隔”：30
},
“子”：{
“启用”：int，
“模式”:”h264”，
“col”：1280，
“line”:720，
“比特率”：4096，
“frmrate”:30，
“rc模式”：“cbr”，
“亲file”：“国会议员”，
“间隔”：30
}
}
}
不支持编码配置
{
“状态”：false
“venc”：false
}
不支持主流或子流
{
“状态”：false
“venc”：{“主”：假，子”：假}
}
参数错误
{
“状态”：false
“venc”：{“main”：false}
}
2.2 编码参数获取
得到
要求
{
“键”：int，
“venc”：{“主”：true，“sub”：true}
}
Or
{
“键”：int，
“venc”：{
“主要的”：{
“启用”:true，
“模式”:true，
“col”:true，
“line”:true，
“比特率”:true，
“帧速率”:true，
“rcmode”:true，
“亲file“：真的，
“间隔”:true，
“rtspUrl“：真的
“rtmpUrl“：真的
},
“子”：{
“启用”:true，
“模式”:true，
“col”:true，
“line”:true，
“比特率”:true，
“帧速率”:true，
“rcmode”:true，
“亲file“：真的，
“间隔”:true，
“rtspUrl“：真的
“rtmpUrl“：真的
}
}
}
回复
{
“状态”：true，
“venc”：{
“主要的”：{
“启用”：int，
“模式”:”h264”，
“col”：3840，
“line”:2160，
“比特率”：115200，
“frmrate”:30，
“rc模式”：“cbr”，
“亲file”：“国会议员”，
“间隔”：30，
“rtspUrl”:”rtsp://192.168.1.155:554/stream/main”
“rtmpUrl”:”rtmp://192.168.1.155:1935/app/rtmpstream0″
},
“子”：{
“启用”：int，
“模式”:”h264”，
“col”：1280，
“line”:720，
“比特率”：4096，
“frmrate”:30，
“rc模式”：“cbr”，
“亲file”：“国会议员”，
“间隔”：30，
“rtspUrl”:”rtsp://192.168.1.155:554/stream/sub”
“rtmpUrl”:”rtmp://192.168.1.155:1935/app/rtmpstream1″
}
}
}
不支持编码配置
{
“状态”：false，
“venc”:false，
}
不支持主流或子流
{
“状态”：false，
“venc”：{“main”：false}
}
3 音频编码
3.1 音频编码设置
放
要求
{
“键”：int，
“声音的”：{
“启用”：int，
“Samp容忍”:int,
“位宽”：int，
“soundMode”:”Mono”, //”单声道”、”立体声”
“编码模式”：“G711A”，
//”G711A”、”G711U”、”ADPCMA”、”G726″、”LPCM”、”AAC”
“比特率”:int //Bps
8000、16000、22000、24000、32000、48000、64000、96000、128000、256000、320000
}
}
回复
设置成功，返回最新的音频编码参数
{
“状态”：true，
“声音的”：{
“启用”：int，
“Samp容忍”:int,
“位宽”：int，
“声音模式”：“单声道”，
“编码模式”：“G711A”，
“比特率”：int
}
}
不支持编码配置或参数错误
{
“状态”：false，
“音频”：false
}
3.2 音频编码参数获取
得到
要求
{
“键”：int，
“音频”：真
}
Or
{
“键”：int，
“声音的”：{
“启用”：真，
“Samp容忍”:true，
“位宽”：true，
“声音模式”：真，
“encMode”：真，
“比特率”：true
}
}
设置成功，返回最新的音频编码参数
{
“状态”：true，
“声音的”：{
“启用”：int，
“Samp容忍”:int,
“位宽”：int，
“声音模式”：“单声道”，
“编码模式”：“G711A”，
“比特率”：int
}
}
无法获取或不支持更改命令
{
“状态”：false，
“音频”：false
}
4 网络设置
4.1 网络参数设置
放
要求
{
“键”：int，
“以太网”：
{
“eth0”：{
“dhcp”:int //0 手动 1 自动
“IP地址”：“192.168.1.155”，
“网络掩码”：“192.168.1.1”，
“网关”：“192.168.1.1”，
“DNS”：“192.168.1.1”，
“mac”:”01:23:45:67:89:ab”
“httpPort”：int，
“rtsp端口”：int
“rtmp端口”：int
}
}
}
不支持网络设置
{
“状态”：false，
“以太网”：false，
}
eth0不存在或不支持配置。
{
“状态”：false，
“以太网”：{“eth0”：false}
}
部分网络参数设置失败。
{
“状态”：false，
“以太网”：
{
“eth0”：{
“dhcp”:int //0 手动 1 自动
“IP地址”：false，
“网络掩码”：“192.168.1.1”，
“网关”：false，
“DNS”：“192.168.1.1”，
“mac”:”01:23:45:67:89:ab”,
“httpPort”：int，
“rtsp端口”：int，
“rtmp端口”：int
}
}
}
设置成功
{
“状态”：true，
“以太网”：
{
“eth0”：{
“dhcp”:int //0 手动 1自动
“IP地址”：“192.168.1.155”，
“网络掩码”：“192.168.1.1”，
“网关”：“192.168.1.1”，
“DNS”：“192.168.1.1”，
“mac”:”01:23:45:67:89:ab”
“httpPort”：int，
“rtsp端口”：int，
“rtmp端口”：int
}
}
4.2 网络参数获取
得到
要求：
{
“键”：int，
“以太网”：{“eth0”：true}
}
or
{
“键”：int，
“以太网”：
{
“eth0”：{
“DHCP”:true，
“IP地址”:true，
“网络掩码”:true，
“网关”:true，
“DNS”:true，
“mac”:true，
“http端口”:true，
“rtsp端口”：true
“rtmp端口”：true
}
}
}
回复
{
“状态”：true，
“以太网”：
{
“eth0”：{
“dhcp”:int // 0 手动 1 自动
“IP地址”：“192.168.1.155”，
“网络掩码”：“192.168.1.1”，
“网关”：“192.168.1.1”，
“DNS”：“192.168.1.1”，
“httpPort”：int，
“rtsp端口”：int
“rtmp端口”：int
}
}
不支持网络参数获取
{
“状态”：false，
“以太网”：false，
}
eth0不存在或不支持配置。
{
“状态”：false，
“以太网”：{“eth0”：false}
}
获取部分网络参数失败。
{
“状态”：false，
“以太网”：
{
“eth0”：{
“dhcp”:int // 0 手动 1 自动
“IP地址”：false，
“网络掩码”：“192.168.1.1”，
“网关”：false，
“DNS”：“192.168.1.1”，
“httpPort”：int，
“rtsp端口”：int
“rtmp端口”：int
}
}
}
5 图像控制
5.1 图像参数设置
放：
要求
{
“键”：int，
“图像”：
{
“focus_mode”:”auto”, //”自动”，”手动”
“焦点距离”：“1.5米”，//”1.5米”，“2米”，“3米”，“6米”，“10米”
“exposure_mode”:”auto”, //”自动”，”手动”，”光圈优先”，”快门优先”，”亮度优先”
“shutter”:int //60/30bpf 5:1/30 6:1/60 7:1/90 8:1/100 9:1/125 10:1/180 11:1/250 12:1/350 13:1/500 14:1/725 15:1/1000 16:1/1500 17:1/2000 18:1/3000 19:1/4000 20:1/6000 21:1/10000
//50/25bpf 5:1/25 6:1/50 7:1/75 8:1/100 9:1/120 10:1/150 11:1/215 12:1/300 13:1/425 14:1/600 15:1/1000 16:1/1250 17:1/1750 18:1/2500 19:1/3500 20:1/6000 21:1/10000
“anti_flicker”:int,//0:1:50Hz 2:60Hz
“曝光亮度”：int，//0~27
“虹膜”：int，//0~13
“增益”:int, //0~15
“WB_mode”:”auto” //”自动”，”室内”，”室外”，”一键”，”自动跟踪”，”手动”
“R_gain”:int,//0~255
“B_gain”:int, //0~255
“镜像”：int
“翻转”：int，
“背光补偿”：int，
“伽马”：int，//0~4
“数字变焦启用”：int，
“WDR_enable”：int，
“WDR_level”:int, //1~6
“亮度”:int,//0~15
“清晰度”：int，//0~15
“对比度”：int，//0~15
“饱和度”:int, //0~15
“DC_iris”:int, //0:关闭 1:打开
“降噪_2D”：int，
“noise_reduction_3D”:int, //0 自动 1:级别 1 2:级别 2 3:级别 3 4:级别 4 5:禁用
“vo_resolution”：“1920X1080P@60Hz”
“图像重置”：int
“zoom”:[type,speed] //类型 0 缩放停止 1 放大 2 缩小 速度：0~7
“focus”:[type,speed] //类型 0 对焦停止 1 对焦近 2 对焦远 speed:0~7
“ptz”:[type,speed] //类型 0 ptz 停止 1 上 2 下 3 左 4 右 5 回家 6 重置 7 上+左 8 下+左 9 上+右 10 下+右 速度：0~0x18
“预设”：{“添加”：int，“删除”：int，“调用”：int，“检查”：int}
“snap”:int //图像捕捉；=1启用，捕捉成功返回true，失败返回false
“绝对控制”：
{
“缩放”：int，
“焦点”：int，
“pan”：int，
“倾斜”：int
}
}
}
回复
{
“状态”：真
“图像”：
{
“focus_mode”:”auto”, //”自动”，”手动”
“焦点距离”：“1.5米”，//”1.5米”，“2米”，“3米”，“6米”，“10米”
“exposure_mode”:”auto”, //”自动”，”手动”，”光圈优先”，”快门优先”，”亮度优先”
“shutter”:int //60/30bpf 5:1/30 6:1/60 7:1/90 8:1/100 9:1/125 10:1/180 11:1/250 12:1/350 13:1/500 14:1/725 15:1/1000 16:1/1500 17:1/2000 18:1/3000 19:1/4000 20:1/6000 21:1/10000
//50/25bpf 5:1/25 6:1/50 7:1/75 8:1/100 9:1/120 10:1/150 11:1/215 12:1/300 13:1/425 14:1/600 15:1/1000 16:1/1250 17:1/1750 18:1/2500 19:1/3500 20:1/6000 21:1/10000
“anti_flicker”:int, //0:关闭 1:50Hz 2:60Hz
“曝光亮度”：int，//0~27
“虹膜”：int，//0~13
“增益”:int, //0~15
“WB_mode”:”auto” //”自动”，”室内”，”室外”，”一键”，”自动跟踪”，”手动”
“R增益”：int，//0~255
“B增益”：int，//0~255
“镜像”：int
“翻转”：int，
“背光补偿”：int，
“gamma”：int，//int
“数字变焦启用”：int，
“WDR_enable”：int，
“WDR_level”:int, //1~6
“亮度”:int,//0~15
“清晰度”：int，//0~15
“对比度”：int，//0~15
“饱和度”:int, //0~15
“DC_iris”:int, // 0: 关闭 1: 打开
“降噪_2D”：int，
“noise_reduction_3D”:int, //0 自动 1:级别 1 2:级别 2 3:级别 3 4:级别 4 5:禁用
“vo_resolution”：“1920X1080P@60Hz”
“图像重置”：true
“缩放”：真
“焦点”：真
“云台”：真
“预设”：真
“快照”：真
“绝对控制”：真
}
}
如果失败，则相应的子段落设置为 false，例如ample
{
“状态”：false
“图像”：
{
“focus_mode”:”auto”, //”自动”，”手动”
“焦点距离”：false，
“exposure_mode”:”auto”, //”自动”，”手动”，”光圈优先”，”快门优先”，”亮度优先”
“shutter”:int //60/30bpf 5:1/30 6:1/60 7:1/90 8:1/100 9:1/125 10:1/180 11:1/250 12:1/350 13:1/500 14:1/725 15:1/1000 16:1/1500 17:1/2000 18:1/3000 19:1/4000 20:1/6000 21:1/10000
//50/25bpf 5:1/25 6:1/50 7:1/75 8:1/100 9:1/120 10:1/150 11:1/215 12:1/300 13:1/425 14:1/600 15:1/1000 16:1/1250 17:1/1750 18:1/2500 19:1/3500 20:1/6000 21:1/10000
“anti_flicker”:int, //0:关闭 1:50Hz 2:60Hz
“曝光亮度”：false，
“虹膜”：int，//0~13
“增益”:int, //0~15
“WB_mode”:”auto” //”自动”，”室内”，”室外”，”一键”，”自动跟踪”，”手动”
“R增益”：int，//0~255
“B增益”：int，//0~255
“镜像”：false，
“翻转”：int，
“背光补偿”：int，
“gamma”：int，//int
“数字变焦启用”：int，
“WDR_enable”：int，
“WDR_level”:int, //1~6
“亮度”:int,//0~15
“清晰度”：int，//0~15
“对比度”：int，//0~15
“饱和度”:int, //0~15
“降噪_2D”：int，
“noise_reduction_3D”:int, //0 自动 1:级别 1 2:级别 2 3:级别 3 4:级别 4 5:禁用
“vo_resolution”：“1920X1080P@60Hz”
“图像重置”：true，
“缩放”：真，
“焦点”：真，
“ptz”:真，
“预设”：false，
“快照”：false
“绝对控制”：false
}
}
5.2 图像参数获取
得到
要求
{
“键”：int，
“图像”：{
“焦点模式”：true，
“焦点距离”：true，
“曝光模式”：true，
“快门”：真，
“防闪烁”：真，
“曝光亮度”：true，
“虹膜”：真，
“增益”：真，
“WB_mode”：真，
“R_gain”：真，
“B_gain”：真，
“镜子”：真，
“翻转”：真，
“背光补偿”：true，
“伽马”：真，
“数字变焦启用”：true，
“WDR_enable”:真，
“WDR_level”：真，
“亮度”：真，
“锐度”：真，
“对比度”：真实，
“饱和度”：真，
“DC_iris”：真，
“噪声降低_2D”：真，
“噪声降低_3D”：真，
“vo_resolution”：真，
“vo_support”: true, 复制代码
“帧速率”：true，
“预设”：int
“缩放”：真，
“焦点”：真，
“pan”:真，
“倾斜”：真
}
}
回复
获取成功，返回相对值
{
“状态”：真
“图像”：
{
“focus_mode”:”auto”, //”自动”，”手动”
“焦点距离”：“1.5米”，//”1.5米”，“2米”，“3米”，“6米”，“10米”
“exposure_mode”:”auto”, //”自动”，”手动”，”光圈优先”，”快门优先”，”亮度优先”
“shutter”:int //60/30bpf 5:1/30 6:1/60 7:1/90 8:1/100 9:1/125 10:1/180 11:1/250 12:1/350 13:1/500 14:1/725 15:1/1000 16:1/1500 17:1/2000 18:1/3000 19:1/4000 20:1/6000 21:1/10000
//50/25bpf 5:1/25 6:1/50 7:1/75 8:1/100 9:1/120 10:1/150 11:1/215 12:1/300 13:1/425 14:1/600 15:1/1000 16:1/1250 17:1/1750 18:1/2500 19:1/3500 20:1/6000 21:1/10000
“anti_flicker”:int, //0:关闭 1:50Hz 2:60Hz
“曝光亮度”：int，//0~27
“虹膜”：int，//0~13
“增益”:int, //0~15
“WB_mode”：“auto” //“自动”，“室内”，“室外”，“一键式”，“自动跟踪”，“手动”，“钠”，“荧光”
“R_gain”:int,//0~255
“B_gain”:int, //0~255
“镜像”：int
“翻转”：int，
“背光补偿”：int，
“gamma”：int，//int
“数字变焦启用”：int，
“WDR_enable”：int，
“WDR_level”:int, //1~6
“亮度”:int,//0~15
“清晰度”：int，//0~15
“对比度”：int，//0~15
“饱和度”:int, //0~15
“DC_iris”:int, // 0: 关闭 1: 打开
“降噪_2D”：int，
“noise_reduction_3D”:int, //0 自动 1:级别 1 2:级别 2 3:级别 3 4:级别 4 5:禁用
“vo_resolution”：“1920X1080P@60Hz”
“vo_support”:int //bit[0]1920X1080P@25Hz bit[1]1920X1080P@50Hz bit[2]1920X1080P@30Hz bit[3]1920X1080P@60Hz bit[4]1280x720P@25Hz bit[5]1280x720P@50Hz bit[6]1280x720P@30Hz bit[7]1280x720P@60Hz
//bit[8]3840X2160P@25Hz bit[9]3840X2160P@30Hz bit[10]1920X1080I@50Hz bit[11]1920X1080I@60Hz bit[12]1920X1080P@59.94Hz bit[13]1920X1080P@29.97Hz bit[15]1280x720P@59.94Hz bit[16]1280x720P@29.97Hz
“帧速率”：int
“preset”:int //0 存在 1 不存在
“缩放”：0，
“焦点”：4000，
“平移”：0，
“倾斜”：0
}
}
如果失败，则相对于子项设置为 false，例如：
{
“状态”：false
“图像”：
{
“focus_mode”:”auto”, //”自动”，”手动”
“焦点距离”：“1.5米”，//”1.5米”，“2米”，“3米”，“6米”，“10米”
“exposure_mode”:”auto”, //”自动”，”手动”，”光圈优先”，”快门优先”，”亮度优先”
“shutter”:int //60/30bpf 5:1/30 6:1/60 7:1/90 8:1/100 9:1/125 10:1/180 11:1/250 12:1/350 13:1/500 14:1/725 15:1/1000 16:1/1500 17:1/2000 18:1/3000 19:1/4000 20:1/6000 21:1/10000
//50/25bpf 5:1/25 6:1/50 7:1/75 8:1/100 9:1/120 10:1/150 11:1/215 12:1/300 13:1/425 14:1/600 15:1/1000 16:1/1250 17:1/1750 18:1/2500 19:1/3500 20:1/6000 21:1/10000
“anti_flicker”:int, //0:关闭 1:50Hz 2:60Hz
“曝光亮度”：int，//0~27
“虹膜”：int，//0~13
“增益”:int, //0~15
“WB_mode”：false，
“R_gain”：false，
“B_gain”：false，
“镜像”：false，
“翻转”：int，
“背光补偿”：int，
“gamma”：int，//int
“数字变焦启用”：int，
“WDR_enable”：int，
“WDR_level”:int, //1~6
“亮度”:int,//0~15
“清晰度”：int，//0~15
“对比度”：int，//0~15
“饱和度”:int, //0~15
“降噪_2D”：int，
“noise_reduction_3D”:int, //0 自动 1:级别 1 2:级别 2 3:级别 3 4:级别 4 5:禁用
“vo_resolution”：“1920X1080P@60Hz”
“vo_support”:int //bit[0]1920X1080P@25Hz bit[1]1920X1080P@50Hz bit[2]1920X1080P@30Hz bit[3]1920X1080P@60Hz bit[4]1280x720P@25Hz bit[5]1280x720P@50Hz bit[6]1280x720P@30Hz bit[7]1280x720P@60Hz
//bit[8]3840X2160P@25Hz bit[9]3840X2160P@30Hz bit[10]1920X1080I@50Hz bit[11]1920X1080I@60Hz bit[12]1920X1080P@59.94Hz bit[13]1920X1080P@29.97Hz bit[15]1280x720P@59.94Hz bit[16]1280x720P@29.97Hz
“帧速率”：int
“预设”：false
}
}
6 RTMP 流媒体
6.1 RTMP推流参数设置
放
要求
{
“键”：int，
“rtmp”:{
“主要的”：{
“启用”：int，
“url”:”rtmp://192.168.1.118:1935/app/rtmpstream2″,
},
“子”：{
“启用”：int，
“url”:”rtmp://192.168.1.118:1935/app/rtmpstream3″,
}
}
}
回复
设置成功，返回最新的编码参数
{
“状态”：真
“rtmp”:{
“主要的”：{
“启用”：int，
“url”:”rtmp://192.168.1.118:1935/app/rtmpstream2″,
“status”:int, //0 推流失败 1 推流成功
},
“子”：{
“启用”：int，
“url”:”rtmp://192.168.1.118:1935/app/rtmpstream3″,
“status”:int, //0 推流失败 1 推流成功
}
}
}
不支持 RTMP 推流配置
{
“状态”：false
“rtmp”：false
}
不支持主码流或子码流配置
{
“状态”：false，
“rtmp”:{“main”:false,sub”:false}
}
参数错误
{
“状态”：false，
“rtmp”：{“main”：false}
}
6.2 RTMP推流参数获取
得到
要求
{
“键”：int，
“rtmp”：{“main”：true，“sub”：true}
}
or
{
“键”：int，
“rtmp”:{
“主要的”：{
“启用”:true，
“url“：真的，
},
“子”：{
“启用”:true，
“url“：真的，
},
}
}
回复
{
“状态”：true，
“rtmp”:{
“主要的”：{
“启用”：int，
“url”:”rtmp://192.168.1.118:1935/app/rtmpstream2″,
“status”:int, //0 推流失败 1 推流成功
},
“子”：{
“启用”：int，
“url”:”rtmp://192.168.1.118:1935/app/rtmpstream3″,
“status”:int, //0 推流失败 1 推流成功
}
}
}
不支持 RTMP 推流配置
{
“状态”：false
“rtmp”：false
}
不支持主码流或子码流配置
{
“状态”：false，
“rtmp”:{“main”:false,sub”:false}
}
参数错误
{
“状态”：false，
“rtmp”：{“main”：false}
}
7 系统控制
7.1 系统控制设置
放
要求：
{
“键”：int，
“系统”：
{
“system_control”:”image reset”,//”image_reset” 图像参数重置，“factory_reset” 恢复出厂设置，“system_reboot” 系统重启
“登录”：“用户名：密码”，
}
}
回复：
设置成功
要求：
{
“状态”：真
“系统”：
{
“系统控制”：真
“login”:int //返回一个key值，所有json交互都必须包含“key”:int项，否则命令不会响应
}
}
安装失败
{
“状态”：false
“系统”：
{
“系统控制”：false
“登录”：false
}
}
7.2 系统控制采集
得到：
要求：
{
“键”：int，
“系统”：
{
“设备名称”：true，
“序列号”：true，
“bootloader_version”：true，
“系统版本”：true，
“应用程序版本”：true，
“硬件版本”：true
“登录”：“用户名：密码”
}
}
回复：
收购成功
{
“状态”：真
“系统”：
{
“device_name”：“FHD 视频会议摄像头”，
“序列号”：“123456789”，
“bootloader_version”：“V1.0.0”，
“系统版本”：“V1.0.0”，
“应用程序版本”：“V1.0.0”
“硬件版本”：“V1.0.0”
“login”:int //返回一个key值，所有json交互都必须包含“key”:int项，否则命令不会响应
}
}
获取失败
{
“状态”：false
“系统”：
{
“设备名称”:false，
“序列号”：“123456789”，
“bootloader_version”：“V1.0.0”，
“系统版本”：“V1.0.0”，
“应用程序版本”：“V1.0.0”
}
}
7.3 浏览器控制
支持浏览器地址栏端控制和查询摄像机参数，语法与上面的语法相同，区别在于无需登录认证，也就是不需要按键或者登录那项操作直接按照命令设置的控制即可。
Example 1：查询版本号
http://192.168.1.189/cgi-bin/web.fcgi?func=get{“system”:{“app_version”:true}}
Example 2：设置缩放绝对位置
http://192.168.1.189/cgi-bin/web.fcgi?func=set{“image”:{“abs ctrl”:{“zoom”:0}}}
Examp第三步：查询ptz位置
8. 自动跟踪（如果可用）
8.1 自动跟踪参数获取
得到：
要求
{
“ai”：真
}
or
{
“人工智能”：{
“启用”：真，
“peoplePos”: true,
“peopleRation”: true，
“switchTime”：true，
“boardDetectEn”: true,
“highLightTarget”：true，
“缩放锁定”：true，
“PTLimit”：真
}
}
获取成功，返回最新参数
{
“人工智能”： {
“启用”：1，
“peoplePos”: 2,
“人数比例”：6，
“切换时间”: 20,
“boardDetectEn”: 1,
“highLightTarget”：0，
“缩放锁定”：1，
“PTLimit”： 1
},
“状态”：真
}
不支持或者参数异常
{
“状态”：false，
“ai”：假
}
特殊预置位定义：
预置点号255：守望台位置；
预置点号254：右下限位；
预置点号253：左上极限位置；
预置号252：黑板位置
9 NDI 设置
9.1 NDI 参数设置
要求
{
“NDI”:{
“启用”：int，
“设备名称”：“HX”，
“频道名称”：“频道1”，
“群组”：“公开”，
“多播”：{
“启用”：0，
“IP”：“239.255.0.0”，
“掩码”：“255.255.0.0”，
“TTL”：1
},
“发现服务器”：“192.168.1.42”
}
}
回复
设置成功，NDI参数改变。
{
“NDI”:{
“启用”：1，
“设备名称”：“HX”，
“频道名称”：“频道1”，
“群组”：“公开”，
“多播”：{
“启用”：0，
“IP”：“239.255.0.0”，
“掩码”：“255.255.0.0”，
“TTL”：1
},
“发现服务器”：“192.168.1.42”
},
“状态”：真
}
不支持 NDI 配置
{
“状态”：false
“NTP”：假
}
参数错误
{
“NDI”:{
“启用”：1，
“设备名称”：“HX”，
“频道名称”：“频道1”，
“群组”：“公开”，
“多播”：{
“启用”：0，
“IP”：“239.255.0.0”，
“掩码”：“255.255.0.0”，
“TTL”：1
},
“发现服务器”：false
},
“状态”：false
}
9.2 NDI参数获取
要求
{
“NDI”:{
“启用”：真，
“设备名称”:true,
“频道名称”:true,
“群组”：true，
“多播”：true，
“发现服务器”：true
}
}
或
{
“NDI”：真实
}
回复
{
“NDI”:{
“启用”：1，
“设备名称”：“HX”，
“频道名称”：“频道1”，
“群组”：“公共”
“多播”：{
“启用”：0，
“IP”：“239.255.0.0”，
“掩码”：“255.255.0.0”，
“TTL”：1
},
“发现服务器”：“192.168.1.42”，
},
“状态”：真
}
不支持 NDI
{
“状态”：false
“NDI”：假
}
10 SRT 设置
10.1 SRT 参数
要求
{
“SRT”:{
“mode”:”listen”, //”listen”、”caller”、”rendezvous”
“听”：
{
“启用”：int，
“端口”：int，
“latency”:int, // 毫秒
“加密”：int，
“密钥长度”: int, //32、24、16
“密钥”：“012345678”，
}
}
}
or
{
“SRT”:{
“mode”:”caller”, //”listen”、”caller”、”rendezvous”
“主要呼叫者”：
{
“启用”：int，
“IP地址”：“192.168.1.158”，
“端口”：int，
“latency”:int, //毫秒
“加密”：int，
“密钥长度”: int, //32、24、16
“密钥”：“012345678eee”，
“streamid”：“r=0”
},
“子调用者”：
{
“启用”：int，
“IP地址”：“192.168.1.158”，
“端口”：int，
“latency”:int, //毫秒
“streamid”：“r=0”
“加密”：int，
“密钥长度”: int, //32、24、16
“密钥”：“012345678eee”，
“streamid”：“r=1”
}
}
}
or
{
“SRT”:{
“mode”:”rendezvous”, //”listen”、”caller”、”rendezvous”
“主要会合地点”：
{
“启用”：int，
“IP地址”：“192.168.1.158”，
“端口”：int，
“latency”:int, //毫秒
“加密”：int，
“密钥长度”: int, //32、24、16
“密钥”：“012345678eee”，
“streamid”：“r=0”
},
“子会合点”：
{
“启用”：int，
“IP地址”：“192.168.1.158”，
“端口”：int，
“latency”:int,//毫秒
“streamid”：“r=0”
“加密”：int，
“密钥长度”: int, //32、24、16
“密钥”：“012345678eee”，
“streamid”：“r=1”
}
}
}
回复
设置成功，SRT参数已改变
{
“SRT”:{
“模式”：“监听”，
“听”：
{
“启用”：1，
“端口”：1600，
“延迟”：120，
“加密”：1，
“密钥长度”：32，
“密钥”：“012345678eee”，
“主要的 url”:”srt://192.168.1.158:1600?streamid=r=0″,
“子 url”:”srt://192.168.1.158:1600?streamid=r=1″,
}
},
“状态”：真
}
or
{
“SRT”:{
“模式”：“呼叫者”，
“主要呼叫者”：
{
“启用”：1，
“IP地址”：“192.168.1.158”，
“端口”：1600，
“延迟”：120，
“加密”：1，
“密钥长度”：32，
“密钥”：“012345678eee”，
“streamid”：“r=0”
},
“子调用者”：
{
“启用”：1，
“IP地址”：“192.168.1.158”，
“端口”：1600，
“延迟”：120，
“加密”：1，
“密钥长度”：32，
“密钥”：“012345678eee”，
“streamid”：“r=1”
}
},
“状态”：真
}
不支持SRT/参数错误
{
“状态”：false
“SRT”：假
}
10.2 SRT参数获取
要求
{
“SRT”：真
}
回复
{
“SRT”:{
“模式”：“监听”，
“听”：
{
“启用”：1，
“端口”：1600，
“延迟”：120，
“加密”：1，
“密钥长度”：32，
“密钥”：“012345678eee”，
“主要的 url”:”srt://192.168.1.158:1600?streamid=r=0″,
“子 url”:”srt://192.168.1.158:1600?streamid=r=1″,
}
},
“状态”：真
}
or
{
“SRT”:{
“模式”：“呼叫者”，
“主要呼叫者”：
{
“启用”：1，
“IP地址”：“192.168.1.158”，
“端口”：1600，
“延迟”：120，
“加密”：1，
“密钥长度”：32，
“密钥”：“012345678eee”，
“streamid”：“r=0”
},
“子调用者”：
{
“启用”：1，
“IP地址”：“192.168.1.158”，
“端口”：1600，
“延迟”：120，
“加密”：1，
“密钥长度”：32，
“密钥”：“012345678eee”，
“streamid”：“r=1”
}
},
“状态”：真
}
or
{
“SRT”:{
“模式”：“会合”，
“主要会合地点”：
{
“启用”：1，
“IP地址”：“192.168.1.158”，
“端口”：1600，
“延迟”：120，
“加密”：1，
“密钥长度”：32，
“密钥”：“012345678eee”，
“streamid”：“r=0”
},
“子会合”：
{
“启用”：1，
“IP地址”：“192.168.1.158”，
“端口”：1600，
“延迟”：120，
“加密”：1，
“密钥长度”：32，
“密钥”：“012345678eee”，
“streamid”：“r=1”
}
},
“状态”：真
}
不支持 SRT
{
“状态”：false
“SRT”：假
}
文件/资源
 |
AIDA 图像 HTTP 访问 [pdf] 用户指南 HD-NDI-200、HD3G-NDI-200l、HD-NDI-X20、HD-NDI-CUBE、HD-NDI-IP67、HD-NDI-MINI、HD-NDI-VF、HDNDI-TF、HD-NDI3-120、HD-NDI3-IP67、UHD-NDI3-300、UHD-NDI3-IP67、 UHD-NDI3-X30、PTZ-X12-IP、PTZ-X20-IP、PTZ-NDI-X12、PTZ-NDI-X18、PTZ-NDI-X20、PTZ-NDI3-X20、PTZ4K-NDI-X12、PTZ4KNDI-X30、 PTZ4K12G-FNDI-X30., 成像 HTTP 访问, HTTP 访问, 访问 |
