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

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. Enabling turns on all taps with defaults; alert thresholds live on the reporting config (default: {"enabled":false})

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: false)

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)

Transport

Option Description Required

tr101290

TR 101 290 priority-1/2 checks (default: true)

packetLoss

Continuity-counter / packet-loss (default: true)

decodeErrors

Decode errors (default: true)

Markers

Option Description Required

scte

Log SCTE-35/104 cues (default: false)

maxCueGapMs

Max cue-out to cue-in gap (ms); 0 = no check (default: 0)

Tags: quality monitoring black detect sei metadata inspect nr-iqa iqa dbcnn musiq freeze frozen