MediaPackageV2PerPipelineOutputGroupProps

class aws_cdk.aws_medialive_alpha.MediaPackageV2PerPipelineOutputGroupProps(*, name, outputs, additional_destinations=None, caption_language_mappings=None, id3_behavior=None, klv_behavior=None, nielsen_id3_behavior=None, scte35_type=None, segment=None, timed_metadata_id3_frame=None, timed_metadata_id3_period=None, timed_metadata_passthrough=None, destinations)

Bases: MediaPackageV2OutputGroupBaseProps

(experimental) Properties for a MediaPackage V2 output group with explicit per-pipeline destinations.

Use this when you need to control the channel and endpoint each pipeline delivers to — for example cross-region delivery, or pinning pipeline 0 to a specific endpoint.

Parameters:

  • name (str) – (experimental) The name of this output group. Used as the destination reference ID. Underscores are normalised to hyphens internally.

  • outputs (Sequence[Union[MediaPackageV2OutputDefinition, Dict[str, Any]]]) – (experimental) The outputs for this output group. MediaPackage V2 uses CMAF ingest which requires one track per output. Create a separate output for each encode (e.g. one for HD video, one for SD video, one for audio). Do NOT put multiple encodes in a single output.

  • additional_destinations (Optional[Sequence[MediaPackageV2Destination]]) – (experimental) Configure additional destinations to fan out the output to extra MediaPackage V2 channels, for example for cross-region delivery or backup packaging. These correspond to Destination 3/4 in the AWS console. Each additional destination is a single, explicit entry (channel + endpoint), independent of the channel class. Default: - no additional destinations

  • caption_language_mappings (Optional[Sequence[Union[CaptionLanguageMapping, Dict[str, Any]]]]) – (experimental) Caption language mappings for the MediaPackage V2 output. Default: - no caption language mappings

  • id3_behavior (Optional[Id3Behavior]) – (experimental) The ID3 behavior. Default: Id3Behavior.DISABLED

  • klv_behavior (Optional[KlvBehavior]) – (experimental) The KLV behavior. Default: KlvBehavior.NO_PASSTHROUGH

  • nielsen_id3_behavior (Optional[NielsenId3Behavior]) – (experimental) The Nielsen ID3 behavior. Default: NielsenId3Behavior.NO_PASSTHROUGH

  • scte35_type (Optional[Scte35Type]) – (experimental) The SCTE-35 type. Default: Scte35Type.SCTE_35_WITHOUT_SEGMENTATION

  • segment (Optional[Segment]) – (experimental) The length of each media segment. Default: - Segment.seconds(1)

  • timed_metadata_id3_frame (Optional[TimedMetadataId3Frame]) – (experimental) The timed metadata ID3 frame. Default: TimedMetadataId3Frame.NONE

  • timed_metadata_id3_period (Optional[Duration]) – (experimental) The timed metadata interval. Default: Duration.seconds(10)

  • timed_metadata_passthrough (Optional[TimedMetadataPassthrough]) – (experimental) Whether timed metadata is passed through. Default: TimedMetadataPassthrough.DISABLED

  • destinations (Sequence[MediaPackageV2Destination]) – (experimental) The primary MediaPackage V2 destinations — one per pipeline. Array position determines the pipeline mapping: - destinations[0] → Pipeline 0 - destinations[1] → Pipeline 1 (STANDARD channels only) For a SINGLE_PIPELINE channel, provide exactly 1 destination. For a STANDARD channel, provide exactly 2 destinations.

Stability:

experimental

ExampleMetadata:

infused

Example:

# primary: mediapackagev2.IChannel
# hd_video: medialive.EncodeConfiguration


medialive.OutputGroupConfiguration.media_package_v2_per_pipeline(
    name="emp",
    destinations=[
        # destinations[0] → Pipeline 0, destinations[1] → Pipeline 1
        medialive.MediaPackageV2Destination.channel(primary, medialive.MediaPackageV2EndpointId.ENDPOINT_2),
        medialive.MediaPackageV2Destination.channel(primary, medialive.MediaPackageV2EndpointId.ENDPOINT_1)
    ],
    outputs=[medialive.MediaPackageV2OutputDefinition(encode=hd_video, output_name="hd")
    ]
)

Attributes

additional_destinations

(experimental) Configure additional destinations to fan out the output to extra MediaPackage V2 channels, for example for cross-region delivery or backup packaging.

These correspond to Destination 3/4 in the AWS console. Each additional destination is a single, explicit entry (channel + endpoint), independent of the channel class.

Default:

  • no additional destinations

See:

https://docs.aws.amazon.com/medialive/latest/ug/creating-mediapackage-output-group.html

Stability:

experimental

caption_language_mappings

(experimental) Caption language mappings for the MediaPackage V2 output.

Default:

  • no caption language mappings

Stability:

experimental

destinations

(experimental) The primary MediaPackage V2 destinations — one per pipeline.

Array position determines the pipeline mapping:

  • destinations[0] → Pipeline 0

  • destinations[1] → Pipeline 1 (STANDARD channels only)

For a SINGLE_PIPELINE channel, provide exactly 1 destination. For a STANDARD channel, provide exactly 2 destinations.

Stability:

experimental

id3_behavior

(experimental) The ID3 behavior.

Default:

Id3Behavior.DISABLED

Stability:

experimental

klv_behavior

(experimental) The KLV behavior.

Default:

KlvBehavior.NO_PASSTHROUGH

Stability:

experimental

name

(experimental) The name of this output group.

Used as the destination reference ID. Underscores are normalised to hyphens internally.

Stability:

experimental

nielsen_id3_behavior

(experimental) The Nielsen ID3 behavior.

Default:

NielsenId3Behavior.NO_PASSTHROUGH

Stability:

experimental

outputs

(experimental) The outputs for this output group.

MediaPackage V2 uses CMAF ingest which requires one track per output. Create a separate output for each encode (e.g. one for HD video, one for SD video, one for audio). Do NOT put multiple encodes in a single output.

Stability:

experimental

scte35_type

(experimental) The SCTE-35 type.

Default:

Scte35Type.SCTE_35_WITHOUT_SEGMENTATION

Stability:

experimental

segment

(experimental) The length of each media segment.

Default:

  • Segment.seconds(1)

Stability:

experimental

timed_metadata_id3_frame

(experimental) The timed metadata ID3 frame.

Default:

TimedMetadataId3Frame.NONE

Stability:

experimental

timed_metadata_id3_period

(experimental) The timed metadata interval.

Default:

Duration.seconds(10)

Stability:

experimental

timed_metadata_passthrough

(experimental) Whether timed metadata is passed through.

Default:

TimedMetadataPassthrough.DISABLED

Stability:

experimental