feat(client-mediaconvert): The AWS Elemental MediaConvert SDK has added support for configurable ID3 eMSG box attributes and the ability to signal them with InbandEventStream tags in DASH and CMAF outputs.

Author: awstools

clients/client-mediaconvert/src/commands/GetPolicyCommand.ts

@@ -14,12 +14,8 @@ import {
 } from "@aws-sdk/types";
 
 import { MediaConvertClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../MediaConvertClient";
-import {
-  GetPolicyRequest,
-  GetPolicyRequestFilterSensitiveLog,
-  GetPolicyResponse,
-  GetPolicyResponseFilterSensitiveLog,
-} from "../models/models_1";
+import { GetPolicyRequest, GetPolicyRequestFilterSensitiveLog } from "../models/models_1";
+import { GetPolicyResponse, GetPolicyResponseFilterSensitiveLog } from "../models/models_2";
 import {
   deserializeAws_restJson1GetPolicyCommand,
   serializeAws_restJson1GetPolicyCommand,

clients/client-mediaconvert/src/commands/GetPresetCommand.ts

@@ -19,7 +19,7 @@ import {
   GetPresetRequestFilterSensitiveLog,
   GetPresetResponse,
   GetPresetResponseFilterSensitiveLog,
-} from "../models/models_1";
+} from "../models/models_2";
 import {
   deserializeAws_restJson1GetPresetCommand,
   serializeAws_restJson1GetPresetCommand,

clients/client-mediaconvert/src/commands/GetQueueCommand.ts

@@ -19,7 +19,7 @@ import {
   GetQueueRequestFilterSensitiveLog,
   GetQueueResponse,
   GetQueueResponseFilterSensitiveLog,
-} from "../models/models_1";
+} from "../models/models_2";
 import {
   deserializeAws_restJson1GetQueueCommand,
   serializeAws_restJson1GetQueueCommand,

clients/client-mediaconvert/src/commands/ListJobsCommand.ts

@@ -14,8 +14,12 @@ import {
 } from "@aws-sdk/types";
 
 import { MediaConvertClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../MediaConvertClient";
-import { ListJobsRequest, ListJobsRequestFilterSensitiveLog } from "../models/models_1";
-import { ListJobsResponse, ListJobsResponseFilterSensitiveLog } from "../models/models_2";
+import {
+  ListJobsRequest,
+  ListJobsRequestFilterSensitiveLog,
+  ListJobsResponse,
+  ListJobsResponseFilterSensitiveLog,
+} from "../models/models_2";
 import {
   deserializeAws_restJson1ListJobsCommand,
   serializeAws_restJson1ListJobsCommand,

clients/client-mediaconvert/src/models/models_0.ts

@@ -160,7 +160,7 @@ export enum AacVbrQuality {
  */
 export interface AacSettings {
   /**
-   * Choose BROADCASTER_MIXED_AD when the input contains pre-mixed main audio + audio description (AD) as a stereo pair. The value for AudioType will be set to 3, which signals to downstream systems that this stream contains "broadcaster mixed AD". Note that the input received by the encoder must contain pre-mixed audio; the encoder does not perform the mixing. When you choose BROADCASTER_MIXED_AD, the encoder ignores any values you provide in AudioType and  FollowInputAudioType. Choose NORMAL when the input does not contain pre-mixed audio + audio description (AD). In this case, the encoder will use any values you provide for AudioType and FollowInputAudioType.
+   * Choose BROADCASTER_MIXED_AD when the input contains pre-mixed main audio + audio description (AD) as a stereo pair. The value for AudioType will be set to 3, which signals to downstream systems that this stream contains "broadcaster mixed AD". Note that the input received by the encoder must contain pre-mixed audio; the encoder does not perform the mixing. When you choose BROADCASTER_MIXED_AD, the encoder ignores any values you provide in AudioType and FollowInputAudioType. Choose NORMAL when the input does not contain pre-mixed audio + audio description (AD). In this case, the encoder will use any values you provide for AudioType and FollowInputAudioType.
    */
   AudioDescriptionBroadcasterMix?: AacAudioDescriptionBroadcasterMix | string;
 
@@ -175,7 +175,7 @@ export interface AacSettings {
   CodecProfile?: AacCodecProfile | string;
 
   /**
-   * Mono (Audio Description), Mono, Stereo, or 5.1 channel layout. Valid values depend on rate control mode and profile. "1.0 - Audio Description (Receiver Mix)" setting receives a stereo description plus control track and emits a mono AAC encode of the description track, with control data emitted in the PES header as per ETSI TS 101 154 Annex E.
+   * The Coding mode that you specify determines the number of audio channels and the audio channel layout metadata in your AAC output. Valid coding modes depend on the Rate control mode and Profile that you select. The following list shows the number of audio channels and channel layout for each coding mode. * 1.0 Audio Description (Receiver Mix): One channel, C. Includes audio description data from your stereo input. For more information see ETSI TS 101 154 Annex E. * 1.0 Mono: One channel, C. * 2.0 Stereo: Two channels, L, R. * 5.1 Surround: Five channels, C, L, R, Ls, Rs, LFE.
    */
   CodingMode?: AacCodingMode | string;
 
@@ -190,7 +190,7 @@ export interface AacSettings {
   RawFormat?: AacRawFormat | string;
 
   /**
-   * Sample rate in Hz. Valid values depend on rate control mode and profile.
+   * Specify the Sample rate in Hz. Valid sample rates depend on the Profile and Coding mode that you select. The following list shows valid sample rates for each Profile and Coding mode. * LC Profile, Coding mode 1.0, 2.0, and Receiver Mix: 8000, 12000, 16000, 22050, 24000, 32000, 44100, 48000, 88200, 96000. * LC Profile, Coding mode 5.1: 32000, 44100, 48000, 96000. * HEV1 Profile, Coding mode 1.0 and Receiver Mix: 22050, 24000, 32000, 44100, 48000. * HEV1 Profile, Coding mode 2.0 and 5.1: 32000, 44100, 48000, 96000. * HEV2 Profile, Coding mode 2.0: 22050, 24000, 32000, 44100, 48000.
    */
   SampleRate?: number;
 
@@ -3676,6 +3676,11 @@ export enum CmafManifestDurationFormat {
   INTEGER = "INTEGER",
 }
 
+export enum CmafMpdManifestBandwidthType {
+  AVERAGE = "AVERAGE",
+  MAX = "MAX",
+}
+
 export enum CmafMpdProfile {
   MAIN_PROFILE = "MAIN_PROFILE",
   ON_DEMAND_PROFILE = "ON_DEMAND_PROFILE",
@@ -3706,6 +3711,11 @@ export enum CmafTargetDurationCompatibilityMode {
   SPEC_COMPLIANT = "SPEC_COMPLIANT",
 }
 
+export enum CmafVideoCompositionOffsets {
+  SIGNED = "SIGNED",
+  UNSIGNED = "UNSIGNED",
+}
+
 export enum CmafWriteDASHManifest {
   DISABLED = "DISABLED",
   ENABLED = "ENABLED",
@@ -3795,6 +3805,11 @@ export interface CmafGroupSettings {
    */
   MinFinalSegmentLength?: number;
 
+  /**
+   * Specify how the value for bandwidth is determined for each video Representation in your output MPD manifest. We recommend that you choose a MPD manifest bandwidth type that is compatible with your downstream player configuration. Max: Use the same value that you specify for Max bitrate in the video output, in bits per second. Average: Use the calculated average bitrate of the encoded video output, in bits per second.
+   */
+  MpdManifestBandwidthType?: CmafMpdManifestBandwidthType | string;
+
   /**
    * Specify whether your DASH profile is on-demand or main. When you choose Main profile (MAIN_PROFILE), the service signals  urn:mpeg:dash:profile:isoff-main:2011 in your .mpd DASH manifest. When you choose On-demand (ON_DEMAND_PROFILE), the service signals urn:mpeg:dash:profile:isoff-on-demand:2011 in your .mpd. When you choose On-demand, you must also set the output group setting Segment control (SegmentControl) to Single file (SINGLE_FILE).
    */
@@ -3830,6 +3845,11 @@ export interface CmafGroupSettings {
    */
   TargetDurationCompatibilityMode?: CmafTargetDurationCompatibilityMode | string;
 
+  /**
+   * Specify the video sample composition time offset mode in the output fMP4 TRUN box. For wider player compatibility, set Video composition offsets to Unsigned or leave blank. The earliest presentation time may be greater than zero, and sample composition time offsets will increment using unsigned integers. For strict fMP4 video and audio timing, set Video composition offsets to Signed. The earliest presentation time will be equal to zero, and sample composition time offsets will increment using signed integers.
+   */
+  VideoCompositionOffsets?: CmafVideoCompositionOffsets | string;
+
   /**
    * When set to ENABLED, a DASH MPD manifest will be generated for this output.
    */
@@ -3949,6 +3969,11 @@ export interface DashIsoImageBasedTrickPlaySettings {
   TileWidth?: number;
 }
 
+export enum DashIsoMpdManifestBandwidthType {
+  AVERAGE = "AVERAGE",
+  MAX = "MAX",
+}
+
 export enum DashIsoMpdProfile {
   MAIN_PROFILE = "MAIN_PROFILE",
   ON_DEMAND_PROFILE = "ON_DEMAND_PROFILE",
@@ -3969,6 +3994,11 @@ export enum DashIsoSegmentLengthControl {
   GOP_MULTIPLE = "GOP_MULTIPLE",
 }
 
+export enum DashIsoVideoCompositionOffsets {
+  SIGNED = "SIGNED",
+  UNSIGNED = "UNSIGNED",
+}
+
 export enum DashIsoWriteSegmentTimelineInRepresentation {
   DISABLED = "DISABLED",
   ENABLED = "ENABLED",
@@ -4038,6 +4068,11 @@ export interface DashIsoGroupSettings {
    */
   MinFinalSegmentLength?: number;
 
+  /**
+   * Specify how the value for bandwidth is determined for each video Representation in your output MPD manifest. We recommend that you choose a MPD manifest bandwidth type that is compatible with your downstream player configuration. Max: Use the same value that you specify for Max bitrate in the video output, in bits per second. Average: Use the calculated average bitrate of the encoded video output, in bits per second.
+   */
+  MpdManifestBandwidthType?: DashIsoMpdManifestBandwidthType | string;
+
   /**
    * Specify whether your DASH profile is on-demand or main. When you choose Main profile (MAIN_PROFILE), the service signals  urn:mpeg:dash:profile:isoff-main:2011 in your .mpd DASH manifest. When you choose On-demand (ON_DEMAND_PROFILE), the service signals urn:mpeg:dash:profile:isoff-on-demand:2011 in your .mpd. When you choose On-demand, you must also set the output group setting Segment control (SegmentControl) to Single file (SINGLE_FILE).
    */
@@ -4063,6 +4098,11 @@ export interface DashIsoGroupSettings {
    */
   SegmentLengthControl?: DashIsoSegmentLengthControl | string;
 
+  /**
+   * Specify the video sample composition time offset mode in the output fMP4 TRUN box. For wider player compatibility, set Video composition offsets to Unsigned or leave blank. The earliest presentation time may be greater than zero, and sample composition time offsets will increment using unsigned integers. For strict fMP4 video and audio timing, set Video composition offsets to Signed. The earliest presentation time will be equal to zero, and sample composition time offsets will increment using signed integers.
+   */
+  VideoCompositionOffsets?: DashIsoVideoCompositionOffsets | string;
+
   /**
    * If you get an HTTP error in the 400 range when you play back your DASH output, enable this setting and run your transcoding job again. When you enable this setting, the service writes precise segment durations in the DASH manifest. The segment duration information appears inside the SegmentTimeline element, inside SegmentTemplate at the Representation level. When you don't enable this setting, the service writes approximate segment durations in your DASH manifest.
    */
@@ -4582,6 +4622,11 @@ export enum CmfcKlvMetadata {
   PASSTHROUGH = "PASSTHROUGH",
 }
 
+export enum CmfcManifestMetadataSignaling {
+  DISABLED = "DISABLED",
+  ENABLED = "ENABLED",
+}
+
 export enum CmfcScte35Esam {
   INSERT = "INSERT",
   NONE = "NONE",
@@ -4597,6 +4642,11 @@ export enum CmfcTimedMetadata {
   PASSTHROUGH = "PASSTHROUGH",
 }
 
+export enum CmfcTimedMetadataBoxVersion {
+  VERSION_0 = "VERSION_0",
+  VERSION_1 = "VERSION_1",
+}
+
 /**
  * These settings relate to the fragmented MP4 container for the segments in your CMAF outputs.
  */
@@ -4636,6 +4686,11 @@ export interface CmfcSettings {
    */
   KlvMetadata?: CmfcKlvMetadata | string;
 
+  /**
+   * To add an InbandEventStream element in your output MPD manifest for each type of event message, set Manifest metadata signaling to Enabled. For ID3 event messages, the InbandEventStream element schemeIdUri will be same value that you specify for ID3 metadata scheme ID URI. For SCTE35 event messages, the InbandEventStream element schemeIdUri will be "urn:scte:scte35:2013:bin". To leave these elements out of your output MPD manifest, set Manifest metadata signaling to Disabled.
+   */
+  ManifestMetadataSignaling?: CmfcManifestMetadataSignaling | string;
+
   /**
    * Use this setting only when you specify SCTE-35 markers from ESAM. Choose INSERT to put SCTE-35 markers in this output at the insertion points that you specify in an ESAM XML document. Provide the document in the setting SCC XML (sccXml).
    */
@@ -4650,6 +4705,24 @@ export interface CmfcSettings {
    * To include ID3 metadata in this output: Set ID3 metadata (timedMetadata) to Passthrough (PASSTHROUGH). Specify this ID3 metadata in Custom ID3 metadata inserter (timedMetadataInsertion). MediaConvert writes each instance of ID3 metadata in a separate Event Message (eMSG) box. To exclude this ID3 metadata: Set ID3 metadata to None (NONE) or leave blank.
    */
   TimedMetadata?: CmfcTimedMetadata | string;
+
+  /**
+   * Specify the event message box (eMSG) version for ID3 timed metadata in your output.
+   * For more information, see ISO/IEC 23009-1:2022 section 5.10.3.3.3 Syntax.
+   * Leave blank to use the default value Version 0.
+   * When you specify Version 1, you must also set ID3 metadata (timedMetadata) to Passthrough.
+   */
+  TimedMetadataBoxVersion?: CmfcTimedMetadataBoxVersion | string;
+
+  /**
+   * Specify the event message box (eMSG) scheme ID URI (scheme_id_uri) for ID3 timed metadata in your output. For more informaiton, see ISO/IEC 23009-1:2022 section 5.10.3.3.4 Semantics. Leave blank to use the default value: https://aomedia.org/emsg/ID3 When you specify a value for ID3 metadata scheme ID URI, you must also set ID3 metadata (timedMetadata) to Passthrough.
+   */
+  TimedMetadataSchemeIdUri?: string;
+
+  /**
+   * Specify the event message box (eMSG) value for ID3 timed metadata in your output. For more informaiton, see ISO/IEC 23009-1:2022 section 5.10.3.3.4 Semantics. When you specify a value for ID3 Metadata Value, you must also set ID3 metadata (timedMetadata) to Passthrough.
+   */
+  TimedMetadataValue?: string;
 }
 
 export enum ContainerType {
@@ -4728,61 +4801,6 @@ export enum OutputSdt {
   SDT_NONE = "SDT_NONE",
 }
 
-/**
- * Use these settings to insert a DVB Service Description Table (SDT) in the transport stream of this output. When you work directly in your JSON job specification, include this object only when your job has a transport stream output and the container settings contain the object M2tsSettings.
- */
-export interface DvbSdtSettings {
-  /**
-   * Selects method of inserting SDT information into output stream.  "Follow input SDT" copies SDT information from input stream to  output stream. "Follow input SDT if present" copies SDT information from  input stream to output stream if SDT information is present in the input, otherwise it will fall back on the user-defined values. Enter "SDT  Manually" means user will enter the SDT information. "No SDT" means output  stream will not contain SDT information.
-   */
-  OutputSdt?: OutputSdt | string;
-
-  /**
-   * The number of milliseconds between instances of this table in the output transport stream.
-   */
-  SdtInterval?: number;
-
-  /**
-   * The service name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.
-   */
-  ServiceName?: string;
-
-  /**
-   * The service provider name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.
-   */
-  ServiceProviderName?: string;
-}
-
-/**
- * Use these settings to insert a DVB Time and Date Table (TDT) in the transport stream of this output. When you work directly in your JSON job specification, include this object only when your job has a transport stream output and the container settings contain the object M2tsSettings.
- */
-export interface DvbTdtSettings {
-  /**
-   * The number of milliseconds between instances of this table in the output transport stream.
-   */
-  TdtInterval?: number;
-}
-
-export enum M2tsEbpAudioInterval {
-  VIDEO_AND_FIXED_INTERVALS = "VIDEO_AND_FIXED_INTERVALS",
-  VIDEO_INTERVAL = "VIDEO_INTERVAL",
-}
-
-export enum M2tsEbpPlacement {
-  VIDEO_AND_AUDIO_PIDS = "VIDEO_AND_AUDIO_PIDS",
-  VIDEO_PID = "VIDEO_PID",
-}
-
-export enum M2tsEsRateInPes {
-  EXCLUDE = "EXCLUDE",
-  INCLUDE = "INCLUDE",
-}
-
-export enum M2tsForceTsVideoEbpOrder {
-  DEFAULT = "DEFAULT",
-  FORCE = "FORCE",
-}
-
 /**
  * @internal
  */
@@ -5533,17 +5551,3 @@ export const F4vSettingsFilterSensitiveLog = (obj: F4vSettings): any => ({
 export const DvbNitSettingsFilterSensitiveLog = (obj: DvbNitSettings): any => ({
   ...obj,
 });
-
-/**
- * @internal
- */
-export const DvbSdtSettingsFilterSensitiveLog = (obj: DvbSdtSettings): any => ({
-  ...obj,
-});
-
-/**
- * @internal
- */
-export const DvbTdtSettingsFilterSensitiveLog = (obj: DvbTdtSettings): any => ({
-  ...obj,
-});