interface AutomaticInputFailover 🔹

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

Automatic input failover configuration for an input attachment.

When the active (primary) input meets any of the failover conditions, MediaLive switches to the secondary input without restarting the channel. This is input-source redundancy, distinct from the pipeline redundancy provided by ChannelClass.STANDARD.

See also: https://docs.aws.amazon.com/medialive/latest/ug/feature-automatic-input-failover.html

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' }],
    }),
  ],
});

Properties

Name	Type	Description
secondaryInput🔹	IInput	The secondary input to fail over to. Must be the same input class as the primary input.
errorClearTime?🔹	Duration	How long a recovered input must remain free of failover conditions before it is considered healthy.
failoverConditions?🔹	FailoverCondition[]	The conditions that trigger failover to the secondary input.
inputPreference?🔹	InputPreference	Which input to prefer once a failed input has recovered.

---

secondaryInput🔹

Type: IInput

The secondary input to fail over to. Must be the same input class as the primary input.

[disable-awslint:prefer-ref-interface]

---

errorClearTime?🔹

Type: Duration (optional, default: MediaLive service default)

How long a recovered input must remain free of failover conditions before it is considered healthy.

Particularly relevant with InputPreference.PRIMARY_INPUT_PREFERRED.

---

failoverConditions?🔹

Type: FailoverCondition[] (optional, default: a single input-loss condition with the MediaLive service default threshold)

The conditions that trigger failover to the secondary input.

---

inputPreference?🔹

Type: InputPreference (optional, default: EQUAL_INPUT_PREFERENCE, applied by MediaLive)

Which input to prefer once a failed input has recovered.