Quality Monitoring
Annotates video frames with raw quality metrics (black-frame, freeze-frame, NR-IQA) for downstream Quality Reporting components to apply thresholds.
Component Configuration
| Option | Description | Required | Environment override |
|---|---|---|---|
id |
A unique identifier for the component instance |
✓ |
|
displayName |
The name shown in the Studio UI of this component |
✓ |
|
blackDetect |
Black Detect (default: {"enabled":true,"pixelThreshold":0.063}) |
✗ |
|
freezeDetect |
Freeze Detect |
✗ |
|
nrIqa |
NR-IQA (no-reference image quality) |
✗ |
|
latencyBudgetMs |
Analysis latency budget (ms): frames are never held awaiting measurements longer than this. Blank = server default; runtime-tunable |
✗ |
|
reporting |
Embedded quality reporting — raises alert / score events for probe-api without a separate Monitor Wall (default: {"enabled":false}) |
✗ |
|
audio |
Audio quality monitoring: Spectrum taps annotate the audio frames (raw or compressed) and merge onto video for SEI. On by default with all taps at their defaults; turn it off to pass audio through unanalysed. Alert thresholds live on the reporting config (default: {"enabled":true}) |
✗ |
|
transport |
Transport-stream error monitoring — only meaningful for TS-based ingest (config carried, not wired here) |
✗ |
|
markers |
SCTE-35/104 cue logging + cue-in/out pairing (core work H4 — config carried, not wired yet) |
✗ |
|
notes |
Notes about this component |
✗ |
Reporting
| Option | Description | Required |
|---|---|---|
enabled |
Run an internal reporting node over the annotated stream (default: false) |
✗ |
thresholds |
Hysteresis thresholds for the embedded reporting node (server defaults fill any blank) |
✗ |
mqaVideoWeights |
SVTA MQA-VIDEO composite aggregation weights (server defaults fill any blank) |
✗ |
audioThresholds |
Audio alert thresholds for the embedded reporting node (server defaults fill any blank; hysteresis is shared) |
✗ |
mqaAudioWeights |
SVTA MQA-AUDIO composite aggregation weights (server defaults: EBU R128 -23±1) |
✗ |
signalLostTimeoutMs |
Signal-lost timeout (ms, 0 disables; default 2000): no frames on a still-advertised stream |
✗ |
Audio
| Option | Description | Required |
|---|---|---|
enabled |
Analyse audio (silence / clip / DC / correlation / dead-channel / spectral / R128 loudness) (default: true) |
✗ |
silence |
Silence tap |
✗ |
clip |
Clipping tap |
✗ |
dcOffset |
DC-offset tap |
✗ |
correlation |
Inter-channel correlation tap |
✗ |
deadChannel |
Dead-channel tap |
✗ |
spectral |
Spectral FFT tap (feeds tone / noise / hum) |
✗ |
loudness |
EBU R128 loudness tap (feeds loudness / true-peak) |
✗ |