@aws-sdk/client-mediaconvert 3.846.0 → 3.849.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -48,7 +48,7 @@ declare const ProbeCommand_base: {
48
48
  * // { // ProbeResult
49
49
  * // Container: { // Container
50
50
  * // Duration: Number("double"),
51
- * // Format: "mp4" || "quicktime" || "matroska" || "webm",
51
+ * // Format: "mp4" || "quicktime" || "matroska" || "webm" || "mxf",
52
52
  * // Tracks: [ // __listOfTrack
53
53
  * // { // Track
54
54
  * // AudioProperties: { // AudioProperties
@@ -62,7 +62,7 @@ declare const ProbeCommand_base: {
62
62
  * // LanguageCode: "STRING_VALUE",
63
63
  * // SampleRate: Number("int"),
64
64
  * // },
65
- * // Codec: "UNKNOWN" || "AAC" || "AC3" || "EAC3" || "FLAC" || "MP3" || "OPUS" || "PCM" || "VORBIS" || "AV1" || "AVC" || "HEVC" || "MJPEG" || "MP4V" || "MPEG2" || "PRORES" || "THEORA" || "VP8" || "VP9" || "C608" || "C708" || "WEBVTT",
65
+ * // Codec: "UNKNOWN" || "AAC" || "AC3" || "EAC3" || "FLAC" || "MP3" || "OPUS" || "PCM" || "VORBIS" || "AV1" || "AVC" || "HEVC" || "JPEG2000" || "MJPEG" || "MP4V" || "MPEG2" || "PRORES" || "THEORA" || "VP8" || "VP9" || "C608" || "C708" || "WEBVTT",
66
66
  * // DataProperties: { // DataProperties
67
67
  * // LanguageCode: "STRING_VALUE",
68
68
  * // },
@@ -295,6 +295,12 @@ declare const SearchJobsCommand_base: {
295
295
  * // SupplementalImps: [ // __listOf__stringPatternS3ASSETMAPXml
296
296
  * // "STRING_VALUE",
297
297
  * // ],
298
+ * // TamsSettings: { // InputTamsSettings
299
+ * // AuthConnectionArn: "STRING_VALUE",
300
+ * // GapHandling: "SKIP_GAPS" || "FILL_WITH_BLACK" || "HOLD_LAST_FRAME",
301
+ * // SourceId: "STRING_VALUE",
302
+ * // Timerange: "STRING_VALUE",
303
+ * // },
298
304
  * // TimecodeSource: "EMBEDDED" || "ZEROBASED" || "SPECIFIEDSTART",
299
305
  * // TimecodeStart: "STRING_VALUE",
300
306
  * // VideoGenerator: { // InputVideoGenerator
@@ -790,12 +796,15 @@ declare const SearchJobsCommand_base: {
790
796
  * // AacSettings: { // AacSettings
791
797
  * // AudioDescriptionBroadcasterMix: "BROADCASTER_MIXED_AD" || "NORMAL",
792
798
  * // Bitrate: Number("int"),
793
- * // CodecProfile: "LC" || "HEV1" || "HEV2",
799
+ * // CodecProfile: "LC" || "HEV1" || "HEV2" || "XHE",
794
800
  * // CodingMode: "AD_RECEIVER_MIX" || "CODING_MODE_1_0" || "CODING_MODE_1_1" || "CODING_MODE_2_0" || "CODING_MODE_5_1",
801
+ * // LoudnessMeasurementMode: "PROGRAM" || "ANCHOR",
802
+ * // RapInterval: Number("int"),
795
803
  * // RateControlMode: "CBR" || "VBR",
796
804
  * // RawFormat: "LATM_LOAS" || "NONE",
797
805
  * // SampleRate: Number("int"),
798
806
  * // Specification: "MPEG2" || "MPEG4",
807
+ * // TargetLoudnessRange: Number("int"),
799
808
  * // VbrQuality: "LOW" || "MEDIUM_LOW" || "MEDIUM_HIGH" || "HIGH",
800
809
  * // },
801
810
  * // Ac3Settings: { // Ac3Settings
@@ -721,12 +721,15 @@ declare const UpdateJobTemplateCommand_base: {
721
721
  * AacSettings: { // AacSettings
722
722
  * AudioDescriptionBroadcasterMix: "BROADCASTER_MIXED_AD" || "NORMAL",
723
723
  * Bitrate: Number("int"),
724
- * CodecProfile: "LC" || "HEV1" || "HEV2",
724
+ * CodecProfile: "LC" || "HEV1" || "HEV2" || "XHE",
725
725
  * CodingMode: "AD_RECEIVER_MIX" || "CODING_MODE_1_0" || "CODING_MODE_1_1" || "CODING_MODE_2_0" || "CODING_MODE_5_1",
726
+ * LoudnessMeasurementMode: "PROGRAM" || "ANCHOR",
727
+ * RapInterval: Number("int"),
726
728
  * RateControlMode: "CBR" || "VBR",
727
729
  * RawFormat: "LATM_LOAS" || "NONE",
728
730
  * SampleRate: Number("int"),
729
731
  * Specification: "MPEG2" || "MPEG4",
732
+ * TargetLoudnessRange: Number("int"),
730
733
  * VbrQuality: "LOW" || "MEDIUM_LOW" || "MEDIUM_HIGH" || "HIGH",
731
734
  * },
732
735
  * Ac3Settings: { // Ac3Settings
@@ -2265,12 +2268,15 @@ declare const UpdateJobTemplateCommand_base: {
2265
2268
  * // AacSettings: { // AacSettings
2266
2269
  * // AudioDescriptionBroadcasterMix: "BROADCASTER_MIXED_AD" || "NORMAL",
2267
2270
  * // Bitrate: Number("int"),
2268
- * // CodecProfile: "LC" || "HEV1" || "HEV2",
2271
+ * // CodecProfile: "LC" || "HEV1" || "HEV2" || "XHE",
2269
2272
  * // CodingMode: "AD_RECEIVER_MIX" || "CODING_MODE_1_0" || "CODING_MODE_1_1" || "CODING_MODE_2_0" || "CODING_MODE_5_1",
2273
+ * // LoudnessMeasurementMode: "PROGRAM" || "ANCHOR",
2274
+ * // RapInterval: Number("int"),
2270
2275
  * // RateControlMode: "CBR" || "VBR",
2271
2276
  * // RawFormat: "LATM_LOAS" || "NONE",
2272
2277
  * // SampleRate: Number("int"),
2273
2278
  * // Specification: "MPEG2" || "MPEG4",
2279
+ * // TargetLoudnessRange: Number("int"),
2274
2280
  * // VbrQuality: "LOW" || "MEDIUM_LOW" || "MEDIUM_HIGH" || "HIGH",
2275
2281
  * // },
2276
2282
  * // Ac3Settings: { // Ac3Settings
@@ -63,12 +63,15 @@ declare const UpdatePresetCommand_base: {
63
63
  * AacSettings: { // AacSettings
64
64
  * AudioDescriptionBroadcasterMix: "BROADCASTER_MIXED_AD" || "NORMAL",
65
65
  * Bitrate: Number("int"),
66
- * CodecProfile: "LC" || "HEV1" || "HEV2",
66
+ * CodecProfile: "LC" || "HEV1" || "HEV2" || "XHE",
67
67
  * CodingMode: "AD_RECEIVER_MIX" || "CODING_MODE_1_0" || "CODING_MODE_1_1" || "CODING_MODE_2_0" || "CODING_MODE_5_1",
68
+ * LoudnessMeasurementMode: "PROGRAM" || "ANCHOR",
69
+ * RapInterval: Number("int"),
68
70
  * RateControlMode: "CBR" || "VBR",
69
71
  * RawFormat: "LATM_LOAS" || "NONE",
70
72
  * SampleRate: Number("int"),
71
73
  * Specification: "MPEG2" || "MPEG4",
74
+ * TargetLoudnessRange: Number("int"),
72
75
  * VbrQuality: "LOW" || "MEDIUM_LOW" || "MEDIUM_HIGH" || "HIGH",
73
76
  * },
74
77
  * Ac3Settings: { // Ac3Settings
@@ -917,12 +920,15 @@ declare const UpdatePresetCommand_base: {
917
920
  * // AacSettings: { // AacSettings
918
921
  * // AudioDescriptionBroadcasterMix: "BROADCASTER_MIXED_AD" || "NORMAL",
919
922
  * // Bitrate: Number("int"),
920
- * // CodecProfile: "LC" || "HEV1" || "HEV2",
923
+ * // CodecProfile: "LC" || "HEV1" || "HEV2" || "XHE",
921
924
  * // CodingMode: "AD_RECEIVER_MIX" || "CODING_MODE_1_0" || "CODING_MODE_1_1" || "CODING_MODE_2_0" || "CODING_MODE_5_1",
925
+ * // LoudnessMeasurementMode: "PROGRAM" || "ANCHOR",
926
+ * // RapInterval: Number("int"),
922
927
  * // RateControlMode: "CBR" || "VBR",
923
928
  * // RawFormat: "LATM_LOAS" || "NONE",
924
929
  * // SampleRate: Number("int"),
925
930
  * // Specification: "MPEG2" || "MPEG4",
931
+ * // TargetLoudnessRange: Number("int"),
926
932
  * // VbrQuality: "LOW" || "MEDIUM_LOW" || "MEDIUM_HIGH" || "HIGH",
927
933
  * // },
928
934
  * // Ac3Settings: { // Ac3Settings
@@ -208,6 +208,7 @@ export declare const AacCodecProfile: {
208
208
  readonly HEV1: "HEV1";
209
209
  readonly HEV2: "HEV2";
210
210
  readonly LC: "LC";
211
+ readonly XHE: "XHE";
211
212
  };
212
213
  /**
213
214
  * @public
@@ -228,6 +229,18 @@ export declare const AacCodingMode: {
228
229
  * @public
229
230
  */
230
231
  export type AacCodingMode = (typeof AacCodingMode)[keyof typeof AacCodingMode];
232
+ /**
233
+ * @public
234
+ * @enum
235
+ */
236
+ export declare const AacLoudnessMeasurementMode: {
237
+ readonly ANCHOR: "ANCHOR";
238
+ readonly PROGRAM: "PROGRAM";
239
+ };
240
+ /**
241
+ * @public
242
+ */
243
+ export type AacLoudnessMeasurementMode = (typeof AacLoudnessMeasurementMode)[keyof typeof AacLoudnessMeasurementMode];
231
244
  /**
232
245
  * @public
233
246
  * @enum
@@ -303,6 +316,16 @@ export interface AacSettings {
303
316
  * @public
304
317
  */
305
318
  CodingMode?: AacCodingMode | undefined;
319
+ /**
320
+ * Choose the loudness measurement mode for your audio content. For music or advertisements: We recommend that you keep the default value, Program. For speech or other content: We recommend that you choose Anchor. When you do, MediaConvert optimizes the loudness of your output for clarify by applying speech gates.
321
+ * @public
322
+ */
323
+ LoudnessMeasurementMode?: AacLoudnessMeasurementMode | undefined;
324
+ /**
325
+ * Specify the RAP (Random Access Point) interval for your xHE-AAC audio output. A RAP allows a decoder to decode audio data mid-stream, without the need to reference previous audio frames, and perform adaptive audio bitrate switching. To specify the RAP interval: Enter an integer from 2000 to 30000, in milliseconds. Smaller values allow for better seeking and more frequent stream switching, while large values improve compression efficiency. To have MediaConvert automatically determine the RAP interval: Leave blank.
326
+ * @public
327
+ */
328
+ RapInterval?: number | undefined;
306
329
  /**
307
330
  * Specify the AAC rate control mode. For a constant bitrate: Choose CBR. Your AAC output bitrate will be equal to the value that you choose for Bitrate. For a variable bitrate: Choose VBR. Your AAC output bitrate will vary according to your audio content and the value that you choose for Bitrate quality.
308
331
  * @public
@@ -323,6 +346,11 @@ export interface AacSettings {
323
346
  * @public
324
347
  */
325
348
  Specification?: AacSpecification | undefined;
349
+ /**
350
+ * Specify the xHE-AAC loudness target. Enter an integer from 6 to 16, representing "loudness units". For more information, see the following specification: Supplementary information for R 128 EBU Tech 3342-2023.
351
+ * @public
352
+ */
353
+ TargetLoudnessRange?: number | undefined;
326
354
  /**
327
355
  * Specify the quality of your variable bitrate (VBR) AAC audio. For a list of approximate VBR bitrates, see: https://docs.aws.amazon.com/mediaconvert/latest/ug/aac-support.html#aac_vbr
328
356
  * @public
@@ -3673,6 +3701,45 @@ export declare const InputPsiControl: {
3673
3701
  * @public
3674
3702
  */
3675
3703
  export type InputPsiControl = (typeof InputPsiControl)[keyof typeof InputPsiControl];
3704
+ /**
3705
+ * @public
3706
+ * @enum
3707
+ */
3708
+ export declare const TamsGapHandling: {
3709
+ readonly FILL_WITH_BLACK: "FILL_WITH_BLACK";
3710
+ readonly HOLD_LAST_FRAME: "HOLD_LAST_FRAME";
3711
+ readonly SKIP_GAPS: "SKIP_GAPS";
3712
+ };
3713
+ /**
3714
+ * @public
3715
+ */
3716
+ export type TamsGapHandling = (typeof TamsGapHandling)[keyof typeof TamsGapHandling];
3717
+ /**
3718
+ * Specify a Time Addressable Media Store (TAMS) server as an input source. TAMS is an open-source API specification that provides access to time-segmented media content. Use TAMS to retrieve specific time ranges from live or archived media streams. When you specify TAMS settings, MediaConvert connects to your TAMS server, retrieves the media segments for your specified time range, and processes them as a single input. This enables workflows like extracting clips from live streams or processing specific portions of archived content. To use TAMS, you must: 1. Have access to a TAMS-compliant server 2. Specify the server URL in the Input file URL field 3. Provide the required SourceId and Timerange parameters 4. Configure authentication, if your TAMS server requires it
3719
+ * @public
3720
+ */
3721
+ export interface InputTamsSettings {
3722
+ /**
3723
+ * Specify the ARN (Amazon Resource Name) of an EventBridge Connection to authenticate with your TAMS server. The EventBridge Connection stores your authentication credentials securely. MediaConvert assumes your job's IAM role to access this connection, so ensure the role has the events:RetrieveConnectionCredentials, secretsmanager:DescribeSecret, and secretsmanager:GetSecretValue permissions. Format: arn:aws:events:region:account-id:connection/connection-name/unique-id
3724
+ * @public
3725
+ */
3726
+ AuthConnectionArn?: string | undefined;
3727
+ /**
3728
+ * Specify how MediaConvert handles gaps between media segments in your TAMS source. Gaps can occur in live streams due to network issues or other interruptions. Choose from the following options: * Skip gaps - Default. Skip over gaps and join segments together. This creates a continuous output with no blank frames, but may cause timeline discontinuities. * Fill with black - Insert black frames to fill gaps between segments. This maintains timeline continuity but adds black frames where content is missing. * Hold last frame - Repeat the last frame before a gap until the next segment begins. This maintains visual continuity during gaps.
3729
+ * @public
3730
+ */
3731
+ GapHandling?: TamsGapHandling | undefined;
3732
+ /**
3733
+ * Specify the unique identifier for the media source in your TAMS server. MediaConvert uses this source ID to locate the appropriate flows containing the media segments you want to process. The source ID corresponds to a specific media source registered in your TAMS server. This source must be of type urn:x-nmos:format:multi, and can can reference multiple flows for audio, video, or combined audio/video content. MediaConvert automatically selects the highest quality flows available for your job. This setting is required when include TAMS settings in your job.
3734
+ * @public
3735
+ */
3736
+ SourceId?: string | undefined;
3737
+ /**
3738
+ * Specify the time range of media segments to retrieve from your TAMS server. MediaConvert fetches only the segments that fall within this range. Use the format specified by your TAMS server implementation. This must be two timestamp values with the format \{sign?\}\{seconds\}:\{nanoseconds\}, separated by an underscore, surrounded by either parentheses or square brackets. Example: [15:0_35:0) This setting is required when include TAMS settings in your job.
3739
+ * @public
3740
+ */
3741
+ Timerange?: string | undefined;
3742
+ }
3676
3743
  /**
3677
3744
  * @public
3678
3745
  * @enum
@@ -3737,7 +3804,7 @@ export type VideoOverlayUnit = (typeof VideoOverlayUnit)[keyof typeof VideoOverl
3737
3804
  */
3738
3805
  export interface VideoOverlayCrop {
3739
3806
  /**
3740
- * Specify the height of the video overlay cropping rectangle. To use the same height as your overlay input video: Keep blank, or enter 0. To specify a different height for the cropping rectangle: Enter an integer representing the Unit type that you choose, either Pixels or Percentage. For example, when you enter 100 and choose Pixels, the cropping rectangle will 100 pixels high. When you enter 10, choose Percentage, and your overlay input video is 1920x1080, the cropping rectangle will be 108 pixels high.
3807
+ * Specify the height of the video overlay cropping rectangle. To use the same height as your overlay input video: Keep blank, or enter 0. To specify a different height for the cropping rectangle: Enter an integer representing the Unit type that you choose, either Pixels or Percentage. For example, when you enter 100 and choose Pixels, the cropping rectangle will be 100 pixels high. When you enter 10, choose Percentage, and your overlay input video is 1920x1080, the cropping rectangle will be 108 pixels high.
3741
3808
  * @public
3742
3809
  */
3743
3810
  Height?: number | undefined;
@@ -3747,7 +3814,7 @@ export interface VideoOverlayCrop {
3747
3814
  */
3748
3815
  Unit?: VideoOverlayUnit | undefined;
3749
3816
  /**
3750
- * Specify the width of the video overlay cropping rectangle. To use the same width as your overlay input video: Keep blank, or enter 0. To specify a different width for the cropping rectangle: Enter an integer representing the Unit type that you choose, either Pixels or Percentage. For example, when you enter 100 and choose Pixels, the cropping rectangle will 100 pixels wide. When you enter 10, choose Percentage, and your overlay input video is 1920x1080, the cropping rectangle will be 192 pixels wide.
3817
+ * Specify the width of the video overlay cropping rectangle. To use the same width as your overlay input video: Keep blank, or enter 0. To specify a different width for the cropping rectangle: Enter an integer representing the Unit type that you choose, either Pixels or Percentage. For example, when you enter 100 and choose Pixels, the cropping rectangle will be 100 pixels wide. When you enter 10, choose Percentage, and your overlay input video is 1920x1080, the cropping rectangle will be 192 pixels wide.
3751
3818
  * @public
3752
3819
  */
3753
3820
  Width?: number | undefined;
@@ -4179,7 +4246,7 @@ export interface Input {
4179
4246
  */
4180
4247
  DynamicAudioSelectors?: Record<string, DynamicAudioSelector> | undefined;
4181
4248
  /**
4182
- * Specify the source file for your transcoding job. You can use multiple inputs in a single job. The service concatenates these inputs, in the order that you specify them in the job, to create the outputs. If your input format is IMF, specify your input by providing the path to your CPL. For example, "s3://bucket/vf/cpl.xml". If the CPL is in an incomplete IMP, make sure to use *Supplemental IMPs* to specify any supplemental IMPs that contain assets referenced by the CPL.
4249
+ * Specify the source file for your transcoding job. You can use multiple inputs in a single job. The service concatenates these inputs, in the order that you specify them in the job, to create the outputs. For standard inputs, provide the path to your S3, HTTP, or HTTPS source file. For example, s3://amzn-s3-demo-bucket/input.mp4 for an Amazon S3 input or https://example.com/input.mp4 for an HTTPS input. For TAMS inputs, specify the HTTPS endpoint of your TAMS server. For example, https://tams-server.example.com . When you do, also specify Source ID, Timerange, GAP handling, and the Authorization connection ARN under TAMS settings. (Don't include these parameters in the Input file URL.) For IMF inputs, specify your input by providing the path to your CPL. For example, s3://amzn-s3-demo-bucket/vf/cpl.xml . If the CPL is in an incomplete IMP, make sure to use Supplemental IMPsto specify any supplemental IMPs that contain assets referenced by the CPL.
4183
4250
  * @public
4184
4251
  */
4185
4252
  FileInput?: string | undefined;
@@ -4230,6 +4297,11 @@ export interface Input {
4230
4297
  * @public
4231
4298
  */
4232
4299
  SupplementalImps?: string[] | undefined;
4300
+ /**
4301
+ * Specify a Time Addressable Media Store (TAMS) server as an input source. TAMS is an open-source API specification that provides access to time-segmented media content. Use TAMS to retrieve specific time ranges from live or archived media streams. When you specify TAMS settings, MediaConvert connects to your TAMS server, retrieves the media segments for your specified time range, and processes them as a single input. This enables workflows like extracting clips from live streams or processing specific portions of archived content. To use TAMS, you must: 1. Have access to a TAMS-compliant server 2. Specify the server URL in the Input file URL field 3. Provide the required SourceId and Timerange parameters 4. Configure authentication, if your TAMS server requires it
4302
+ * @public
4303
+ */
4304
+ TamsSettings?: InputTamsSettings | undefined;
4233
4305
  /**
4234
4306
  * Use this Timecode source setting, located under the input settings, to specify how the service counts input video frames. This input frame count affects only the behavior of features that apply to a single input at a time, such as input clipping and synchronizing some captions formats. Choose Embedded to use the timecodes in your input video. Choose Start at zero to start the first frame at zero. Choose Specified start to start the first frame at the timecode that you specify in the setting Start timecode. If you don't specify a value for Timecode source, the service will use Embedded by default. For more information about timecodes, see https://docs.aws.amazon.com/console/mediaconvert/timecode.
4235
4307
  * @public
@@ -6321,198 +6393,3 @@ export declare const HlsTargetDurationCompatibilityMode: {
6321
6393
  * @public
6322
6394
  */
6323
6395
  export type HlsTargetDurationCompatibilityMode = (typeof HlsTargetDurationCompatibilityMode)[keyof typeof HlsTargetDurationCompatibilityMode];
6324
- /**
6325
- * @public
6326
- * @enum
6327
- */
6328
- export declare const HlsTimedMetadataId3Frame: {
6329
- readonly NONE: "NONE";
6330
- readonly PRIV: "PRIV";
6331
- readonly TDRL: "TDRL";
6332
- };
6333
- /**
6334
- * @public
6335
- */
6336
- export type HlsTimedMetadataId3Frame = (typeof HlsTimedMetadataId3Frame)[keyof typeof HlsTimedMetadataId3Frame];
6337
- /**
6338
- * Settings related to your HLS output package. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/outputs-file-ABR.html.
6339
- * @public
6340
- */
6341
- export interface HlsGroupSettings {
6342
- /**
6343
- * Choose one or more ad marker types to decorate your Apple HLS manifest. This setting does not determine whether SCTE-35 markers appear in the outputs themselves.
6344
- * @public
6345
- */
6346
- AdMarkers?: HlsAdMarkers[] | undefined;
6347
- /**
6348
- * By default, the service creates one top-level .m3u8 HLS manifest for each HLS output group in your job. This default manifest references every output in the output group. To create additional top-level manifests that reference a subset of the outputs in the output group, specify a list of them here.
6349
- * @public
6350
- */
6351
- AdditionalManifests?: HlsAdditionalManifest[] | undefined;
6352
- /**
6353
- * Ignore this setting unless you are using FairPlay DRM with Verimatrix and you encounter playback issues. Keep the default value, Include, to output audio-only headers. Choose Exclude to remove the audio-only headers from your audio segments.
6354
- * @public
6355
- */
6356
- AudioOnlyHeader?: HlsAudioOnlyHeader | undefined;
6357
- /**
6358
- * A partial URI prefix that will be prepended to each output in the media .m3u8 file. Can be used if base manifest is delivered from a different URL than the main .m3u8 file.
6359
- * @public
6360
- */
6361
- BaseUrl?: string | undefined;
6362
- /**
6363
- * Language to be used on Caption outputs
6364
- * @public
6365
- */
6366
- CaptionLanguageMappings?: HlsCaptionLanguageMapping[] | undefined;
6367
- /**
6368
- * Applies only to 608 Embedded output captions. Insert: Include CLOSED-CAPTIONS lines in the manifest. Specify at least one language in the CC1 Language Code field. One CLOSED-CAPTION line is added for each Language Code you specify. Make sure to specify the languages in the order in which they appear in the original source (if the source is embedded format) or the order of the caption selectors (if the source is other than embedded). Otherwise, languages in the manifest will not match up properly with the output captions. None: Include CLOSED-CAPTIONS=NONE line in the manifest. Omit: Omit any CLOSED-CAPTIONS line from the manifest.
6369
- * @public
6370
- */
6371
- CaptionLanguageSetting?: HlsCaptionLanguageSetting | undefined;
6372
- /**
6373
- * Set Caption segment length control to Match video to create caption segments that align with the video segments from the first video output in this output group. For example, if the video segments are 2 seconds long, your WebVTT segments will also be 2 seconds long. Keep the default setting, Large segments to create caption segments that are 300 seconds long.
6374
- * @public
6375
- */
6376
- CaptionSegmentLengthControl?: HlsCaptionSegmentLengthControl | undefined;
6377
- /**
6378
- * Disable this setting only when your workflow requires the #EXT-X-ALLOW-CACHE:no tag. Otherwise, keep the default value Enabled and control caching in your video distribution set up. For example, use the Cache-Control http header.
6379
- * @public
6380
- */
6381
- ClientCache?: HlsClientCache | undefined;
6382
- /**
6383
- * Specification to use (RFC-6381 or the default RFC-4281) during m3u8 playlist generation.
6384
- * @public
6385
- */
6386
- CodecSpecification?: HlsCodecSpecification | undefined;
6387
- /**
6388
- * Use Destination to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.
6389
- * @public
6390
- */
6391
- Destination?: string | undefined;
6392
- /**
6393
- * Settings associated with the destination. Will vary based on the type of destination
6394
- * @public
6395
- */
6396
- DestinationSettings?: DestinationSettings | undefined;
6397
- /**
6398
- * Indicates whether segments should be placed in subdirectories.
6399
- * @public
6400
- */
6401
- DirectoryStructure?: HlsDirectoryStructure | undefined;
6402
- /**
6403
- * DRM settings.
6404
- * @public
6405
- */
6406
- Encryption?: HlsEncryptionSettings | undefined;
6407
- /**
6408
- * Specify whether MediaConvert generates images for trick play. Keep the default value, None, to not generate any images. Choose Thumbnail to generate tiled thumbnails. Choose Thumbnail and full frame to generate tiled thumbnails and full-resolution images of single frames. MediaConvert creates a child manifest for each set of images that you generate and adds corresponding entries to the parent manifest. A common application for these images is Roku trick mode. The thumbnails and full-frame images that MediaConvert creates with this feature are compatible with this Roku specification: https://developer.roku.com/docs/developer-program/media-playback/trick-mode/hls-and-dash.md
6409
- * @public
6410
- */
6411
- ImageBasedTrickPlay?: HlsImageBasedTrickPlay | undefined;
6412
- /**
6413
- * Tile and thumbnail settings applicable when imageBasedTrickPlay is ADVANCED
6414
- * @public
6415
- */
6416
- ImageBasedTrickPlaySettings?: HlsImageBasedTrickPlaySettings | undefined;
6417
- /**
6418
- * When set to GZIP, compresses HLS playlist.
6419
- * @public
6420
- */
6421
- ManifestCompression?: HlsManifestCompression | undefined;
6422
- /**
6423
- * Indicates whether the output manifest should use floating point values for segment duration.
6424
- * @public
6425
- */
6426
- ManifestDurationFormat?: HlsManifestDurationFormat | undefined;
6427
- /**
6428
- * Keep this setting at the default value of 0, unless you are troubleshooting a problem with how devices play back the end of your video asset. If you know that player devices are hanging on the final segment of your video because the length of your final segment is too short, use this setting to specify a minimum final segment length, in seconds. Choose a value that is greater than or equal to 1 and less than your segment length. When you specify a value for this setting, the encoder will combine any final segment that is shorter than the length that you specify with the previous segment. For example, your segment length is 3 seconds and your final segment is .5 seconds without a minimum final segment length; when you set the minimum final segment length to 1, your final segment is 3.5 seconds.
6429
- * @public
6430
- */
6431
- MinFinalSegmentLength?: number | undefined;
6432
- /**
6433
- * When set, Minimum Segment Size is enforced by looking ahead and back within the specified range for a nearby avail and extending the segment size if needed.
6434
- * @public
6435
- */
6436
- MinSegmentLength?: number | undefined;
6437
- /**
6438
- * Indicates whether the .m3u8 manifest file should be generated for this HLS output group.
6439
- * @public
6440
- */
6441
- OutputSelection?: HlsOutputSelection | undefined;
6442
- /**
6443
- * Includes or excludes EXT-X-PROGRAM-DATE-TIME tag in .m3u8 manifest files. The value is calculated as follows: either the program date and time are initialized using the input timecode source, or the time is initialized using the input timecode source and the date is initialized using the timestamp_offset.
6444
- * @public
6445
- */
6446
- ProgramDateTime?: HlsProgramDateTime | undefined;
6447
- /**
6448
- * Period of insertion of EXT-X-PROGRAM-DATE-TIME entry, in seconds.
6449
- * @public
6450
- */
6451
- ProgramDateTimePeriod?: number | undefined;
6452
- /**
6453
- * Specify whether MediaConvert generates HLS manifests while your job is running or when your job is complete. To generate HLS manifests while your job is running: Choose Enabled. Use if you want to play back your content as soon as it's available. MediaConvert writes the parent and child manifests after the first three media segments are written to your destination S3 bucket. It then writes new updated manifests after each additional segment is written. The parent manifest includes the latest BANDWIDTH and AVERAGE-BANDWIDTH attributes, and child manifests include the latest available media segment. When your job completes, the final child playlists include an EXT-X-ENDLIST tag. To generate HLS manifests only when your job completes: Choose Disabled.
6454
- * @public
6455
- */
6456
- ProgressiveWriteHlsManifest?: HlsProgressiveWriteHlsManifest | undefined;
6457
- /**
6458
- * When set to SINGLE_FILE, emits program as a single media resource (.ts) file, uses #EXT-X-BYTERANGE tags to index segment for playback.
6459
- * @public
6460
- */
6461
- SegmentControl?: HlsSegmentControl | undefined;
6462
- /**
6463
- * Specify the length, in whole seconds, of each segment. When you don't specify a value, MediaConvert defaults to 10. Related settings: Use Segment length control to specify whether the encoder enforces this value strictly. Use Segment control to specify whether MediaConvert creates separate segment files or one content file that has metadata to mark the segment boundaries.
6464
- * @public
6465
- */
6466
- SegmentLength?: number | undefined;
6467
- /**
6468
- * Specify how you want MediaConvert to determine segment lengths in this output group. To use the exact value that you specify under Segment length: Choose Exact. Note that this might result in additional I-frames in the output GOP. To create segment lengths that are a multiple of the GOP: Choose Multiple of GOP. MediaConvert will round up the segment lengths to match the next GOP boundary. To have MediaConvert automatically determine a segment duration that is a multiple of both the audio packets and the frame rates: Choose Match. When you do, also specify a target segment duration under Segment length. This is useful for some ad-insertion or segment replacement workflows. Note that Match has the following requirements: - Output containers: Include at least one video output and at least one audio output. Audio-only outputs are not supported. - Output frame rate: Follow source is not supported. - Multiple output frame rates: When you specify multiple outputs, we recommend they share a similar frame rate (as in X/3, X/2, X, or 2X). For example: 5, 15, 30 and 60. Or: 25 and 50. (Outputs must share an integer multiple.) - Output audio codec: Specify Advanced Audio Coding (AAC). - Output sample rate: Choose 48kHz.
6469
- * @public
6470
- */
6471
- SegmentLengthControl?: HlsSegmentLengthControl | undefined;
6472
- /**
6473
- * Specify the number of segments to write to a subdirectory before starting a new one. You must also set Directory structure to Subdirectory per stream for this setting to have an effect.
6474
- * @public
6475
- */
6476
- SegmentsPerSubdirectory?: number | undefined;
6477
- /**
6478
- * Include or exclude RESOLUTION attribute for video in EXT-X-STREAM-INF tag of variant manifest.
6479
- * @public
6480
- */
6481
- StreamInfResolution?: HlsStreamInfResolution | undefined;
6482
- /**
6483
- * When set to LEGACY, the segment target duration is always rounded up to the nearest integer value above its current value in seconds. When set to SPEC\\_COMPLIANT, the segment target duration is rounded up to the nearest integer value if fraction seconds are greater than or equal to 0.5 (>= 0.5) and rounded down if less than 0.5 (< 0.5). You may need to use LEGACY if your client needs to ensure that the target duration is always longer than the actual duration of the segment. Some older players may experience interrupted playback when the actual duration of a track in a segment is longer than the target duration.
6484
- * @public
6485
- */
6486
- TargetDurationCompatibilityMode?: HlsTargetDurationCompatibilityMode | undefined;
6487
- /**
6488
- * Specify the type of the ID3 frame to use for ID3 timestamps in your output. To include ID3 timestamps: Specify PRIV or TDRL and set ID3 metadata to Passthrough. To exclude ID3 timestamps: Set ID3 timestamp frame type to None.
6489
- * @public
6490
- */
6491
- TimedMetadataId3Frame?: HlsTimedMetadataId3Frame | undefined;
6492
- /**
6493
- * Specify the interval in seconds to write ID3 timestamps in your output. The first timestamp starts at the output timecode and date, and increases incrementally with each ID3 timestamp. To use the default interval of 10 seconds: Leave blank. To include this metadata in your output: Set ID3 timestamp frame type to PRIV or TDRL, and set ID3 metadata to Passthrough.
6494
- * @public
6495
- */
6496
- TimedMetadataId3Period?: number | undefined;
6497
- /**
6498
- * Provides an extra millisecond delta offset to fine tune the timestamps.
6499
- * @public
6500
- */
6501
- TimestampDeltaMilliseconds?: number | undefined;
6502
- }
6503
- /**
6504
- * Specify the details for each additional Microsoft Smooth Streaming manifest that you want the service to generate for this output group. Each manifest can reference a different subset of outputs in the group.
6505
- * @public
6506
- */
6507
- export interface MsSmoothAdditionalManifest {
6508
- /**
6509
- * Specify a name modifier that the service adds to the name of this manifest to make it different from the file names of the other main manifests in the output group. For example, say that the default main manifest for your Microsoft Smooth group is film-name.ismv. If you enter "-no-premium" for this setting, then the file name the service generates for this top-level manifest is film-name-no-premium.ismv.
6510
- * @public
6511
- */
6512
- ManifestNameModifier?: string | undefined;
6513
- /**
6514
- * Specify the outputs that you want this additional top-level manifest to reference.
6515
- * @public
6516
- */
6517
- SelectedOutputs?: string[] | undefined;
6518
- }