MoqInputSettings interface

Signature:

export interface MoqInputSettings extends SourceNodeSettings<MoqInputNode>, StreamStatisticsMixin

Extends: SourceNodeSettings<MoqInputNode>, StreamStatisticsMixin

Properties

Property Type Description

Property	Type	Description
c2paVerification?	C2paVerificationSettings	(Optional) When set, each incoming init and media segment is validated against the C2PA Live Video continuity chain (spec §19.3). Per-segment outcomes are delivered to `onC2paSegmentVerified`. Reporting-only: media flows regardless of validation result.
disableTlsVerify?	boolean	(Optional) Disable verification of remote server’s TLS certificate (for development use ONLY, not for production)
listener?	MoqInputListenerSettings	(Optional) Optional: start a listener for direct publisher connections. When set, the ingest accepts incoming MoQT publisher connections instead of (or in addition to) connecting to a relay as a subscriber.
namespace	string[]	The namespace to subscribe to (client mode only), as a list of segments (the on-the-wire MoQT tuple). For listener mode, set `listener.namespacePrefix` instead — incoming publishers are matched by prefix and identified per-connection via MoqInputSettings.onConnection.
onC2paSegmentVerified?	(info: { representationId: string; isInit: boolean; outcome: C2paValidationOutcome; }) ⇒ void	(Optional) Called once per init segment and once per media segment when MoqInputSettings.c2paVerification is configured. For MoQ inputs, `representationId` carries the MoQ track name from the underlying CMAF stream.
onConnection?	(connectionIndex: number, remoteHost: string, publishedNamespace: string[]) ⇒ MoqConnectionResult	(Optional) Called when a new publisher connects via QUIC or WebTransport (listener mode only). `publishedNamespace` is the full namespace tuple the publisher announced, as a list of segments — e.g. for the namespace `<"stage", "primary">` it’s `["stage", "primary"]`. Return accept with a sourceName, or reject to deny.
onConnectionStatusChange?	(connectionIndex: number, state: string) ⇒ void	(Optional) Called when a publisher connection status changes (listener mode only)
onTimecode?	(ntpTimestamp: number, mediaTime: number) ⇒ void	(Optional) Called when a PRFT (Producer Reference Time) box is detected in an incoming CMAF segment. Carries the NTP wall-clock timestamp and the media decode time from the PRFT box.
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.
url?	string	(Optional) The URL of the MoQT relay to connect to (e.g. 'moqt://relay.example.com:4443'). Omit when using listener mode.

c2paVerification?

C2paVerificationSettings

(Optional) When set, each incoming init and media segment is validated against the C2PA Live Video continuity chain (spec §19.3). Per-segment outcomes are delivered to onC2paSegmentVerified. Reporting-only: media flows regardless of validation result.

disableTlsVerify?

boolean

(Optional) Disable verification of remote server’s TLS certificate (for development use ONLY, not for production)

listener?

MoqInputListenerSettings

(Optional) Optional: start a listener for direct publisher connections. When set, the ingest accepts incoming MoQT publisher connections instead of (or in addition to) connecting to a relay as a subscriber.

namespace

string[]

The namespace to subscribe to (client mode only), as a list of segments (the on-the-wire MoQT tuple). For listener mode, set listener.namespacePrefix instead — incoming publishers are matched by prefix and identified per-connection via MoqInputSettings.onConnection.

onC2paSegmentVerified?

(info: { representationId: string; isInit: boolean; outcome: C2paValidationOutcome; }) ⇒ void

(Optional) Called once per init segment and once per media segment when MoqInputSettings.c2paVerification is configured. For MoQ inputs, representationId carries the MoQ track name from the underlying CMAF stream.

onConnection?

(connectionIndex: number, remoteHost: string, publishedNamespace: string[]) ⇒ MoqConnectionResult

(Optional) Called when a new publisher connects via QUIC or WebTransport (listener mode only). publishedNamespace is the full namespace tuple the publisher announced, as a list of segments — e.g. for the namespace <"stage", "primary"> it’s ["stage", "primary"]. Return accept with a sourceName, or reject to deny.

onConnectionStatusChange?

(connectionIndex: number, state: string) ⇒ void

(Optional) Called when a publisher connection status changes (listener mode only)

onTimecode?

(ntpTimestamp: number, mediaTime: number) ⇒ void

(Optional) Called when a PRFT (Producer Reference Time) box is detected in an incoming CMAF segment. Carries the NTP wall-clock timestamp and the media decode time from the PRFT box.

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.

url?

string

(Optional) The URL of the MoQT relay to connect to (e.g. 'moqt://relay.example.com:4443'). Omit when using listener mode.