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 |
视频抖动。 |