Package software.amazon.awscdk.services.medialive.alpha

Interface GlobalConfiguration

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

GlobalConfiguration.Jsii$Proxy

@Generated(value="jsii-pacmak/1.139.0 (build 26a6b54)",
           date="2026-09-02T11:03:41.059Z")
@Stability(Experimental)
public interface GlobalConfiguration
extends software.amazon.jsii.JsiiSerializable

(experimental) Global configuration settings that apply to the entire channel.

Example:

 Stack stack;
 IInput input;
 IBucket bucket;
 EncodeConfiguration video;
 EncodeConfiguration audio;
 Channel.Builder.create(stack, "Channel")
         .inputs(List.of(InputAttachment.builder().input(input).build()))
         .timecodeConfig(TimecodeConfig.builder()
                 .source(TimecodeSource.EMBEDDED)
                 .build())
         .globalConfiguration(GlobalConfiguration.builder()
                 .outputLocking(OutputLocking.epoch())
                 .outputTimingSource(OutputTimingSource.INPUT_CLOCK)
                 .build())
         .outputGroups(List.of(OutputGroupConfiguration.hls(HlsOutputGroupProps.builder()
                 .name("hls")
                 .destinations(List.of(OutputDestination.toBucket(bucket, "live/stream")))
                 .outputs(List.of(HlsOutputDefinition.builder().encodes(List.of(video, audio)).outputName("hls_out").build()))
                 .build())))
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final class	GlobalConfiguration.Builder	A builder for GlobalConfiguration
static final class	GlobalConfiguration.Jsii$Proxy	An implementation for GlobalConfiguration

Method Summary

Modifier and Type	Method	Description
static GlobalConfiguration.Builder	builder()
default Number	getInitialAudioGain()	(experimental) The initial audio gain for the channel (-60 to 60 dB).
default InputEndAction	getInputEndAction()	(experimental) Action to take when the current input completes.
default InputLossBehavior	getInputLossBehavior()	(experimental) Behavior on input loss (substitute black / repeat frame, then a color or slate image).
default OutputLocking	getOutputLocking()	(experimental) How MediaLive pipelines are synchronised — OutputLocking.pipeline(), OutputLocking.epoch(), or OutputLocking.disabled().
default OutputTimingSource	getOutputTimingSource()	(experimental) Source of output timing.
default Boolean	getSupportLowFramerateInputs()	(experimental) Enable support for low framerate inputs (e.g.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getInitialAudioGain

@Stability(Experimental)
@Nullable
default Number getInitialAudioGain()

(experimental) The initial audio gain for the channel (-60 to 60 dB).

Default: - service default

getInputEndAction

@Stability(Experimental)
@Nullable
default InputEndAction getInputEndAction()

(experimental) Action to take when the current input completes.

Default: - service default

getInputLossBehavior

@Stability(Experimental)
@Nullable
default InputLossBehavior getInputLossBehavior()

(experimental) Behavior on input loss (substitute black / repeat frame, then a color or slate image).

Default: - service default

getOutputLocking

@Stability(Experimental)
@Nullable
default OutputLocking getOutputLocking()

(experimental) How MediaLive pipelines are synchronised — OutputLocking.pipeline(), OutputLocking.epoch(), or OutputLocking.disabled().

Default: - service default

See Also:

• https://docs.aws.amazon.com/medialive/latest/ug/pipeline-lock.html

getOutputTimingSource

@Stability(Experimental)
@Nullable
default OutputTimingSource getOutputTimingSource()

(experimental) Source of output timing.

Default: - service default

getSupportLowFramerateInputs

@Stability(Experimental)
@Nullable
default Boolean getSupportLowFramerateInputs()

(experimental) Enable support for low framerate inputs (e.g. music channels with less than 1 fps).

Default: false

builder

@Stability(Experimental)
static GlobalConfiguration.Builder builder()

Returns:

a GlobalConfiguration.Builder of GlobalConfiguration