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": "NDI to HDMI",
  "serial-no": "101",
  "hw-revision": "A",
  "fw-version": "1.1.157",
  "up-to-date": true,
  "output-state": "connected",
  "cpu-usage": 60.00,
  "memory-usage": 37.46,
  "core-temp": 69.23,
  "board-id": 0,
  "up-time": 19972,
  "sd-size": 0
}
| 属性 | 
说明 | 
| name | 
产品族名称。 | 
| model | 
产品型号,如 NDI to HDMI。 | 
| serial-no | 
设备序列号。 | 
| hw-revision | 
硬件版本号,有效值:A ~ Z。 | 
| fw-version | 
当前设备固件版本号。 | 
| up-to-date | 
当前设备固件版本是否最新。是则显示 true,否则显示 false。 | 
| output-state | 
输出信号状态,有效值:unconnected、unsupported、active。 | 
| cpu-usage | 
CPU 使用率。 | 
| memory-usage | 
内存使用率。 | 
| core-temp | 
当前设备芯片的温度 (℃)。 | 
| board-id | 
拨码开关编号,有效值:0 ~ F。 | 
| up-time | 
距离设备上次启动的时长 (s)。 | 
| sd-size | 
SD 卡容量 (MB)。 | 
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)",
  "connected": true,
  "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,
  "audio-jitter": 26,
  "video-jitter": 7
}
| 属性 | 
说明 | 
| name | 
视频源名称。 | 
| connected | 
NDI 连接状态,连接则显示 true,否则显示 false。 | 
| 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。 | 
| audio-jitter | 
音频抖动。 | 
| video-jitter | 
视频抖动。 |