TsCommonInputSettings interface

Signature:

export interface TsCommonInputSettings

Events

Property Type Description

Property	Type	Description
onConnectionHealth?	(health: TsConnectionHealth) ⇒ void	(Optional) Called periodically with the input’s health (per-stream media health plus a transport-level packet-gap stat). These inputs are connection-less, so the health carries no per-connection identity (`transport: "ts"`). Fires for the live TS inputs — NorskInput.udpTs() / NorskInput.tcpTs() — that enable UdpTsInputSettings.healthSampling; measurements only, you decide the policy.
onHealthStatusChange?	(status: "degraded" \| "recovered", health: InputHealthStatus) ⇒ void	(Optional) Called when the input’s health crosses one of its `healthThresholds` (`degraded`), or comes back within them (`recovered`). Fires for NorskInput.udpTs(), NorskInput.tcpTs() and NorskInput.rist() inputs that set `healthThresholds`.

onConnectionHealth?

(health: TsConnectionHealth) ⇒ void

(Optional) Called periodically with the input’s health (per-stream media health plus a transport-level packet-gap stat). These inputs are connection-less, so the health carries no per-connection identity (transport: "ts"). Fires for the live TS inputs — NorskInput.udpTs() / NorskInput.tcpTs() — that enable UdpTsInputSettings.healthSampling; measurements only, you decide the policy.

onHealthStatusChange?

(status: "degraded" | "recovered", health: InputHealthStatus) ⇒ void

(Optional) Called when the input’s health crosses one of its healthThresholds (degraded), or comes back within them (recovered). Fires for NorskInput.udpTs(), NorskInput.tcpTs() and NorskInput.rist() inputs that set healthThresholds.

Properties

Property Type Description

Property	Type	Description
cta708Charset?	Cta708CharsetSetting	(Optional) Character set used to interpret CTA-708 P16 (16-bit) captions — for East-Asian services whose P16 code set is a legacy DBCS rather than Unicode. The code set is signalled out of band, so it must be chosen per input; it does not affect Latin/ASCII text. Defaults to `'unicode'`.
etr290?	boolean	(Optional) ETR 101 290 (TR 101 290) monitoring notifications for this input. Default `false`. When `true`, every ETR 290 indicator the analyser finds (sync loss, CC errors, PAT/PMT intervals, PCR repetition and accuracy, CRC/transport errors, …) is raised as a notification with code `"etr"` (the kind in `labels.indicator`, plus `labels.priority` and, where it applies, `labels.ts_pid` / `labels.type`), at most once a second per kind; a kind that has been quiet for 10 s is retracted with an NorskSettings.onNotificationCleared carrying the matching `key` (source plus indicator signature; the same `key` the raise used). The engine also logs a per-kind summary at most every 10 s. Leave it off for sources that are not broadcast-grade: many cameras (e.g. Mevo, which sends a PCR every 120-160 ms against ETR 290’s 100 ms limit) break the limits continuously and harmlessly. Off, the analyser still runs and the `norsk_etr290` metric still counts every indicator; only the notifications and the log are silenced. `ts_decode_error` notifications are raised either way. Before this setting existed ETR 290 notifications were always on. The `udpTsPcapCapture` probe, whose purpose is TS monitoring, keeps them on and ignores this setting.
onRecording?	(event: InputRecordingEvent) ⇒ void	(Optional) Events from a recording of a source: see the node’s `startRecording`, and SourceRecordingSettings
onSourceTimeStateChange?	(sourceTimeState: SourceTimeState) ⇒ void	(Optional) Called when either a VITC timecode is detected, or having previously detected a timestamp it stops being present
onTsContext?	(context: TsContext) ⇒ void	(Optional) Callback to be invoked on receiving the raw TS context. This may contain additional streams which are unsupported by Norsk and would not appear in the node output, pids which have no data and thus will not appear in the node output (yet).
onTsTable?	(table: TsTable) ⇒ void	(Optional) Callback to be invoked on receiving a TS PSI/SI table/section
programFilter?	number	(Optional) Optionally filter a single program from MPTS at decode time
reportTsErrors?	boolean	(Optional) Whether decoded frames carry per-frame TR 101 290 (TS error) metrics. Only NorskInspect.qualityMonitoring() reads them; carrying them makes every frame’s quality-metrics map a per-frame allocation that is copied on each processing hop, so many-stream deployments that do no quality monitoring should set `false`. Default true.
timeDomain?	TimeDomain	(Optional) Optional time-domain configuration. When set, the input is placed into a named coordinator and is timestamp-aligned with all other inputs sharing the same domain id within this Norsk instance. Omit for the default (uncoordinated) behaviour.

cta708Charset?

Cta708CharsetSetting

(Optional) Character set used to interpret CTA-708 P16 (16-bit) captions — for East-Asian services whose P16 code set is a legacy DBCS rather than Unicode. The code set is signalled out of band, so it must be chosen per input; it does not affect Latin/ASCII text. Defaults to 'unicode'.

etr290?

boolean

(Optional) ETR 101 290 (TR 101 290) monitoring notifications for this input. Default false.

When true, every ETR 290 indicator the analyser finds (sync loss, CC errors, PAT/PMT intervals, PCR repetition and accuracy, CRC/transport errors, …) is raised as a notification with code "etr" (the kind in labels.indicator, plus labels.priority and, where it applies, labels.ts_pid / labels.type), at most once a second per kind; a kind that has been quiet for 10 s is retracted with an NorskSettings.onNotificationCleared carrying the matching key (source plus indicator signature; the same key the raise used). The engine also logs a per-kind summary at most every 10 s.

Leave it off for sources that are not broadcast-grade: many cameras (e.g. Mevo, which sends a PCR every 120-160 ms against ETR 290’s 100 ms limit) break the limits continuously and harmlessly. Off, the analyser still runs and the norsk_etr290 metric still counts every indicator; only the notifications and the log are silenced. ts_decode_error notifications are raised either way.

Before this setting existed ETR 290 notifications were always on. The udpTsPcapCapture probe, whose purpose is TS monitoring, keeps them on and ignores this setting.

onRecording?

(event: InputRecordingEvent) ⇒ void

(Optional) Events from a recording of a source: see the node’s startRecording, and SourceRecordingSettings

onSourceTimeStateChange?

(sourceTimeState: SourceTimeState) ⇒ void

(Optional) Called when either a VITC timecode is detected, or having previously detected a timestamp it stops being present

onTsContext?

(context: TsContext) ⇒ void

(Optional) Callback to be invoked on receiving the raw TS context. This may contain additional streams which are unsupported by Norsk and would not appear in the node output, pids which have no data and thus will not appear in the node output (yet).

onTsTable?

(table: TsTable) ⇒ void

(Optional) Callback to be invoked on receiving a TS PSI/SI table/section

programFilter?

number

(Optional) Optionally filter a single program from MPTS at decode time

reportTsErrors?

boolean

(Optional) Whether decoded frames carry per-frame TR 101 290 (TS error) metrics. Only NorskInspect.qualityMonitoring() reads them; carrying them makes every frame’s quality-metrics map a per-frame allocation that is copied on each processing hop, so many-stream deployments that do no quality monitoring should set false. Default true.

timeDomain?

TimeDomain

(Optional) Optional time-domain configuration. When set, the input is placed into a named coordinator and is timestamp-aligned with all other inputs sharing the same domain id within this Norsk instance. Omit for the default (uncoordinated) behaviour.