class FailoverCondition 🔹

Language	Type name
.NET	Amazon.CDK.AWS.MediaLive.Alpha.FailoverCondition
Go	github.com/aws/aws-cdk-go/awsmedialivealpha/v2#FailoverCondition
Java	software.amazon.awscdk.services.medialive.alpha.FailoverCondition
Python	aws_cdk.aws_medialive_alpha.FailoverCondition
TypeScript (source)	@aws-cdk/aws-medialive-alpha » FailoverCondition

A condition that, when met on the active input, triggers automatic input failover to the secondary input.

Create conditions with the static factory methods.

Example

declare const stack: Stack;
declare const primaryInput: medialive.IInput;
declare const secondaryInput: medialive.IInput;
declare const audioSelector: medialive.AudioSelector;
declare const video: medialive.EncodeConfiguration;
declare const audio: medialive.EncodeConfiguration;
declare const bucket: s3.IBucket;

new medialive.Channel(stack, 'Channel', {
  inputs: [{
    input: primaryInput,
    automaticInputFailover: {
      secondaryInput,
      inputPreference: medialive.InputPreference.PRIMARY_INPUT_PREFERRED,
      errorClearTime: Duration.seconds(3),
      failoverConditions: [
        medialive.FailoverCondition.inputLoss({ threshold: Duration.millis(1500) }),
        medialive.FailoverCondition.audioSilence({ audioSelector, threshold: Duration.seconds(2) }),
        medialive.FailoverCondition.videoBlack({ blackDetectThreshold: 0.1, threshold: Duration.seconds(1) }),
      ],
    },
  }, {
    // The secondary input must also be attached to the channel as its own input.
    input: secondaryInput,
  }],
  outputGroups: [
    medialive.OutputGroupConfiguration.hls({
      name: 'hls',
      destinations: [medialive.OutputDestination.toBucket(bucket, 'live/stream')],
      outputs: [{ encodes: [video, audio], outputName: 'hls_out' }],
    }),
  ],
});

Initializer

new FailoverCondition()

Methods

Name	Description
static audioSilence(props)🔹	Fail over when the monitored audio selector is silent for the threshold period.
static inputLoss(props?)🔹	Fail over when no input is detected for the threshold period.
static videoBlack(props?)🔹	Fail over when the content is black for the threshold period.

---

static audioSilence(props)🔹

public static audioSilence(props: AudioSilenceFailoverProps): FailoverCondition

Parameters

• props AudioSilenceFailoverProps

Returns

• FailoverCondition

Fail over when the monitored audio selector is silent for the threshold period.

---

static inputLoss(props?)🔹

public static inputLoss(props?: InputLossFailoverProps): FailoverCondition

Parameters

• props InputLossFailoverProps

Returns

• FailoverCondition

Fail over when no input is detected for the threshold period.

---

static videoBlack(props?)🔹

public static videoBlack(props?: VideoBlackFailoverProps): FailoverCondition

Parameters

• props VideoBlackFailoverProps

Returns

• FailoverCondition

Fail over when the content is black for the threshold period.