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

Properties for MPEG-2 transport stream (M2TS) container settings.

Used by the UDP, Archive, SRT, and MediaConnect Router output groups. All properties are
optional; omit them to use MediaLive's service defaults.

PID properties accept a decimal or hexadecimal value (and, where noted, ranges or comma-separated
lists). Each PID must be in the range 32 (0x20)..8182 (0x1ff6).

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

## Example

```ts
declare const video: medialive.EncodeConfiguration;
declare const audio: medialive.EncodeConfiguration;

medialive.OutputGroupConfiguration.udp({
  name: 'udp_out',
  destinations: [medialive.UdpOutputDestination.udp({ address: '203.0.113.5', port: 5000 })],
  outputs: [{
    encodes: [video, audio],
    outputName: 'ts',
    m2tsSettings: medialive.M2tsSettings.of({
      bitrate: Bitrate.mbps(8),
      rateMode: medialive.M2tsRateMode.VBR,
      programNum: 1,
      patInterval: Duration.millis(100),
      pmtInterval: Duration.millis(100),
      scte35Control: medialive.M2tsScte35Control.PASSTHROUGH,
      dvbSdtSettings: {
        outputSdt: medialive.DvbSdtOutputMode.SDT_MANUAL,
        serviceName: 'My Service',
        repInterval: Duration.millis(2000),
      },
    }),
  }],
});
```

## Properties

- `absentInputAudioBehavior`: [M2tsAbsentInputAudioBehavior](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.M2tsAbsentInputAudioBehavior.html) — Behavior when the selected input audio stream is removed.

  **Default:** service default

- `arib`: [M2tsArib](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.M2tsArib.html) — ARIB-compliant field muxing.

  **Default:** service default

- `aribCaptionsPid`: string — The PID for ARIB Captions.

  **Default:** service default

- `aribCaptionsPidControl`: [M2tsAribCaptionsPidControl](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.M2tsAribCaptionsPidControl.html) — How the ARIB Captions PID is selected.

  **Default:** service default

- `audioBufferModel`: [M2tsAudioBufferModel](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.M2tsAudioBufferModel.html) — The buffer model for Dolby Digital audio.

  **Default:** service default

- `audioFramesPerPes`: number — The number of audio frames to insert per PES packet.

  **Default:** service default

- `audioPids`: string — The PID(s) of the elementary audio streams (ranges/comma-separated allowed).

  **Default:** service default

- `audioStreamType`: [M2tsAudioStreamType](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.M2tsAudioStreamType.html) — The stream type used for audio elementary streams.

  **Default:** service default

- `bitrate`: [Bitrate](/cdk/api/v2/docs/aws-cdk-lib.Bitrate.html) — The output bitrate of the transport stream.

  **Default:** muxer chooses

  Set to 0 bps to let the muxer choose.

- `bufferModel`: [M2tsBufferModel](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.M2tsBufferModel.html) — The transport stream buffer model.

  **Default:** service default

- `ccDescriptor`: [M2tsCcDescriptor](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.M2tsCcDescriptor.html) — Whether to generate the captionServiceDescriptor in the PMT.

  **Default:** service default

- `dvbNitSettings`: [DvbNitSettings](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.DvbNitSettings.html) — DVB Network Information Table (NIT) settings.

  **Default:** no NIT

- `dvbSdtSettings`: [DvbSdtSettings](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.DvbSdtSettings.html) — DVB Service Description Table (SDT) settings.

  **Default:** no SDT

- `dvbSubPids`: string — The PID(s) for input source DVB Subtitle data (ranges/comma-separated allowed).

  **Default:** service default

- `dvbTdtSettings`: [DvbTdtSettings](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.DvbTdtSettings.html) — DVB Time and Date Table (TDT) settings.

  **Default:** no TDT

- `dvbTeletextPid`: string — The PID for input source DVB Teletext data.

  **Default:** service default

- `ebif`: [M2tsEbif](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.M2tsEbif.html) — EBIF data passthrough behavior.

  **Default:** service default

- `ebpAudioInterval`: [M2tsEbpAudioInterval](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.M2tsEbpAudioInterval.html) — Placement of audio EBP markers.

  **Default:** service default

- `ebpLookahead`: [Duration](/cdk/api/v2/docs/aws-cdk-lib.Duration.html) — The EBP lookahead interval.

  **Default:** service default

- `ebpPlacement`: [M2tsEbpPlacement](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.M2tsEbpPlacement.html) — Placement of EBP markers on audio PIDs.

  **Default:** service default

- `esRateInPes`: [M2tsEsRateInPes](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.M2tsEsRateInPes.html) — Whether to include the ES Rate field in the PES header.

  **Default:** service default

- `etvPlatformPid`: string — The PID for input source ETV Platform data.

  **Default:** service default

- `etvSignalPid`: string — The PID for input source ETV Signal data.

  **Default:** service default

- `fragmentTime`: [Duration](/cdk/api/v2/docs/aws-cdk-lib.Duration.html) — The length of each fragment (used only with EBP markers).

  **Default:** service default

- `klv`: [M2tsKlv](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.M2tsKlv.html) — KLV data passthrough behavior.

  **Default:** service default

- `klvDataPids`: string — The PID(s) for input source KLV data (ranges/comma-separated allowed).

  **Default:** service default

- `nielsenId3Behavior`: [M2tsNielsenId3Behavior](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.M2tsNielsenId3Behavior.html) — Nielsen ID3 passthrough behavior.

  **Default:** service default

- `nullPacketBitrate`: [Bitrate](/cdk/api/v2/docs/aws-cdk-lib.Bitrate.html) — The bitrate of extra null packets to insert into the transport stream.

  **Default:** no null packets

- `patInterval`: [Duration](/cdk/api/v2/docs/aws-cdk-lib.Duration.html) — The interval between PAT instances (0, or 10ms..1000ms).

  **Default:** service default

- `pcrControl`: [M2tsPcrControl](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.M2tsPcrControl.html) — Controls insertion of the Program Clock Reference (PCR).

  **Default:** service default

- `pcrPeriod`: [Duration](/cdk/api/v2/docs/aws-cdk-lib.Duration.html) — The maximum interval between Program Clock References (PCRs).

  **Default:** service default

- `pcrPid`: string — The PID of the Program Clock Reference.

  **Default:** same as the video PID

- `pmtInterval`: [Duration](/cdk/api/v2/docs/aws-cdk-lib.Duration.html) — The interval between PMT instances (0, or 10ms..1000ms).

  **Default:** service default

- `pmtPid`: string — The PID for the Program Map Table (PMT).

  **Default:** service default

- `programNum`: number — The value of the program number field in the PMT.

  **Default:** service default

- `rateMode`: [M2tsRateMode](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.M2tsRateMode.html) — The transport stream bitrate mode (CBR/VBR).

  **Default:** service default

- `scte27Pids`: string — The PID(s) for input source SCTE-27 data (ranges/comma-separated allowed).

  **Default:** service default

- `scte35Control`: [M2tsScte35Control](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.M2tsScte35Control.html) — SCTE-35 passthrough behavior.

  **Default:** service default

- `scte35Pid`: string — The PID of the SCTE-35 stream.

  **Default:** service default

- `scte35PrerollPullup`: [Duration](/cdk/api/v2/docs/aws-cdk-lib.Duration.html) — The SCTE-35 preroll pullup interval.

  **Default:** service default

- `segmentationMarkers`: [M2tsSegmentationMarkers](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.M2tsSegmentationMarkers.html) — The type of segmentation markers to insert.

  **Default:** service default

- `segmentationStyle`: [M2tsSegmentationStyle](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.M2tsSegmentationStyle.html) — How segmentation markers respond to avails.

  **Default:** service default

- `segmentationTime`: [Duration](/cdk/api/v2/docs/aws-cdk-lib.Duration.html) — The length of each segment (required unless `segmentationMarkers` is NONE).

  **Default:** service default

- `timedMetadataBehavior`: [M2tsTimedMetadataBehavior](/cdk/api/v2/docs/@aws-cdk_aws-medialive-alpha.M2tsTimedMetadataBehavior.html) — Timed metadata passthrough behavior.

  **Default:** service default

- `timedMetadataPid`: string — The PID of the timed metadata stream.

  **Default:** service default

- `transportStreamId`: number — The value of the transport stream ID field in the PMT.

  **Default:** service default

- `videoPid`: string — The PID of the elementary video stream.

  **Default:** service default