feat(client-mediaconvert): AWS Elemental MediaConvert SDK has added support for rules that constrain Automatic-ABR rendition selection when generating ABR package ladders.

Author: awstools

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

@@ -13,7 +13,7 @@ import {
 } from "@aws-sdk/types";
 
 import { MediaConvertClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../MediaConvertClient";
-import { ListJobTemplatesRequest, ListJobTemplatesResponse } from "../models/models_1";
+import { ListJobTemplatesRequest, ListJobTemplatesResponse } from "../models/models_2";
 import {
   deserializeAws_restJson1ListJobTemplatesCommand,
   serializeAws_restJson1ListJobTemplatesCommand,

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

@@ -13,7 +13,7 @@ import {
 } from "@aws-sdk/types";
 
 import { MediaConvertClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../MediaConvertClient";
-import { ListPresetsRequest, ListPresetsResponse } from "../models/models_1";
+import { ListPresetsRequest, ListPresetsResponse } from "../models/models_2";
 import {
   deserializeAws_restJson1ListPresetsCommand,
   serializeAws_restJson1ListPresetsCommand,

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

@@ -13,8 +13,7 @@ import {
 } from "@aws-sdk/types";
 
 import { MediaConvertClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../MediaConvertClient";
-import { ListQueuesRequest } from "../models/models_1";
-import { ListQueuesResponse } from "../models/models_2";
+import { ListQueuesRequest, ListQueuesResponse } from "../models/models_2";
 import {
   deserializeAws_restJson1ListQueuesCommand,
   serializeAws_restJson1ListQueuesCommand,

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

@@ -1,4 +1,38 @@
 // smithy-typescript generated code
+export enum RequiredFlag {
+  DISABLED = "DISABLED",
+  ENABLED = "ENABLED",
+}
+
+/**
+ * Use Allowed renditions to specify a list of possible resolutions in your ABR stack. * MediaConvert will create an ABR stack exclusively from the list of resolutions that you specify. * Some resolutions in the Allowed renditions list may not be included, however you can force a resolution to be included by setting Required to ENABLED. * You must specify at least one resolution that is greater than or equal to any resolutions that you specify in Min top rendition size or Min bottom rendition size. * If you specify Allowed renditions, you must not specify a separate rule for Force include renditions.
+ */
+export interface AllowedRenditionSize {
+  /**
+   * Use Height to define the video resolution height, in pixels, for this rule.
+   */
+  Height?: number;
+
+  /**
+   * Set to ENABLED to force a rendition to be included.
+   */
+  Required?: RequiredFlag | string;
+
+  /**
+   * Use Width to define the video resolution width, in pixels, for this rule.
+   */
+  Width?: number;
+}
+
+export namespace AllowedRenditionSize {
+  /**
+   * @internal
+   */
+  export const filterSensitiveLog = (obj: AllowedRenditionSize): any => ({
+    ...obj,
+  });
+}
+
 export enum AudioChannelTag {
   C = "C",
   CS = "CS",
@@ -1314,6 +1348,124 @@ export namespace AudioDescription {
   });
 }
 
+/**
+ * Use Force include renditions to specify one or more resolutions to include your ABR stack. * (Recommended) To optimize automated ABR, specify as few resolutions as possible. * (Required) The number of resolutions that you specify must be equal to, or less than, the Max renditions setting. * If you specify a Min top rendition size rule, specify at least one resolution that is equal to, or greater than, Min top rendition size. * If you specify a Min bottom rendition size rule, only specify resolutions that are equal to, or greater than, Min bottom rendition size. * If you specify a Force include renditions rule, do not specify a separate rule for Allowed renditions. * Note: The ABR stack may include other resolutions that you do not specify here, depending on the Max renditions setting.
+ */
+export interface ForceIncludeRenditionSize {
+  /**
+   * Use Height to define the video resolution height, in pixels, for this rule.
+   */
+  Height?: number;
+
+  /**
+   * Use Width to define the video resolution width, in pixels, for this rule.
+   */
+  Width?: number;
+}
+
+export namespace ForceIncludeRenditionSize {
+  /**
+   * @internal
+   */
+  export const filterSensitiveLog = (obj: ForceIncludeRenditionSize): any => ({
+    ...obj,
+  });
+}
+
+/**
+ * Use Min bottom rendition size to specify a minimum size for the lowest resolution in your ABR stack. * The lowest resolution in your ABR stack will be equal to or greater than the value that you enter. For example: If you specify 640x360 the lowest resolution in your ABR stack will be equal to or greater than to 640x360. * If you specify a Min top rendition size rule, the value that you specify for Min bottom rendition size must be less than, or equal to, Min top rendition size.
+ */
+export interface MinBottomRenditionSize {
+  /**
+   * Use Height to define the video resolution height, in pixels, for this rule.
+   */
+  Height?: number;
+
+  /**
+   * Use Width to define the video resolution width, in pixels, for this rule.
+   */
+  Width?: number;
+}
+
+export namespace MinBottomRenditionSize {
+  /**
+   * @internal
+   */
+  export const filterSensitiveLog = (obj: MinBottomRenditionSize): any => ({
+    ...obj,
+  });
+}
+
+/**
+ * Use Min top rendition size to specify a minimum size for the highest resolution in your ABR stack. * The highest resolution in your ABR stack will be equal to or greater than the value that you enter. For example: If you specify 1280x720 the highest resolution in your ABR stack will be equal to or greater than 1280x720. * If you specify a value for Max resolution, the value that you specify for Min top rendition size must be less than, or equal to, Max resolution.
+ */
+export interface MinTopRenditionSize {
+  /**
+   * Use Height to define the video resolution height, in pixels, for this rule.
+   */
+  Height?: number;
+
+  /**
+   * Use Width to define the video resolution width, in pixels, for this rule.
+   */
+  Width?: number;
+}
+
+export namespace MinTopRenditionSize {
+  /**
+   * @internal
+   */
+  export const filterSensitiveLog = (obj: MinTopRenditionSize): any => ({
+    ...obj,
+  });
+}
+
+export enum RuleType {
+  ALLOWED_RENDITIONS = "ALLOWED_RENDITIONS",
+  FORCE_INCLUDE_RENDITIONS = "FORCE_INCLUDE_RENDITIONS",
+  MIN_BOTTOM_RENDITION_SIZE = "MIN_BOTTOM_RENDITION_SIZE",
+  MIN_TOP_RENDITION_SIZE = "MIN_TOP_RENDITION_SIZE",
+}
+
+/**
+ * Specify one or more Automated ABR rule types. Note: Force include and Allowed renditions are mutually exclusive.
+ */
+export interface AutomatedAbrRule {
+  /**
+   * When customer adds the allowed renditions rule for auto ABR ladder, they are required to add at leat one rendition to allowedRenditions list
+   */
+  AllowedRenditions?: AllowedRenditionSize[];
+
+  /**
+   * When customer adds the force include renditions rule for auto ABR ladder, they are required to add at leat one rendition to forceIncludeRenditions list
+   */
+  ForceIncludeRenditions?: ForceIncludeRenditionSize[];
+
+  /**
+   * Use Min bottom rendition size to specify a minimum size for the lowest resolution in your ABR stack. * The lowest resolution in your ABR stack will be equal to or greater than the value that you enter. For example: If you specify 640x360 the lowest resolution in your ABR stack will be equal to or greater than to 640x360. * If you specify a Min top rendition size rule, the value that you specify for Min bottom rendition size must be less than, or equal to, Min top rendition size.
+   */
+  MinBottomRenditionSize?: MinBottomRenditionSize;
+
+  /**
+   * Use Min top rendition size to specify a minimum size for the highest resolution in your ABR stack. * The highest resolution in your ABR stack will be equal to or greater than the value that you enter. For example: If you specify 1280x720 the highest resolution in your ABR stack will be equal to or greater than 1280x720. * If you specify a value for Max resolution, the value that you specify for Min top rendition size must be less than, or equal to, Max resolution.
+   */
+  MinTopRenditionSize?: MinTopRenditionSize;
+
+  /**
+   * Use Min top rendition size to specify a minimum size for the highest resolution in your ABR stack. * The highest resolution in your ABR stack will be equal to or greater than the value that you enter. For example: If you specify 1280x720 the highest resolution in your ABR stack will be equal to or greater than 1280x720. * If you specify a value for Max resolution, the value that you specify for Min top rendition size must be less than, or equal to, Max resolution. Use Min bottom rendition size to specify a minimum size for the lowest resolution in your ABR stack. * The lowest resolution in your ABR stack will be equal to or greater than the value that you enter. For example: If you specify 640x360 the lowest resolution in your ABR stack will be equal to or greater than to 640x360. * If you specify a Min top rendition size rule, the value that you specify for Min bottom rendition size must be less than, or equal to, Min top rendition size. Use Force include renditions to specify one or more resolutions to include your ABR stack. * (Recommended) To optimize automated ABR, specify as few resolutions as possible. * (Required) The number of resolutions that you specify must be equal to, or less than, the Max renditions setting. * If you specify a Min top rendition size rule, specify at least one resolution that is equal to, or greater than, Min top rendition size. * If you specify a Min bottom rendition size rule, only specify resolutions that are equal to, or greater than, Min bottom rendition size. * If you specify a Force include renditions rule, do not specify a separate rule for Allowed renditions. * Note: The ABR stack may include other resolutions that you do not specify here, depending on the Max renditions setting. Use Allowed renditions to specify a list of possible resolutions in your ABR stack. * (Required) The number of resolutions that you specify must be equal to, or greater than, the Max renditions setting. * MediaConvert will create an ABR stack exclusively from the list of resolutions that you specify. * Some resolutions in the Allowed renditions list may not be included, however you can force a resolution to be included by setting Required to ENABLED. * You must specify at least one resolution that is greater than or equal to any resolutions that you specify in Min top rendition size or Min bottom rendition size. * If you specify Allowed renditions, you must not specify a separate rule for Force include renditions.
+   */
+  Type?: RuleType | string;
+}
+
+export namespace AutomatedAbrRule {
+  /**
+   * @internal
+   */
+  export const filterSensitiveLog = (obj: AutomatedAbrRule): any => ({
+    ...obj,
+  });
+}
+
 export enum BurninSubtitleAlignment {
   AUTO = "AUTO",
   CENTERED = "CENTERED",
@@ -1785,7 +1937,7 @@ export enum ImscStylePassthrough {
  */
 export interface ImscDestinationSettings {
   /**
-   * Set Accessibility subtitles (Accessibility) to Enabled (ENABLED) if the ISMC or WebVTT captions track is intended to provide accessibility for people who are deaf or hard of hearing. When you enable this feature, MediaConvert adds the following attributes under EXT-X-MEDIA in the HLS or CMAF manifest for this track: CHARACTERISTICS="public.accessibility.describes-spoken-dialog,public.accessibility.describes-music-and-sound" and AUTOSELECT="YES". Keep the default value, Disabled (DISABLED), if the captions track is not intended to provide such accessibility. MediaConvert will not add the above attributes.
+   * Set Accessibility subtitles to Enabled if the ISMC or WebVTT captions track is intended to provide accessibility for people who are deaf or hard of hearing. When you enable this feature, MediaConvert adds the following attributes under EXT-X-MEDIA in the HLS or CMAF manifest for this track: CHARACTERISTICS="public.accessibility.describes-spoken-dialog,public.accessibility.describes-music-and-sound" and AUTOSELECT="YES". Keep the default value, Disabled, if the captions track is not intended to provide such accessibility. MediaConvert will not add the above attributes.
    */
   Accessibility?: ImscAccessibilitySubs | string;
 
@@ -1927,7 +2079,7 @@ export enum WebvttStylePassthrough {
  */
 export interface WebvttDestinationSettings {
   /**
-   * Set Accessibility subtitles (Accessibility) to Enabled (ENABLED) if the ISMC or WebVTT captions track is intended to provide accessibility for people who are deaf or hard of hearing. When you enable this feature, MediaConvert adds the following attributes under EXT-X-MEDIA in the HLS or CMAF manifest for this track: CHARACTERISTICS="public.accessibility.describes-spoken-dialog,public.accessibility.describes-music-and-sound" and AUTOSELECT="YES". Keep the default value, Disabled (DISABLED), if the captions track is not intended to provide such accessibility. MediaConvert will not add the above attributes.
+   * Set Accessibility subtitles to Enabled if the ISMC or WebVTT captions track is intended to provide accessibility for people who are deaf or hard of hearing. When you enable this feature, MediaConvert adds the following attributes under EXT-X-MEDIA in the HLS or CMAF manifest for this track: CHARACTERISTICS="public.accessibility.describes-spoken-dialog,public.accessibility.describes-music-and-sound" and AUTOSELECT="YES". Keep the default value, Disabled, if the captions track is not intended to provide such accessibility. MediaConvert will not add the above attributes.
    */
   Accessibility?: WebvttAccessibilitySubs | string;
 
@@ -3975,6 +4127,11 @@ export interface AutomatedAbrSettings {
    * Optional. The minimum target bitrate used in your automated ABR stack. Use this value to set a lower limit on the bitrate of video delivered to viewers with slow internet connections. If you don't specify a value, MediaConvert uses 600,000 (600 kb/s) by default.
    */
   MinAbrBitrate?: number;
+
+  /**
+   * Optional. Use Automated ABR rules to specify restrictions for the rendition sizes MediaConvert will create in your ABR stack. You can use these rules if your ABR workflow has specific rendition size requirements, but you still want MediaConvert to optimize for video quality and overall file size.
+   */
+  Rules?: AutomatedAbrRule[];
 }
 
 export namespace AutomatedAbrSettings {
@@ -5389,7 +5546,7 @@ export interface CmfcSettings {
   IFrameOnlyManifest?: CmfcIFrameOnlyManifest | string;
 
   /**
-   * Applies to CMAF outputs. Use this setting to specify whether the service inserts the KLV metadata from the input in this output.
+   * To include key-length-value metadata in this output: Set KLV metadata insertion to Passthrough. MediaConvert reads KLV metadata present in your input and writes each instance to a separate event message box in the output, according to MISB ST1910.1. To exclude this KLV metadata: Set KLV metadata insertion to None or leave blank.
    */
   KlvMetadata?: CmfcKlvMetadata | string;
 
@@ -5589,56 +5746,3 @@ export enum M2tsKlvMetadata {
   NONE = "NONE",
   PASSTHROUGH = "PASSTHROUGH",
 }
-
-export enum M2tsNielsenId3 {
-  INSERT = "INSERT",
-  NONE = "NONE",
-}
-
-export enum M2tsPcrControl {
-  CONFIGURED_PCR_PERIOD = "CONFIGURED_PCR_PERIOD",
-  PCR_EVERY_PES_PACKET = "PCR_EVERY_PES_PACKET",
-}
-
-export enum M2tsRateMode {
-  CBR = "CBR",
-  VBR = "VBR",
-}
-
-/**
- * Settings for SCTE-35 signals from ESAM. Include this in your job settings to put SCTE-35 markers in your HLS and transport stream outputs at the insertion points that you specify in an ESAM XML document. Provide the document in the setting SCC XML (sccXml).
- */
-export interface M2tsScte35Esam {
-  /**
-   * Packet Identifier (PID) of the SCTE-35 stream in the transport stream generated by ESAM.
-   */
-  Scte35EsamPid?: number;
-}
-
-export namespace M2tsScte35Esam {
-  /**
-   * @internal
-   */
-  export const filterSensitiveLog = (obj: M2tsScte35Esam): any => ({
-    ...obj,
-  });
-}
-
-export enum M2tsScte35Source {
-  NONE = "NONE",
-  PASSTHROUGH = "PASSTHROUGH",
-}
-
-export enum M2tsSegmentationMarkers {
-  EBP = "EBP",
-  EBP_LEGACY = "EBP_LEGACY",
-  NONE = "NONE",
-  PSI_SEGSTART = "PSI_SEGSTART",
-  RAI_ADAPT = "RAI_ADAPT",
-  RAI_SEGSTART = "RAI_SEGSTART",
-}
-
-export enum M2tsSegmentationStyle {
-  MAINTAIN_CADENCE = "MAINTAIN_CADENCE",
-  RESET_CADENCE = "RESET_CADENCE",
-}