get-summary-info 接口
获取设备状态信息，包括设备基本信息、以太网状态、USB RNDIS 状态、NDI 状态。
请求方式
GET http://ip/mwapi?method=get-summary-info
| 参数 |
说明 |
| method |
方法名称：get-summary-info |
返回数据
JSON 结构如下：
{
"status": 0,
"device": {...},
"ethernet": {...},
"rndis": {...},
"ndi": {...}
}
1. 返回状态
"status": 0
| 属性 |
说明 |
| status |
返回状态。0：数据获取成功，返回其它值请参考 API 状态码。 |
2. 设备基本信息 （device {...}）
"device": {
"name": "Pro Convert",
"model": "HDMI 4K Plus",
"serial-no": "B401180706020",
"hw-revision": "B",
"fw-version": "1.1.72",
"up-to-date": true,
"input-state": "no-signal",
"output-state": "unconnected",
"ptz-proto": "none",
"ptz-state": "disconnected",
"cpu-usage": 5.00,
"memory-usage": 58.33,
"core-temp": 46.76,
"board-id": 0,
"up-time": 8006,
"sd-size": 0,
"fan-rpm": 0
}
| 属性 |
说明 |
| name |
产品族名称。 |
| model |
产品型号，如 HDMI 4K Plus、 HDMI Plus、SDI Plus... |
| serial-no |
设备序列号。 |
| hw-revision |
硬件版本号，有效值：A ~ Z。 |
| fw-version |
当前设备固件版本号。 |
| up-to-date |
当前设备固件版本是否最新。是则显示 true，否则显示 false。 |
| input-state |
输入信号状态，有效值：no-signal、locking、unsupported 或实际值，如：1920x1080p60。 |
| output-state |
输出信号状态，有效值：unconnected、unsupported、active。 |
| ptz-proto |
PTZ 通信协议，有效值：none、visca。 |
| ptz-state |
PTZ 设备连接状态，有效值：unknown、connected、disconnected。 |
| cpu-usage |
CPU 使用率。 |
| memory-usage |
内存使用率。 |
| core-temp |
当前设备芯片的温度 (℃)。 |
| board-id |
拨码开关编号，有效值：0 ~ F。 |
| up-time |
距离设备上次启动的时长 (s)。 |
| sd-size |
SD 卡容量 (MB)。 |
| fan-rpm |
当前每分钟风扇转速。 |
3. 以太网状态信息 （ethernet {...}）
"ethernet": {
"state": "disconnected",
"mac-addr": "70:B3:D5:75:D2:41",
"ip-addr": "0.0.0.0",
"ip-mask": "0.0.0.0",
"gw-addr": "0.0.0.0",
"dns-addr": "0.0.0.0",
"tx-speed-kbps": 0,
"rx-speed-kbps": 0
}
| 属性 |
说明 |
| state |
以太网连接状态，有效值：down、disconnected、10m、100m、1000m、2500m、5000m、10000m。 |
| mac-addr |
MAC 地址。 |
| ip-addr |
以太网 IP 地址。 |
| ip-mask |
子网掩码地址。 |
| gw-addr |
网关地址。 |
| dns-addr |
DNS 服务器地址。 |
| tx-speed-kbps |
以太网发送速度 (Kbps)。 |
| rx-speed-kbps |
以太网接收速度 (Kbps)。 |
4. USB RNDIS 状态信息 （rndis {...}）
"rndis": {
"state": "high-speed",
"ip-addr": "192.168.66.1",
"tx-speed-kbps": 0,
"rx-speed-kbps": 0
}
| 属性 |
说明 |
| state |
USB 连接状态，有效值：disconnected、full-speed、high-speed、super-speed-5g、super-speed-10g。 |
| ip-addr |
USB RNDIS 地址。 |
| tx-speed-kbps |
通过 USB RNDIS 发送数据速率 (Kbps)。 |
| rx-speed-kbps |
通过 USB RNDIS 接收数据速度 (Kbps)。 |
5. NDI 状态信息 （ndi {...}）
"ndi": {
"name": "#00 (B401180706020)",
"enabled": true,
"num-clients": 0,
"tally-preview": false,
"tally-program": false,
"audio-drop-frames": 0,
"video-drop-frames": 0,
"video-bit-rate": 0,
"audio-bit-rate": 0,
"video-width": 0,
"video-height": 0,
"video-scan": "progressive",
"video-field-rate": 0.00,
"audio-num-channels": 0,
"audio-sample-rate": 0,
"audio-bit-count": 16
}
| 属性 |
说明 |
| name |
视频源名称。 |
| enabled |
NDI 开启状态，开启则显示 true，否则显示 false。 |
| num-clients |
接收此转换器视频流的客户端个数。 |
| tally-preview |
预览状态，预览中则显示 true，否则显示 false。 |
| tally-program |
播出状态，播出中则显示 true，否则显示 false。 |
| audio-drop-frames |
前一秒音频丢帧数。 |
| audio-bit-rate |
前一秒的音频编码速率 (Kbps)。 |
| audio-num-channels |
音频通道总数。 |
| audio-sample-rate |
音频采样率，包括 32000、44100 等。 |
| audio-bit-count |
音频比特率，包括 16、20、24 等。 |
| video-drop-frames |
前一秒的视频丢帧数。 |
| video-bit-rate |
前一秒的视频编码速率 (Kbps)。 |
| video-width |
视频宽度，总像素数。 |
| video-height |
视频高度，总像素数。 |
| video-scan |
扫描方式：progressive、interlaced、psf。 |
| video-field-rate |
帧率，包括 24、25、29.97、30、48、50、59.94、60。 |