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

Output definition for a MediaPackage V2 output group.

MediaPackage V2 uses CMAF ingest which requires one media track (video or audio) per output.
In-band captions (burn-in, embedded) can ride alongside the primary encode because they do not
produce a separate track.

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

## 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';

declare const encodeConfiguration: medialive_alpha.EncodeConfiguration;
declare const mediaPackageV2HlsSetting: medialive_alpha.MediaPackageV2HlsSetting;
const mediaPackageV2OutputDefinition: medialive_alpha.MediaPackageV2OutputDefinition = {
  encode: encodeConfiguration,
  outputName: 'outputName',

  // the properties below are optional
  audioGroupId: 'audioGroupId',
  audioRenditionSets: 'audioRenditionSets',
  captions: [encodeConfiguration],
  hlsAutoSelect: mediaPackageV2HlsSetting,
  hlsDefault: mediaPackageV2HlsSetting,
};
```

## Properties

- `audioGroupId`: string — The audio group ID for audio outputs.

  **Default:** service default

- `audioRenditionSets`: string — The audio rendition sets for video outputs.

  **Default:** service default

- `captions`: [EncodeConfiguration](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.EncodeConfiguration.html)[] — Caption encodes that ride alongside the primary encode.

  **Default:** no captions on this output

  Only in-band caption types are
  allowed (burn-in, embedded) — out-of-band captions must go in their own output.

- `encode`: [EncodeConfiguration](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.EncodeConfiguration.html) (required) — The primary encode for this output — one video or one audio track.

- `hlsAutoSelect`: [MediaPackageV2HlsSetting](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.MediaPackageV2HlsSetting.html) = MediaPackageV2HlsSetting.OMIT — For audio outputs, whether MediaPackage sets this rendition as the auto-select rendition in the HLS manifest.

- `hlsDefault`: [MediaPackageV2HlsSetting](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.MediaPackageV2HlsSetting.html) = MediaPackageV2HlsSetting.OMIT — For audio outputs, whether MediaPackage sets this rendition as the default rendition in the HLS manifest.

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

  Must be unique across all outputs in the channel.