feat(client-mediaconvert): This release adds support for TAMS server integration with MediaConvert inputs.

Author: awstools

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

@@ -246,6 +246,12 @@ export interface CreateJobCommandOutput extends CreateJobResponse, __MetadataBea
  *         SupplementalImps: [ // __listOf__stringPatternS3ASSETMAPXml
  *           "STRING_VALUE",
  *         ],
+ *         TamsSettings: { // InputTamsSettings
+ *           AuthConnectionArn: "STRING_VALUE",
+ *           GapHandling: "SKIP_GAPS" || "FILL_WITH_BLACK" || "HOLD_LAST_FRAME",
+ *           SourceId: "STRING_VALUE",
+ *           Timerange: "STRING_VALUE",
+ *         },
  *         TimecodeSource: "EMBEDDED" || "ZEROBASED" || "SPECIFIEDSTART",
  *         TimecodeStart: "STRING_VALUE",
  *         VideoGenerator: { // InputVideoGenerator
@@ -1854,6 +1860,12 @@ export interface CreateJobCommandOutput extends CreateJobResponse, __MetadataBea
  * //           SupplementalImps: [ // __listOf__stringPatternS3ASSETMAPXml
  * //             "STRING_VALUE",
  * //           ],
+ * //           TamsSettings: { // InputTamsSettings
+ * //             AuthConnectionArn: "STRING_VALUE",
+ * //             GapHandling: "SKIP_GAPS" || "FILL_WITH_BLACK" || "HOLD_LAST_FRAME",
+ * //             SourceId: "STRING_VALUE",
+ * //             Timerange: "STRING_VALUE",
+ * //           },
  * //           TimecodeSource: "EMBEDDED" || "ZEROBASED" || "SPECIFIEDSTART",
  * //           TimecodeStart: "STRING_VALUE",
  * //           VideoGenerator: { // InputVideoGenerator

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

@@ -290,6 +290,12 @@ export interface GetJobCommandOutput extends GetJobResponse, __MetadataBearer {}
  * //           SupplementalImps: [ // __listOf__stringPatternS3ASSETMAPXml
  * //             "STRING_VALUE",
  * //           ],
+ * //           TamsSettings: { // InputTamsSettings
+ * //             AuthConnectionArn: "STRING_VALUE",
+ * //             GapHandling: "SKIP_GAPS" || "FILL_WITH_BLACK" || "HOLD_LAST_FRAME",
+ * //             SourceId: "STRING_VALUE",
+ * //             Timerange: "STRING_VALUE",
+ * //           },
  * //           TimecodeSource: "EMBEDDED" || "ZEROBASED" || "SPECIFIEDSTART",
  * //           TimecodeStart: "STRING_VALUE",
  * //           VideoGenerator: { // InputVideoGenerator

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

@@ -295,6 +295,12 @@ export interface ListJobsCommandOutput extends ListJobsResponse, __MetadataBeare
  * //             SupplementalImps: [ // __listOf__stringPatternS3ASSETMAPXml
  * //               "STRING_VALUE",
  * //             ],
+ * //             TamsSettings: { // InputTamsSettings
+ * //               AuthConnectionArn: "STRING_VALUE",
+ * //               GapHandling: "SKIP_GAPS" || "FILL_WITH_BLACK" || "HOLD_LAST_FRAME",
+ * //               SourceId: "STRING_VALUE",
+ * //               Timerange: "STRING_VALUE",
+ * //             },
  * //             TimecodeSource: "EMBEDDED" || "ZEROBASED" || "SPECIFIEDSTART",
  * //             TimecodeStart: "STRING_VALUE",
  * //             VideoGenerator: { // InputVideoGenerator

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

@@ -296,6 +296,12 @@ export interface SearchJobsCommandOutput extends SearchJobsResponse, __MetadataB
  * //             SupplementalImps: [ // __listOf__stringPatternS3ASSETMAPXml
  * //               "STRING_VALUE",
  * //             ],
+ * //             TamsSettings: { // InputTamsSettings
+ * //               AuthConnectionArn: "STRING_VALUE",
+ * //               GapHandling: "SKIP_GAPS" || "FILL_WITH_BLACK" || "HOLD_LAST_FRAME",
+ * //               SourceId: "STRING_VALUE",
+ * //               Timerange: "STRING_VALUE",
+ * //             },
  * //             TimecodeSource: "EMBEDDED" || "ZEROBASED" || "SPECIFIEDSTART",
  * //             TimecodeStart: "STRING_VALUE",
  * //             VideoGenerator: { // InputVideoGenerator

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

@@ -15,6 +15,7 @@ import {
   EsamSettings,
   ExtendedDataServices,
   HopDestination,
+  Input,
   InputTemplate,
   JobMessages,
   JobPhase,
@@ -26,15 +27,111 @@ import {
   QueueTransition,
 } from "./models_0";
 
-import {
-  ContainerSettings,
-  JobSettings,
-  OutputGroup,
-  SimulateReservedQueue,
-  TimecodeConfig,
-  TimedMetadataInsertion,
-  VideoDescription,
-} from "./models_1";
+import { ContainerSettings, OutputGroup, TimecodeConfig, TimedMetadataInsertion, VideoDescription } from "./models_1";
+
+/**
+ * JobSettings contains all the transcode settings for a job.
+ * @public
+ */
+export interface JobSettings {
+  /**
+   * When specified, this offset (in milliseconds) is added to the input Ad Avail PTS time.
+   * @public
+   */
+  AdAvailOffset?: number | undefined;
+
+  /**
+   * Settings for ad avail blanking. Video can be blanked or overlaid with an image, and audio muted during SCTE-35 triggered ad avails.
+   * @public
+   */
+  AvailBlanking?: AvailBlanking | undefined;
+
+  /**
+   * Use 3D LUTs to specify custom color mapping behavior when you convert from one color space into another. You can include up to 8 different 3D LUTs. For more information, see: https://docs.aws.amazon.com/mediaconvert/latest/ug/3d-luts.html
+   * @public
+   */
+  ColorConversion3DLUTSettings?: ColorConversion3DLUTSetting[] | undefined;
+
+  /**
+   * Settings for Event Signaling And Messaging (ESAM). If you don't do ad insertion, you can ignore these settings.
+   * @public
+   */
+  Esam?: EsamSettings | undefined;
+
+  /**
+   * If your source content has EIA-608 Line 21 Data Services, enable this feature to specify what MediaConvert does with the Extended Data Services (XDS) packets. You can choose to pass through XDS packets, or remove them from the output. For more information about XDS, see EIA-608 Line Data Services, section 9.5.1.5 05h Content Advisory.
+   * @public
+   */
+  ExtendedDataServices?: ExtendedDataServices | undefined;
+
+  /**
+   * Specify the input that MediaConvert references for your default output settings.  MediaConvert uses this input's Resolution, Frame rate, and Pixel aspect ratio for all  outputs that you don't manually specify different output settings for. Enabling this setting will disable "Follow source" for all other inputs.  If MediaConvert cannot follow your source, for example if you specify an audio-only input,  MediaConvert uses the first followable input instead. In your JSON job specification, enter an integer from 1 to 150 corresponding  to the order of your inputs.
+   * @public
+   */
+  FollowSource?: number | undefined;
+
+  /**
+   * Use Inputs to define source file used in the transcode job. There can be multiple inputs add in a job. These inputs will be concantenated together to create the output.
+   * @public
+   */
+  Inputs?: Input[] | undefined;
+
+  /**
+   * Use these settings only when you use Kantar watermarking. Specify the values that MediaConvert uses to generate and place Kantar watermarks in your output audio. These settings apply to every output in your job. In addition to specifying these values, you also need to store your Kantar credentials in AWS Secrets Manager. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/kantar-watermarking.html.
+   * @public
+   */
+  KantarWatermark?: KantarWatermarkSettings | undefined;
+
+  /**
+   * Overlay motion graphics on top of your video. The motion graphics that you specify here appear on all outputs in all output groups. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/motion-graphic-overlay.html.
+   * @public
+   */
+  MotionImageInserter?: MotionImageInserter | undefined;
+
+  /**
+   * Settings for your Nielsen configuration. If you don't do Nielsen measurement and analytics, ignore these settings. When you enable Nielsen configuration, MediaConvert enables PCM to ID3 tagging for all outputs in the job.
+   * @public
+   */
+  NielsenConfiguration?: NielsenConfiguration | undefined;
+
+  /**
+   * Ignore these settings unless you are using Nielsen non-linear watermarking. Specify the values that MediaConvert uses to generate and place Nielsen watermarks in your output audio. In addition to specifying these values, you also need to set up your cloud TIC server. These settings apply to every output in your job. The MediaConvert implementation is currently with the following Nielsen versions: Nielsen Watermark SDK Version 6.0.13 Nielsen NLM Watermark Engine Version 1.3.3 Nielsen Watermark Authenticator [SID_TIC] Version [7.0.0]
+   * @public
+   */
+  NielsenNonLinearWatermark?: NielsenNonLinearWatermarkSettings | undefined;
+
+  /**
+   * Contains one group of settings for each set of outputs that share a common package type. All unpackaged files (MPEG-4, MPEG-2 TS, Quicktime, MXF, and no container) are grouped in a single output group as well. Required in is a group of settings that apply to the whole group. This required object depends on the value you set for Type. Type, settings object pairs are as follows. * FILE_GROUP_SETTINGS, FileGroupSettings * HLS_GROUP_SETTINGS, HlsGroupSettings * DASH_ISO_GROUP_SETTINGS, DashIsoGroupSettings * MS_SMOOTH_GROUP_SETTINGS, MsSmoothGroupSettings * CMAF_GROUP_SETTINGS, CmafGroupSettings
+   * @public
+   */
+  OutputGroups?: OutputGroup[] | undefined;
+
+  /**
+   * These settings control how the service handles timecodes throughout the job. These settings don't affect input clipping.
+   * @public
+   */
+  TimecodeConfig?: TimecodeConfig | undefined;
+
+  /**
+   * Insert user-defined custom ID3 metadata at timecodes that you specify. In each output that you want to include this metadata, you must set ID3 metadata to Passthrough.
+   * @public
+   */
+  TimedMetadataInsertion?: TimedMetadataInsertion | undefined;
+}
+
+/**
+ * @public
+ * @enum
+ */
+export const SimulateReservedQueue = {
+  DISABLED: "DISABLED",
+  ENABLED: "ENABLED",
+} as const;
+
+/**
+ * @public
+ */
+export type SimulateReservedQueue = (typeof SimulateReservedQueue)[keyof typeof SimulateReservedQueue];
 
 /**
  * @public

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

@@ -129,7 +129,6 @@ import {
   HlsAdMarkers,
   HlsCaptionLanguageMapping,
   HlsEncryptionSettings,
-  HlsGroupSettings,
   HlsImageBasedTrickPlaySettings,
   HlsRenditionGroupSettings,
   HopDestination,
@@ -139,6 +138,7 @@ import {
   Input,
   InputClipping,
   InputDecryptionSettings,
+  InputTamsSettings,
   InputTemplate,
   InputVideoGenerator,
   InsertableImage,
@@ -210,8 +210,8 @@ import {
   H265QvbrSettings,
   H265Settings,
   Hdr10Plus,
+  HlsGroupSettings,
   HlsSettings,
-  JobSettings,
   M2tsScte35Esam,
   M2tsSettings,
   M3u8Settings,
@@ -263,6 +263,7 @@ import {
   InternalServerErrorException,
   Job,
   JobEngineVersion,
+  JobSettings,
   JobTemplate,
   JobTemplateSettings,
   Metadata,
@@ -3418,6 +3419,7 @@ const se_Input = (input: Input, context: __SerdeContext): any => {
     programNumber: [, , `ProgramNumber`],
     psiControl: [, , `PsiControl`],
     supplementalImps: [, _json, `SupplementalImps`],
+    tamsSettings: [, (_) => se_InputTamsSettings(_, context), `TamsSettings`],
     timecodeSource: [, , `TimecodeSource`],
     timecodeStart: [, , `TimecodeStart`],
     videoGenerator: [, (_) => se_InputVideoGenerator(_, context), `VideoGenerator`],
@@ -3448,6 +3450,18 @@ const se_InputDecryptionSettings = (input: InputDecryptionSettings, context: __S
   });
 };
 
+/**
+ * serializeAws_restJson1InputTamsSettings
+ */
+const se_InputTamsSettings = (input: InputTamsSettings, context: __SerdeContext): any => {
+  return take(input, {
+    authConnectionArn: [, , `AuthConnectionArn`],
+    gapHandling: [, , `GapHandling`],
+    sourceId: [, , `SourceId`],
+    timerange: [, , `Timerange`],
+  });
+};
+
 /**
  * serializeAws_restJson1InputTemplate
  */
@@ -6682,6 +6696,7 @@ const de_Input = (output: any, context: __SerdeContext): Input => {
     ProgramNumber: [, __expectInt32, `programNumber`],
     PsiControl: [, __expectString, `psiControl`],
     SupplementalImps: [, _json, `supplementalImps`],
+    TamsSettings: [, (_: any) => de_InputTamsSettings(_, context), `tamsSettings`],
     TimecodeSource: [, __expectString, `timecodeSource`],
     TimecodeStart: [, __expectString, `timecodeStart`],
     VideoGenerator: [, (_: any) => de_InputVideoGenerator(_, context), `videoGenerator`],
@@ -6712,6 +6727,18 @@ const de_InputDecryptionSettings = (output: any, context: __SerdeContext): Input
   }) as any;
 };
 
+/**
+ * deserializeAws_restJson1InputTamsSettings
+ */
+const de_InputTamsSettings = (output: any, context: __SerdeContext): InputTamsSettings => {
+  return take(output, {
+    AuthConnectionArn: [, __expectString, `authConnectionArn`],
+    GapHandling: [, __expectString, `gapHandling`],
+    SourceId: [, __expectString, `sourceId`],
+    Timerange: [, __expectString, `timerange`],
+  }) as any;
+};
+
 /**
  * deserializeAws_restJson1InputTemplate
  */