feat(client-mediaconvert): This release includes support for dynamic …

…video overlay workflows, including picture-in-picture and squeezeback
aws · Sep 12, 2024 · d4befea · d4befea
1 parent 7501e91
commit d4befea
Show file tree

Hide file tree

Showing 25 changed files with 1,418 additions and 270 deletions.
diff --git a/clients/client-mediaconvert/README.md b/clients/client-mediaconvert/README.md
@@ -378,6 +378,14 @@ ListTagsForResource
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/mediaconvert/command/ListTagsForResourceCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Interface/ListTagsForResourceCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Interface/ListTagsForResourceCommandOutput/)
 
+</details>
+<details>
+<summary>
+ListVersions
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/mediaconvert/command/ListVersionsCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Interface/ListVersionsCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Interface/ListVersionsCommandOutput/)
+
 </details>
 <details>
 <summary>

diff --git a/clients/client-mediaconvert/src/MediaConvert.ts b/clients/client-mediaconvert/src/MediaConvert.ts
@@ -68,6 +68,11 @@ import {
   ListTagsForResourceCommandInput,
   ListTagsForResourceCommandOutput,
 } from "./commands/ListTagsForResourceCommand";
+import {
+  ListVersionsCommand,
+  ListVersionsCommandInput,
+  ListVersionsCommandOutput,
+} from "./commands/ListVersionsCommand";
 import { PutPolicyCommand, PutPolicyCommandInput, PutPolicyCommandOutput } from "./commands/PutPolicyCommand";
 import { SearchJobsCommand, SearchJobsCommandInput, SearchJobsCommandOutput } from "./commands/SearchJobsCommand";
 import { TagResourceCommand, TagResourceCommandInput, TagResourceCommandOutput } from "./commands/TagResourceCommand";
@@ -112,6 +117,7 @@ const commands = {
   ListPresetsCommand,
   ListQueuesCommand,
   ListTagsForResourceCommand,
+  ListVersionsCommand,
   PutPolicyCommand,
   SearchJobsCommand,
   TagResourceCommand,
@@ -416,6 +422,18 @@ export interface MediaConvert {
     cb: (err: any, data?: ListTagsForResourceCommandOutput) => void
   ): void;
 
+  /**
+   * @see {@link ListVersionsCommand}
+   */
+  listVersions(): Promise<ListVersionsCommandOutput>;
+  listVersions(args: ListVersionsCommandInput, options?: __HttpHandlerOptions): Promise<ListVersionsCommandOutput>;
+  listVersions(args: ListVersionsCommandInput, cb: (err: any, data?: ListVersionsCommandOutput) => void): void;
+  listVersions(
+    args: ListVersionsCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: ListVersionsCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link PutPolicyCommand}
    */

diff --git a/clients/client-mediaconvert/src/MediaConvertClient.ts b/clients/client-mediaconvert/src/MediaConvertClient.ts
@@ -84,6 +84,7 @@ import {
   ListTagsForResourceCommandInput,
   ListTagsForResourceCommandOutput,
 } from "./commands/ListTagsForResourceCommand";
+import { ListVersionsCommandInput, ListVersionsCommandOutput } from "./commands/ListVersionsCommand";
 import { PutPolicyCommandInput, PutPolicyCommandOutput } from "./commands/PutPolicyCommand";
 import { SearchJobsCommandInput, SearchJobsCommandOutput } from "./commands/SearchJobsCommand";
 import { TagResourceCommandInput, TagResourceCommandOutput } from "./commands/TagResourceCommand";
@@ -128,6 +129,7 @@ export type ServiceInputTypes =
   | ListPresetsCommandInput
   | ListQueuesCommandInput
   | ListTagsForResourceCommandInput
+  | ListVersionsCommandInput
   | PutPolicyCommandInput
   | SearchJobsCommandInput
   | TagResourceCommandInput
@@ -162,6 +164,7 @@ export type ServiceOutputTypes =
   | ListPresetsCommandOutput
   | ListQueuesCommandOutput
   | ListTagsForResourceCommandOutput
+  | ListVersionsCommandOutput
   | PutPolicyCommandOutput
   | SearchJobsCommandOutput
   | TagResourceCommandOutput

diff --git a/clients/client-mediaconvert/src/commands/AssociateCertificateCommand.ts b/clients/client-mediaconvert/src/commands/AssociateCertificateCommand.ts
@@ -6,7 +6,7 @@ import { MetadataBearer as __MetadataBearer } from "@smithy/types";
 
 import { commonParams } from "../endpoint/EndpointParameters";
 import { MediaConvertClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../MediaConvertClient";
-import { AssociateCertificateRequest, AssociateCertificateResponse } from "../models/models_1";
+import { AssociateCertificateRequest, AssociateCertificateResponse } from "../models/models_2";
 import { de_AssociateCertificateCommand, se_AssociateCertificateCommand } from "../protocols/Aws_restJson1";
 
 /**

diff --git a/clients/client-mediaconvert/src/commands/CreateJobCommand.ts b/clients/client-mediaconvert/src/commands/CreateJobCommand.ts
@@ -48,6 +48,7 @@ export interface CreateJobCommandOutput extends CreateJobResponse, __MetadataBea
  *       WaitMinutes: Number("int"),
  *     },
  *   ],
+ *   JobEngineVersion: "STRING_VALUE",
  *   JobTemplate: "STRING_VALUE",
  *   Priority: Number("int"),
  *   Queue: "STRING_VALUE",
@@ -96,7 +97,7 @@ export interface CreateJobCommandOutput extends CreateJobResponse, __MetadataBea
  *         },
  *         AudioSelectors: { // __mapOfAudioSelector
  *           "<keys>": { // AudioSelector
- *             AudioDurationCorrection: "DISABLED" || "AUTO" || "TRACK" || "FRAME",
+ *             AudioDurationCorrection: "DISABLED" || "AUTO" || "TRACK" || "FRAME" || "FORCE",
  *             CustomLanguageCode: "STRING_VALUE",
  *             DefaultSelection: "DEFAULT" || "NOT_DEFAULT",
  *             ExternalAudioFileInput: "STRING_VALUE",
@@ -155,6 +156,7 @@ export interface CreateJobCommandOutput extends CreateJobResponse, __MetadataBea
  *                 TerminateCaptions: "END_OF_INPUT" || "DISABLED",
  *               },
  *               FileSourceSettings: { // FileSourceSettings
+ *                 ByteRateLimit: "ENABLED" || "DISABLED",
  *                 Convert608To708: "UPCONVERT" || "DISABLED",
  *                 ConvertPaintToPop: "ENABLED" || "DISABLED",
  *                 Framerate: { // CaptionSourceFramerate
@@ -246,6 +248,13 @@ export interface CreateJobCommandOutput extends CreateJobResponse, __MetadataBea
  *         VideoOverlays: [ // __listOfVideoOverlay
  *           { // VideoOverlay
  *             EndTimecode: "STRING_VALUE",
+ *             InitialPosition: { // VideoOverlayPosition
+ *               Height: Number("int"),
+ *               Unit: "PIXELS" || "PERCENTAGE",
+ *               Width: Number("int"),
+ *               XPosition: Number("int"),
+ *               YPosition: Number("int"),
+ *             },
  *             Input: { // VideoOverlayInput
  *               FileInput: "STRING_VALUE",
  *               InputClippings: [ // __listOfVideoOverlayInputClipping
@@ -257,7 +266,21 @@ export interface CreateJobCommandOutput extends CreateJobResponse, __MetadataBea
  *               TimecodeSource: "EMBEDDED" || "ZEROBASED" || "SPECIFIEDSTART",
  *               TimecodeStart: "STRING_VALUE",
  *             },
+ *             Playback: "ONCE" || "REPEAT",
  *             StartTimecode: "STRING_VALUE",
+ *             Transitions: [ // __listOfVideoOverlayTransition
+ *               { // VideoOverlayTransition
+ *                 EndPosition: {
+ *                   Height: Number("int"),
+ *                   Unit: "PIXELS" || "PERCENTAGE",
+ *                   Width: Number("int"),
+ *                   XPosition: Number("int"),
+ *                   YPosition: Number("int"),
+ *                 },
+ *                 EndTimecode: "STRING_VALUE",
+ *                 StartTimecode: "STRING_VALUE",
+ *               },
+ *             ],
  *           },
  *         ],
  *         VideoSelector: { // VideoSelector
@@ -922,7 +945,7 @@ export interface CreateJobCommandOutput extends CreateJobResponse, __MetadataBea
  *                 TimedMetadataSchemeIdUri: "STRING_VALUE",
  *                 TimedMetadataValue: "STRING_VALUE",
  *               },
- *               Container: "F4V" || "ISMV" || "M2TS" || "M3U8" || "CMFC" || "MOV" || "MP4" || "MPD" || "MXF" || "WEBM" || "RAW" || "Y4M",
+ *               Container: "F4V" || "ISMV" || "M2TS" || "M3U8" || "CMFC" || "MOV" || "MP4" || "MPD" || "MXF" || "OGG" || "WEBM" || "RAW" || "Y4M",
  *               F4vSettings: { // F4vSettings
  *                 MoovPlacement: "PROGRESSIVE_DOWNLOAD" || "NORMAL",
  *               },
@@ -1148,6 +1171,7 @@ export interface CreateJobCommandOutput extends CreateJobResponse, __MetadataBea
  *                   },
  *                   RateControlMode: "VBR" || "CBR" || "QVBR",
  *                   RepeatPps: "DISABLED" || "ENABLED",
+ *                   SaliencyAwareEncoding: "DISABLED" || "PREFERRED",
  *                   ScanTypeConversionMode: "INTERLACED" || "INTERLACED_OPTIMIZE",
  *                   SceneChangeDetect: "DISABLED" || "ENABLED" || "TRANSITION_DETECTION",
  *                   Slices: Number("int"),
@@ -1530,6 +1554,8 @@ export interface CreateJobCommandOutput extends CreateJobResponse, __MetadataBea
  * //       },
  * //     ],
  * //     Id: "STRING_VALUE",
+ * //     JobEngineVersionRequested: "STRING_VALUE",
+ * //     JobEngineVersionUsed: "STRING_VALUE",
  * //     JobPercentComplete: Number("int"),
  * //     JobTemplate: "STRING_VALUE",
  * //     Messages: { // JobMessages
@@ -1608,7 +1634,7 @@ export interface CreateJobCommandOutput extends CreateJobResponse, __MetadataBea
  * //           },
  * //           AudioSelectors: { // __mapOfAudioSelector
  * //             "<keys>": { // AudioSelector
- * //               AudioDurationCorrection: "DISABLED" || "AUTO" || "TRACK" || "FRAME",
+ * //               AudioDurationCorrection: "DISABLED" || "AUTO" || "TRACK" || "FRAME" || "FORCE",
  * //               CustomLanguageCode: "STRING_VALUE",
  * //               DefaultSelection: "DEFAULT" || "NOT_DEFAULT",
  * //               ExternalAudioFileInput: "STRING_VALUE",
@@ -1667,6 +1693,7 @@ export interface CreateJobCommandOutput extends CreateJobResponse, __MetadataBea
  * //                   TerminateCaptions: "END_OF_INPUT" || "DISABLED",
  * //                 },
  * //                 FileSourceSettings: { // FileSourceSettings
+ * //                   ByteRateLimit: "ENABLED" || "DISABLED",
  * //                   Convert608To708: "UPCONVERT" || "DISABLED",
  * //                   ConvertPaintToPop: "ENABLED" || "DISABLED",
  * //                   Framerate: { // CaptionSourceFramerate
@@ -1758,6 +1785,13 @@ export interface CreateJobCommandOutput extends CreateJobResponse, __MetadataBea
  * //           VideoOverlays: [ // __listOfVideoOverlay
  * //             { // VideoOverlay
  * //               EndTimecode: "STRING_VALUE",
+ * //               InitialPosition: { // VideoOverlayPosition
+ * //                 Height: Number("int"),
+ * //                 Unit: "PIXELS" || "PERCENTAGE",
+ * //                 Width: Number("int"),
+ * //                 XPosition: Number("int"),
+ * //                 YPosition: Number("int"),
+ * //               },
  * //               Input: { // VideoOverlayInput
  * //                 FileInput: "STRING_VALUE",
  * //                 InputClippings: [ // __listOfVideoOverlayInputClipping
@@ -1769,7 +1803,21 @@ export interface CreateJobCommandOutput extends CreateJobResponse, __MetadataBea
  * //                 TimecodeSource: "EMBEDDED" || "ZEROBASED" || "SPECIFIEDSTART",
  * //                 TimecodeStart: "STRING_VALUE",
  * //               },
+ * //               Playback: "ONCE" || "REPEAT",
  * //               StartTimecode: "STRING_VALUE",
+ * //               Transitions: [ // __listOfVideoOverlayTransition
+ * //                 { // VideoOverlayTransition
+ * //                   EndPosition: {
+ * //                     Height: Number("int"),
+ * //                     Unit: "PIXELS" || "PERCENTAGE",
+ * //                     Width: Number("int"),
+ * //                     XPosition: Number("int"),
+ * //                     YPosition: Number("int"),
+ * //                   },
+ * //                   EndTimecode: "STRING_VALUE",
+ * //                   StartTimecode: "STRING_VALUE",
+ * //                 },
+ * //               ],
  * //             },
  * //           ],
  * //           VideoSelector: { // VideoSelector
@@ -2434,7 +2482,7 @@ export interface CreateJobCommandOutput extends CreateJobResponse, __MetadataBea
  * //                   TimedMetadataSchemeIdUri: "STRING_VALUE",
  * //                   TimedMetadataValue: "STRING_VALUE",
  * //                 },
- * //                 Container: "F4V" || "ISMV" || "M2TS" || "M3U8" || "CMFC" || "MOV" || "MP4" || "MPD" || "MXF" || "WEBM" || "RAW" || "Y4M",
+ * //                 Container: "F4V" || "ISMV" || "M2TS" || "M3U8" || "CMFC" || "MOV" || "MP4" || "MPD" || "MXF" || "OGG" || "WEBM" || "RAW" || "Y4M",
  * //                 F4vSettings: { // F4vSettings
  * //                   MoovPlacement: "PROGRESSIVE_DOWNLOAD" || "NORMAL",
  * //                 },
@@ -2660,6 +2708,7 @@ export interface CreateJobCommandOutput extends CreateJobResponse, __MetadataBea
  * //                     },
  * //                     RateControlMode: "VBR" || "CBR" || "QVBR",
  * //                     RepeatPps: "DISABLED" || "ENABLED",
+ * //                     SaliencyAwareEncoding: "DISABLED" || "PREFERRED",
  * //                     ScanTypeConversionMode: "INTERLACED" || "INTERLACED_OPTIMIZE",
  * //                     SceneChangeDetect: "DISABLED" || "ENABLED" || "TRANSITION_DETECTION",
  * //                     Slices: Number("int"),