Skip to content
v2.275.0

Experimental

@aws-cdk/aws-medialive-alpha is an experimental (alpha) package: its API may change in any release, without a major version bump.

MediaPackageV2PerPipelineOutputGroupProps Struct ​

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.

Example ​

ts
declare const primary: mediapackagev2.IChannel;
declare const hdVideo: medialive.EncodeConfiguration;

medialive.OutputGroupConfiguration.mediaPackageV2PerPipeline({
  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: [
    { encode: hdVideo, outputName: 'hd' },
  ],
});

Properties ​

additionalDestinationsoptionalMediaPackageV2Destination[]additional_destinationsoptionaltyping.List[MediaPackageV2Destination]additionalDestinationsoptionalList<MediaPackageV2Destination>AdditionalDestinationsoptionalMediaPackageV2Destination[]AdditionalDestinationsoptional*[]MediaPackageV2Destination#
Configure additional destinations to fan out the output to extra MediaPackage V2 channels, for example for cross-region delivery or backup packaging.

Default: no additional destinations

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.

captionLanguageMappingsoptionalCaptionLanguageMapping[]caption_language_mappingsoptionaltyping.List[CaptionLanguageMapping]captionLanguageMappingsoptionalList<CaptionLanguageMapping>CaptionLanguageMappingsoptionalCaptionLanguageMapping[]CaptionLanguageMappingsoptional*[]CaptionLanguageMapping#
Caption language mappings for the MediaPackage V2 output.

Default: no caption language mappings

destinationsMediaPackageV2Destination[]destinationstyping.List[MediaPackageV2Destination]destinationsList<MediaPackageV2Destination>DestinationsMediaPackageV2Destination[]Destinations*[]MediaPackageV2Destinationrequired#
The primary MediaPackage V2 destinations — one per pipeline.
notes

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.

id3BehavioroptionalId3Behaviorid3_behavioroptionalId3Behaviorid3BehavioroptionalId3BehaviorId3BehavioroptionalId3BehaviorId3BehavioroptionalId3Behavior= Id3Behavior.DISABLED#
The ID3 behavior.
klvBehavioroptionalKlvBehaviorklv_behavioroptionalKlvBehaviorklvBehavioroptionalKlvBehaviorKlvBehavioroptionalKlvBehaviorKlvBehavioroptionalKlvBehavior= KlvBehavior.NO_PASSTHROUGH#
The KLV behavior.
namestringnamestrnameStringNamestringName*stringrequired#
The name of this output group.

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

nielsenId3BehavioroptionalNielsenId3Behaviornielsen_id3_behavioroptionalNielsenId3BehaviornielsenId3BehavioroptionalNielsenId3BehaviorNielsenId3BehavioroptionalNielsenId3BehaviorNielsenId3BehavioroptionalNielsenId3Behavior#
The Nielsen ID3 behavior.

Default: NielsenId3Behavior.NO_PASSTHROUGH

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.

scte35TypeoptionalScte35Typescte35_typeoptionalScte35Typescte35TypeoptionalScte35TypeScte35TypeoptionalScte35TypeScte35TypeoptionalScte35Type#
The SCTE-35 type.

Default: Scte35Type.SCTE_35_WITHOUT_SEGMENTATION

segmentoptionalSegmentsegmentoptionalSegmentsegmentoptionalSegmentSegmentoptionalSegmentSegmentoptionalSegment= Segment.seconds(1)#
The length of each media segment.
timedMetadataId3FrameoptionalTimedMetadataId3Frametimed_metadata_id3_frameoptionalTimedMetadataId3FrametimedMetadataId3FrameoptionalTimedMetadataId3FrameTimedMetadataId3FrameoptionalTimedMetadataId3FrameTimedMetadataId3FrameoptionalTimedMetadataId3Frame= TimedMetadataId3Frame.NONE#
The timed metadata ID3 frame.
timedMetadataId3PeriodoptionalDurationtimed_metadata_id3_periodoptionalDurationtimedMetadataId3PeriodoptionalDurationTimedMetadataId3PeriodoptionalDurationTimedMetadataId3PeriodoptionalDuration= Duration.seconds(10)#
The timed metadata interval.
timedMetadataPassthroughoptionalTimedMetadataPassthroughtimed_metadata_passthroughoptionalTimedMetadataPassthroughtimedMetadataPassthroughoptionalTimedMetadataPassthroughTimedMetadataPassthroughoptionalTimedMetadataPassthroughTimedMetadataPassthroughoptionalTimedMetadataPassthrough#
Whether timed metadata is passed through.

Default: TimedMetadataPassthrough.DISABLED