get-signal-info
获取设备输入信号状态信息。
请求方式
GET http://ip/mwapi?method=get-signal-info
参数 |
说明 |
method |
方法名称:get-signal-info |
返回数据
JSON 结构如下:
{
"status": 0,
"signal-info-types": ["video-info"、"audio-info"、"hdmi-info"、"sdi-info"、"info-frames"]、 // 数组中各项和下边属性一一对应
"video-info": {...},
"audio-info": {...},
"hdmi-info": {...},
"sdi-info": {...},
"info-frames": {...}
}
返回状态
"status": 0
属性 |
说明 |
status |
返回状态。0:数据获取成功,返回其它值请参考 API 状态码。 |
信号类型
"signal-info-types": [
"video-info"、 // 视频信号状态
"audio-info"、 // 音频信号状态
"hdmi-info"、 // HDMI 信号状态
"sdi-info"、 // SDI 信号状态
"info-frames" // 帧信息
]
视频信号状态 (video-info:{...})
"video-info": {
"codec": "uncompressed",
"width": 1920,
"height": 1080,
"scan": "progressive",
"field-rate": 60.00,
"color-depth": 8,
"color-format": "rgb",
"aspect-ratio": "16:9",
"sampling": "4:4:4",
"quant-range": "full",
"sat-range": "full",
"frame-struct": "2d"
}
属性 |
说明 |
codec |
编码类型,包括 uncompressed、dsc、mpeg2 等。 |
width |
视频宽度,像素数。 |
height |
视频高度,像素数。 |
scan |
扫描方式,有效值:progressive、interlaced、psf。 |
field-rate |
帧率,包括 24、25、29.97、30、48、50、59.94、60。 |
color-depth |
色深,包括 8、10、12。 |
color-format |
色彩空间,有效值:rgb、bt.601、bt.709、bt.2020。 |
aspect-ratio |
显示宽高比,包括 16:9、4:3 等。 |
sampling |
采样方式,包括 4:2:0、4:2:2、4:4:4、4:4:4:4。 |
quant-range |
量化范围,有效值:limited、full。 |
sat-range |
饱和范围,有效值:limited、extended、full。 |
frame-struct |
帧结构,有效值:2d、3d-left-right、3d-top-bottom、3d-left-right-half、3d-top-bottom-half。 |
音频信号状态 (audio-info:{...})
"audio-info": {
"codec": "lpcm",
"num-channels": 2,
"sample-rate": 48000,
"bit-count": 16
}
属性 |
说明 |
codec |
编码方式,包括 lpcm、ac3、aac 等。 |
num-channels |
通道数,包括 1、2、.. 16。 |
sample-rate |
采样率,包括 32000、44100 等。 |
bit-count |
比特率,包括 16、20、24 等。 |
HDMI 信号状态 (hdmi-info:{...})
"hdmi-info": {
"mode": "dvi",
"vic": 0,
"scramble": false,
"clock-ratio": 1,
"hdcp": "none",
"repeat-count": 0,
"it-content": false,
"timing-mode-line": "148.50 1920 2008 2052 2200 1080 1084 1089 1125 +hsync +vsync"
}
属性 |
说明 |
mode |
模式,包括 hdmi、dvi。 |
vic |
视频标识码。 |
scramble |
有效值:true/false。 |
clock-ratio |
CPU 倍频,有效值:1、4。 |
hdcp |
HDCP 加密方式,有效值:none、hdcp-1.x、hdcp-2.2。 |
repeat-count |
重复计数,包括 0、1、2、4... |
it-content |
IT 内容标志,有效值:true/false。 |
timing-mode-line |
modeline 时序格式。 格式:pclk hdisp hsyncstart hsyncend htotal vdisp vsyncstart vsyncend vtotal [flags]。 flags:+hsync、-hsync、+vsync、-vsync、interlace、double-scan、sog、+csync、-csync。 例子:23.86 640 656 720 800 480 481 484 497 -hsync +vsync。 pclk 单位为 MHz,其他单位为像素。 |
SDI 信号状态 (sdi-info:{...})
"sdi-info": {
"link-type": "",
"link-speed": "",
"stream-type": "",
"level-b": true,
"interlaced": true,
"assignment": 0,
"st352-payload-id": 3423424,
"h-total": 2250,
"v-total": 1125,
"h-active": 1920,
"v-active": 1080
}
属性 |
说明 |
link-type |
链路类型,有效值:unknown、single-link、dual-link、quad-link。 |
link-speed |
传输速率,有效值:unknown、sd、hd、3g、6g、12g。 |
stream-type |
数据流类型,有效值:single-stream、dual-stream、3d。 |
level-b |
Level B,有效值:true/false。 |
interlaced |
隔行信号,有效值:true/false。 |
assignment |
链路编号。 |
st352-payload-id |
ST 352 负载 ID,无符号 32 位整型,转换成 16 进制显示。 |
h-total |
水平总宽度,像素数。 |
v-total |
垂直总高度,像素数。 |
h-active |
水平有效宽度,像素数。 |
v-active |
垂直有效高度,像素数。 |
信息帧 (info-frames:{...})
"info-frames": [
{
"id": "AVI"、
"type": 130,
"version": 2,
"checksum": 96,
"data": "ACgAIgAAADkEAACBBw=="
},
{
"id": "Audio",
"type": 132,
"version": 1,
"checksum": 112,
"data": "AQAAAAAAAAAAAA=="
}
]
属性 |
说明 |
id |
信息帧名称,包括 AVI、Audio... |
type |
报文类型。 |
version |
版本。 |
checksum |
校验和。 |
data |
base64 编码数据,转换成 16 进制显示。 |