OutputLocking

class aws_cdk.aws_medialive_alpha.OutputLocking

Bases: object

(experimental) Output locking synchronises the frames emitted by a channel’s two pipelines. Use the static factory methods to select a strategy:.

  • OutputLocking.pipeline() — synchronise each pipeline’s output to the other.

  • OutputLocking.epoch() — synchronise each pipeline’s output to the Unix epoch.

  • OutputLocking.disabled() — do not synchronise pipelines.

See:

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

Stability:

experimental

ExampleMetadata:

infused

Example:

# stack: Stack
# input: medialive.IInput
# bucket: s3.IBucket
# video: medialive.EncodeConfiguration
# audio: medialive.EncodeConfiguration


medialive.Channel(stack, "Channel",
    inputs=[medialive.InputAttachment(input=input)],
    timecode_config=medialive.TimecodeConfig(
        source=medialive.TimecodeSource.EMBEDDED
    ),
    global_configuration=medialive.GlobalConfiguration(
        output_locking=medialive.OutputLocking.epoch(),
        output_timing_source=medialive.OutputTimingSource.INPUT_CLOCK
    ),
    output_groups=[
        medialive.OutputGroupConfiguration.hls(
            name="hls",
            destinations=[medialive.OutputDestination.to_bucket(bucket, "live/stream")],
            outputs=[medialive.HlsOutputDefinition(encodes=[video, audio], output_name="hls_out")]
        )
    ]
)
Stability:

experimental

Static Methods

classmethod disabled(custom_epoch=None)

(experimental) Disable output locking (optionally with a custom epoch).

Parameters:

custom_epoch (Optional[str])

Stability:

experimental

Return type:

OutputLocking

classmethod epoch(*, custom_epoch=None, jam_sync_time=None)

(experimental) Lock outputs to an epoch.

Parameters:
  • custom_epoch (Optional[str]) – (experimental) A custom epoch (ISO-8601 timestamp) to lock outputs to. Default: - service default

  • jam_sync_time (Optional[str]) – (experimental) A jam-sync time (ISO-8601 timestamp). Default: - service default

Stability:

experimental

Return type:

OutputLocking

classmethod pipeline(*, custom_epoch=None, method=None)

(experimental) Lock pipelines to each other.

Parameters:
  • custom_epoch (Optional[str]) – (experimental) A custom epoch (ISO-8601 timestamp) to lock outputs to. Default: - service default

  • method (Optional[PipelineLockingMethod]) – (experimental) The method MediaLive uses to synchronise the pipelines. Default: - SOURCE_TIMECODE, applied by MediaLive

Stability:

experimental

Return type:

OutputLocking