set-ndi-config 接口
设置 NDI 配置信息。
请求方式
GET http://ip/mwapi?method=set-ndi-config¶m1=value1¶m2=value2...
返回数据
{
"status": 0
}
| 属性 |
说明 |
| status |
返回状态。0：设置成功，返回其它值请参考 API 状态码。 |
接口示例
1. NDI 状态设置
http://ip/mwapi?method=set-ndi-config&enable=true
| 参数 |
说明 |
| method |
方法名称：set-ndi-config |
| enable |
NDI 开启状态，有效值：true/false。 |
2. 视频源设置
http://ip/mwapi?method=set-ndi-config&source-name=%23%25board-id%25+(%25serial-no%25)+ab&group-name=public
| 参数 |
说明 |
| method |
方法名称：set-ndi-config |
| source-name |
视频源名称，当前可用变量为：%board-id%、%serial-no%。 |
| group-name |
组名称，当属于多个组时，用英文逗号隔开 (如：public,test,...) 。 |
3. 传输模式设置
http://ip/mwapi?method=set-ndi-config&enable-mcast=false&enable-tcp=false&enable-udp=false&enable-rudp=true&mcast-addr=239.255.0.0&mcast-mask=255.255.0.0&mcast-ttl=4
| 参数 |
说明 |
| method |
方法名称：set-ndi-config |
| enable-mcast |
UDP（组播）开启状态，有效值：true/false。 |
| enable-rudp |
RUDP（单播）开启状态，有效值：true/false。 |
| enable-tcp |
TCP（多连接）开启状态，有效值：true/false。 |
| enable-udp |
UDP（单播）开启状态，有效值：true/false。 |
| mcast-addr |
UDP（组播）地址，enable-mcast=true 时生效。 |
| mcast-mask |
UDP（组播）掩码，enable-mcast=true 时生效。 |
| mcast-ttl |
UDP（组播）生存时间，enable-mcast=true 时生效，有效值：1 ~ 255。 |
enable-mcast、enable-rudp、enable-tcp 和 enable-udp 只能一个为 true，但全部为 false 时，表示传输模式为：TCP（单连接）
4. 备用通道设置
备用通过可以通过 get-ndi-sources 接口获取。
http://ip/mwapi?method=set-ndi-config&enable-fail-over=true&fail-over-ndi-name=02-0+Pro+Capture+HDMI+4K&fail-over-ip-addr=192.168.1.102:5961
| 参数 |
说明 |
| method |
方法名称：set-ndi-config |
| enable-fail-over |
组播开启状态，有效值：true/false。 |
| fail-over-ndi-name |
备用视频源名称。 |
| fail-over-ip-addr |
备用通道 IP 地址。 |
5. 发现服务设置
http://ip/mwapi?method=set-ndi-config&enable-discovery=true&discovery-server=192.168.1.115
| 参数 |
说明 |
| method |
方法名称：set-ndi-config |
| enable-discovery |
发现服务开启状态，有效值：true/false。 |
| discovery-server |
发现服务启用后，服务器的 IP 地址。多个 IP 地址可用英文逗号（,）隔开 |
6. 音频参考电平设置
http://ip/mwapi?method=set-ndi-config&reference-level=20
| 参数 |
说明 |
| method |
方法名称：set-ndi-config |
| reference-level |
音频参考电平，有效值为：
SMPTE：20；
EBU：14 |
7. 接收端控制设置
http://ip/mwapi?method=set-ndi-config&enable-ptz-control=true&enable-web-control=false
| 参数 |
说明 |
| method |
方法名称：set-ndi-config |
| enable-ptz-control |
PTZ 控制是否开启，有效值：true/false。 |
| enable-web-control |
WEB 控制是否开启，有效值：true/false。 |
8. NDI vendor 信息设置
http://ip/mwapi?method=set-ndi-config&vendor-name=Magewell&vendor-id=01234567-0123-0123-0123456789AB
| 参数 |
说明 |
| method |
方法名称：set-ndi-config |
| vendor-name |
1 - 63 个字符 |
| vendor-id |
1 - 31 个字符 |