SrtInputConfiguration

Field

Type

Repeated

Description

id

MediaNodeId

source_name

string

host

string

port

int32

The port to connect to or bind. When listening port 0 may be bound for an auto-allocated port

mode

SrtMode

passphrase

OptionalString

stream_id

OptionalString

stats_sampling

StreamStatisticsSampling

receive_latency

OptionalInt

peer_latency

OptionalInt

input_bandwidth

OptionalInt

overhead_bandwidth

OptionalInt

max_bandwidth

OptionalInt

peer_idle_timeout_ms

OptionalInt

Native libsrt peer-idle timeout (SRTO_PEERIDLETIMEO, ms): the connection is declared broken when NO packet of any kind (data, keepalive, ACK, control) has been received from the peer for this long — i.e. a link-death detector. Unset leaves libsrt’s default (5000ms). BREAKING: previously this drove an app-level "no media delivered" timer (default 500ms); that timer is removed. To act on a media stall, use the connection-health media-age / degraded-status thresholds.

tlpktdrop

OptionalBool

Deprecated: disabling too-late-packet-drop on a receiver head-of-line-blocks on missing packets and retransmits unrecoverable loss without limit, which can wedge the connection. Raise receive_latency instead. See SrtInputSettings.tlpktdrop.

source_recording

SourceRecordingSettings

Record each source’s bytes as they arrive, from the start (task 123)

start_threshold

InputStartThresholdSettings

Optionally drop data until input is 'stable' this will reduce latency and memory use in nearly all cases

chaos_drop_packets

DropRandom

program_filter

ProgramNumber

Optionally filter a single program from MPTS at decode time

time_domain

TimeDomainConfig

Optionally place this input into a named time domain. Inputs that share a domain are coordinated for cross-input timestamp alignment.

status_poll_interval_ms

OptionalInt

Interval at which to sample the underlying SRT socket’s connection state for the per-connection status metric (visualiser / metrics). This does NOT drive connection-status callbacks (e.g. onConnectionStatusChange): those fire on actual disconnection detection (send/receive failure or the peer idle timeout), not on this poll. When unset a default is used.

stats_poll_interval_ms

OptionalInt

Interval at which to sample SRT socket statistics. Stats feed metrics, so tune this to the rate at which you want metric updates. When unset a default is used.

cta708_charset

Cta708Charset

health_sampling

HealthSampling

Per-connection health sampling (InputConnectionHealth events). Default on.

health_thresholds

HealthThresholds

Opt-in thresholds for engine-side DEGRADED/RECOVERED status. Unset = off.

resolve_name

OptionalString

Caller mode only: when set, the remote endpoint is resolved from the node-local norsk-discovery service by this logical name (the SRT listener output’s publishedName, kind "srt-listener") instead of host/port. The caller connects to the resolved address and re-connects to a new one if the binding moves; it holds the current connection through a transient loss of the discovery service. Requires a configured discovery service.

connection_ownership

SrtInputConfiguration.ConnectionOwnership

claim_timeout_ms

OptionalInt

PER_CONNECTION only: how long an accepted connection is held for its CreateInputSrtConnection claim before being closed (default 10000).

report_ts_tables

OptionalBool

Whether to forward TS PSI/SI table events (ts_table) and GOP-structure events (gop_structure) on this stream. Unset = forward (the historical behaviour, for clients that predate these fields); the SDK sets them from whether the application registered the corresponding callbacks. These fire per table repetition / per GOP per connection, so on a many-connection listener they dominate the event stream (~530 of ~750 events/s at 175 connections) for clients that never look at them.

report_gop_structure

OptionalBool

report_ts_errors

OptionalBool

Whether to attach per-frame TR 101 290 (TS error) metrics to decoded frames. Only the qualityMonitoring node reads them; carrying them makes every frame’s quality-metrics map a per-frame allocation that is copied on each processing hop. Unset = attach (the historical behaviour). Set false on many-stream deployments that do no quality monitoring.

etr290

OptionalBool

ETR 101 290 monitoring notifications (code "etr") and their log summary. Unset = off: the analyser still runs and the norsk_etr290 counters still count, but no notification is raised. Turn on for broadcast-grade sources.

listener_sockets

OptionalInt

Listener mode only: how many sockets this listener binds on its one port. Each gets its own SRT receive/send threads, and the kernel spreads callers across them (SO_REUSEPORT), lifting the one-receive-thread-per-port ceiling for many concurrent sources. Unset or 1 = one socket. Linux only; 1-32.

accept_bonded

OptionalBool

Listener mode only: accept bonded callers (SRT socket groups — broadcast or backup, the caller chooses). The links are merged by SRT sequence number; each link’s health is in SrtConnectionStats.bond_links. Callers that do not bond are unaffected. Task 102.

bonding

SrtBonding

Caller mode only: dial a bonded group over these links; host and port are then ignored. Task 102.

require_grants

OptionalBool

Listener mode only: fail closed on the (route, user) passphrase table. By default an EMPTY table accepts every caller (the historical behaviour), so withdrawing the last grant reopens the listener. With this set, an empty table refuses every caller with reason "no_grants" (SrtConnectionRejected) until a grant is added. Unset = off.

Member of

Message

Description

SrtInputMessage