StreamSwitchHardSettings interface

Settings for the Hard Stream Switch see: NorskControl.streamSwitchHard()

Signature:

export interface StreamSwitchHardSettings<Pins extends string> extends ProcessorNodeSettings<StreamSwitchHardNode<Pins>>

Extends: ProcessorNodeSettings<StreamSwitchHardNode<Pins>>

Properties

Property	Type	Description
activeSource	Pins	The currently active source to display on the output
bufferDelayMs?	number	(Optional) Optionally delay all streams by a fixed (wallclock) duration. This option is provided to allow decisions on switching to be made with the benefit of a buffer’s worth of foresight, specifically if a stream should disappear, actioning the switch to a backup stream can be made early enough that the switch can occur on a keyframe
maxQueueMs?	number	(Optional) 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.
onInboundContextChange?	(allStreams: Map<Pins, StreamMetadata[]>) ⇒ Promise<void>	(Optional) Callback to be called when inbound context changes on some input; presence of an input means that media has arrived and is ready to switch immediately Note that in combination with StreamSwitchHardSettings.bufferDelayMs this event represents the delayed media context (i.e. still ready to switch immediately according to this context, but any observation of early changes must happen upstream).
onSwitchComplete?	(source?: string) ⇒ void	(Optional) Callback which will be called if a switch request has been effectuated - that is, after a source switch is requested and has been accepted (is not an error), the desired source is now active on the output. For video sources, this means that a keyframe (IDR/IRAP/etc) has arrived on (at least one video stream), for audio-only sources this will be any frame.
onSwitchError?	(message: string, inputPin?: Pins) ⇒ void	(Optional) Callback which will be called if a switch request cannot be fulfilled
outputSource	string	the source name to give the output of this switch operation

Property

Type

Description

activeSource

Pins

The currently active source to display on the output

bufferDelayMs?

number

(Optional) Optionally delay all streams by a fixed (wallclock) duration. This option is provided to allow decisions on switching to be made with the benefit of a buffer’s worth of foresight, specifically if a stream should disappear, actioning the switch to a backup stream can be made early enough that the switch can occur on a keyframe

maxQueueMs?

number

(Optional) 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.

onInboundContextChange?

(allStreams: Map<Pins, StreamMetadata[]>) ⇒ Promise<void>

(Optional) Callback to be called when inbound context changes on some input; presence of an input means that media has arrived and is ready to switch immediately

Note that in combination with StreamSwitchHardSettings.bufferDelayMs this event represents the delayed media context (i.e. still ready to switch immediately according to this context, but any observation of early changes must happen upstream).

onSwitchComplete?

(source?: string) ⇒ void

(Optional) Callback which will be called if a switch request has been effectuated - that is, after a source switch is requested and has been accepted (is not an error), the desired source is now active on the output. For video sources, this means that a keyframe (IDR/IRAP/etc) has arrived on (at least one video stream), for audio-only sources this will be any frame.

onSwitchError?

(message: string, inputPin?: Pins) ⇒ void

(Optional) Callback which will be called if a switch request cannot be fulfilled

outputSource

string

the source name to give the output of this switch operation