StreamSwitchHardConfiguration

Field

Type

Description

id

MediaNodeId

active_source

InputPin

The pin to select as the initially active source

output_source

string

The source name for the output source

max_queue_ms

OptionalInt

Maximum duration to hold any stream in the case that one or more are running behind. In the case the late stream is delayed rather than having a large gap, this will result in discarded input frames.

buffer_delay_ms

uint32

Optionally delay all streams by a fixed duration

start_video_stream_id

uint32

Starting stream ID for the output video stream (default 1)

start_audio_stream_id

uint32

Starting stream ID for the output audio stream (default 2)

start_subtitle_stream_id

uint32

Starting stream ID for the output subtitle stream (default 257)

start_ancillary_stream_id

uint32

Starting stream ID for the output ancillary stream (default 513)

strip_volatile_metadata

bool

When true, strip volatile metadata fields (currently bitrate on compressed audio/video) from the output context so downstream consumers don’t see spurious context changes when the active source’s instantaneous bitrate fluctuates.

stable_output_context

bool

When true, suppress transient/partial output contexts during source transitions. The output Context only changes when the new context is either fully empty (carries teardown semantics) or has at least the streams of the previously-emitted context. Identical-to-previous contexts are also deduped. Pairs naturally with strip_volatile_metadata when downstream is sensitive to context churn.