get-signal-info 接口
获取 HDMI 输入信号状态信息。
请求方式
POST http://ip/mwapi/get-signal-info/
参数 | 说明 |
---|---|
source-id | 输入源ID, HDMI 1为0, HDMI 2为1 |
返回数据
JSON 结构如下:
{
"status": 0,
"signal-info-types": ["video-info", "audio-info", "hdmi-info", "info-frames"],
"video-info": {...},
"audio-info": {...},
"hdmi-info": {...},
"info-frames": {...}
}
返回状态
"status": 0
属性 | 说明 |
---|---|
status | 返回状态。0:请求成功,返回其它值请参考 API 状态码。 |
信号类型
"signal-info-types": [
"video-info",
"audio-info",
"hdmi-info",
"info-frames"
]
视频信号状态 (video-info:{...})
"video-info": {
"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"
}
属性 | 说明 |
---|---|
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": "hdmi",
"hdcp": "none",
"vic": 0,
"it-content": false,
"pixel-rate": "148MHz",
"timing-htotal": 2200,
"timing-hactive": 1920,
"timing-h-front-porch": 88,
"timing-h-synct-width": 44,
"timing-h-back-porch": 148,
"timing-vtotal": 1125,
"timing-vactive": 1080,
"timing-v-front-porch": 4,
"timing-v-synct-width": 5,
"timing-v-back-porch": 36
}
属性 | 说明 |
---|---|
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,其他单位为像素。 |
信息帧 (info-frames:{...})
"info-frames": [
{
"id": "AVI"、
"type": 130,
"version": 2,
"length": 13,
"checksum": 96,
"data": "ACgAIgAAADkEAACBBw=="
},
{
"id": "SPD",
"type": 132,
"version": 1,
"length": 25, //bytes
"checksum": 112,
"data": "AQAAAAAAAAAAAA=="
}
]
属性 | 说明 |
---|---|
id | 信息帧名称,包括 AVI、SPD... |
type | 报文类型。 |
version | 版本。 |
length | 长度。 |
checksum | 校验和。 |
data | base64 编码数据,转换成 16 进制显示。 |