> **Experimental**
>
> `@aws-cdk/aws-medialive-alpha` is an [**experimental**](/stability) (alpha) package: its API may change in any release, without a major version bump.
# CmafIngestOutputGroupProps

Properties for a CMAF Ingest output group.

- Stability: [Experimental](/cdk/api/stability.html)
- Source: [`lib/output-group.ts`](https://github.com/aws/aws-cdk/blob/v2.275.0-alpha.0/packages/@aws-cdk/aws-medialive-alpha/lib/output-group.ts#L912)

## Example

```ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import * as medialive_alpha from '@aws-cdk/aws-medialive-alpha';
import * as cdk from 'aws-cdk-lib';

declare const encodeConfiguration: medialive_alpha.EncodeConfiguration;
declare const id3Behavior: medialive_alpha.Id3Behavior;
declare const klvBehavior: medialive_alpha.KlvBehavior;
declare const nielsenId3Behavior: medialive_alpha.NielsenId3Behavior;
declare const outputDestination: medialive_alpha.OutputDestination;
declare const scte35Type: medialive_alpha.Scte35Type;
declare const segment: medialive_alpha.Segment;
declare const timedMetadataId3Frame: medialive_alpha.TimedMetadataId3Frame;
declare const timedMetadataPassthrough: medialive_alpha.TimedMetadataPassthrough;
const cmafIngestOutputGroupProps: medialive_alpha.CmafIngestOutputGroupProps = {
  destinations: [outputDestination],
  name: 'name',
  outputs: [{
    encode: encodeConfiguration,
    outputName: 'outputName',

    // the properties below are optional
    captions: [encodeConfiguration],
    nameModifier: 'nameModifier',
  }],

  // the properties below are optional
  additionalDestinations: [outputDestination],
  captionLanguageMappings: [{
    captionChannel: 123,
    languageCode: 'languageCode',
  }],
  id3Behavior: id3Behavior,
  id3NameModifier: 'id3NameModifier',
  klvBehavior: klvBehavior,
  klvNameModifier: 'klvNameModifier',
  nielsenId3Behavior: nielsenId3Behavior,
  nielsenId3NameModifier: 'nielsenId3NameModifier',
  scte35NameModifier: 'scte35NameModifier',
  scte35Type: scte35Type,
  segment: segment,
  sendDelayMs: 123,
  timedMetadataId3Frame: timedMetadataId3Frame,
  timedMetadataId3Period: cdk.Duration.minutes(30),
  timedMetadataPassthrough: timedMetadataPassthrough,
};
```

## Properties

- `additionalDestinations`: [OutputDestination](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.OutputDestination.html)[] — Configure additional destinations to fan out the CMAF ingest output to extra endpoints, for example for cross-region delivery or backup packaging.

  **Default:** no additional destinations

  Standard channels support up to 2 additional destinations.
  Single pipeline channels support 1 additional destination.

- `captionLanguageMappings`: [CmafCaptionLanguageMapping](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.CmafCaptionLanguageMapping.html)[] — Maps captions channels to languages for this CMAF Ingest output group.

  **Default:** no caption language mappings

- `destinations`: [OutputDestination](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.OutputDestination.html)[] (required) — The primary CMAF ingest 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 to utilise both
  pipelines for redundancy.

- `id3Behavior`: [Id3Behavior](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.Id3Behavior.html) = Id3Behavior.DISABLED — The ID3 behavior for the CMAF ingest output.

- `id3NameModifier`: string — The name modifier for ID3 metadata.

  **Default:** service default

- `klvBehavior`: [KlvBehavior](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.KlvBehavior.html) = KlvBehavior.NO_PASSTHROUGH — The KLV behavior for the CMAF ingest output.

- `klvNameModifier`: string — The name modifier for KLV metadata.

  **Default:** service default

- `name`: string (required) — The name of this output group.

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

- `nielsenId3Behavior`: [NielsenId3Behavior](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.NielsenId3Behavior.html) — The Nielsen ID3 behavior for the CMAF ingest output.

  **Default:** NielsenId3Behavior.NO_PASSTHROUGH

- `nielsenId3NameModifier`: string — The name modifier for Nielsen ID3 metadata.

  **Default:** service default

- `outputs`: [CmafIngestOutputDefinition](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.CmafIngestOutputDefinition.html)[] (required) — The outputs for this CMAF Ingest output group.

  Each output should contain a single encode.

- `scte35NameModifier`: string — The name modifier for SCTE-35 messages.

  **Default:** service default

- `scte35Type`: [Scte35Type](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.Scte35Type.html) — The SCTE-35 type for the CMAF ingest output.

  **Default:** Scte35Type.SCTE_35_WITHOUT_SEGMENTATION

- `segment`: [Segment](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.Segment.html) = Segment.seconds(1) — The length of each media segment.

- `sendDelayMs`: number — The number of milliseconds to delay the output from the second pipeline.

  **Default:** service default

- `timedMetadataId3Frame`: [TimedMetadataId3Frame](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.TimedMetadataId3Frame.html) = TimedMetadataId3Frame.NONE — Indicates the ID3 frame that has the timecode.

- `timedMetadataId3Period`: [Duration](/cdk/api/v2/docs/aws-cdk-lib.Duration.html) = Duration.seconds(10) — The timed metadata interval.

- `timedMetadataPassthrough`: [TimedMetadataPassthrough](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.TimedMetadataPassthrough.html) — Whether timed metadata is passed through.

  **Default:** TimedMetadataPassthrough.DISABLED
