SrtInputConfiguration
Field |
Type |
Repeated |
Description |
id |
|||
source_name |
|||
host |
|||
port |
The port to connect to or bind. When listening port 0 may be bound for an auto-allocated port |
||
mode |
|||
passphrase |
|||
stream_id |
|||
stats_sampling |
|||
receive_latency |
|||
peer_latency |
|||
input_bandwidth |
|||
overhead_bandwidth |
|||
max_bandwidth |
|||
peer_idle_timeout_ms |
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 |
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 |
Record each source’s bytes as they arrive, from the start (task 123) |
||
start_threshold |
Optionally drop data until input is 'stable' this will reduce latency and memory use in nearly all cases |
||
chaos_drop_packets |
|||
program_filter |
Optionally filter a single program from MPTS at decode time |
||
time_domain |
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 |
Interval at which to sample the underlying SRT socket’s connection state
for the per-connection |
||
stats_poll_interval_ms |
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 |
|||
health_sampling |
Per-connection health sampling (InputConnectionHealth events). Default on. |
||
health_thresholds |
Opt-in thresholds for engine-side DEGRADED/RECOVERED status. Unset = off. |
||
resolve_name |
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 |
||
connection_ownership |
|||
claim_timeout_ms |
PER_CONNECTION only: how long an accepted connection is held for its CreateInputSrtConnection claim before being closed (default 10000). |
||
report_ts_tables |
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 |
|||
report_ts_errors |
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 |
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 |
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 |
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 |
Caller mode only: dial a bonded group over these links; host and port are then ignored. Task 102. |
||
require_grants |
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. |