Skip to content

Commit 7567d64

Browse files
author
awstools
committedDec 16, 2024
feat(client-medialive): AWS Elemental MediaLive adds three new features: MediaPackage v2 endpoint support for live stream delivery, KLV metadata passthrough in CMAF Ingest output groups, and Metadata Name Modifier in CMAF Ingest output groups for customizing metadata track names in output streams.
·
v3.789.0v3.713.0
1 parent 0a3b2ac commit 7567d64

14 files changed

+231
-34
lines changed
 

‎clients/client-medialive/src/commands/CreateChannelCommand.ts

+12
Original file line numberDiff line numberDiff line change
@@ -46,6 +46,8 @@ export interface CreateChannelCommandOutput extends CreateChannelResponse, __Met
4646
* MediaPackageSettings: [ // __listOfMediaPackageOutputDestinationSettings
4747
* { // MediaPackageOutputDestinationSettings
4848
* ChannelId: "STRING_VALUE",
49+
* ChannelGroup: "STRING_VALUE",
50+
* ChannelName: "STRING_VALUE",
4951
* },
5052
* ],
5153
* MultiplexSettings: { // MultiplexProgramChannelDestinationSettings
@@ -518,6 +520,10 @@ export interface CreateChannelCommandOutput extends CreateChannelResponse, __Met
518520
* SegmentLength: Number("int"),
519521
* SegmentLengthUnits: "MILLISECONDS" || "SECONDS",
520522
* SendDelayMs: Number("int"),
523+
* KlvBehavior: "NO_PASSTHROUGH" || "PASSTHROUGH",
524+
* KlvNameModifier: "STRING_VALUE",
525+
* NielsenId3NameModifier: "STRING_VALUE",
526+
* Scte35NameModifier: "STRING_VALUE",
521527
* },
522528
* SrtGroupSettings: { // SrtGroupSettings
523529
* InputLossAction: "DROP_PROGRAM" || "DROP_TS" || "EMIT_PROGRAM",
@@ -1230,6 +1236,8 @@ export interface CreateChannelCommandOutput extends CreateChannelResponse, __Met
12301236
* // MediaPackageSettings: [ // __listOfMediaPackageOutputDestinationSettings
12311237
* // { // MediaPackageOutputDestinationSettings
12321238
* // ChannelId: "STRING_VALUE",
1239+
* // ChannelGroup: "STRING_VALUE",
1240+
* // ChannelName: "STRING_VALUE",
12331241
* // },
12341242
* // ],
12351243
* // MultiplexSettings: { // MultiplexProgramChannelDestinationSettings
@@ -1707,6 +1715,10 @@ export interface CreateChannelCommandOutput extends CreateChannelResponse, __Met
17071715
* // SegmentLength: Number("int"),
17081716
* // SegmentLengthUnits: "MILLISECONDS" || "SECONDS",
17091717
* // SendDelayMs: Number("int"),
1718+
* // KlvBehavior: "NO_PASSTHROUGH" || "PASSTHROUGH",
1719+
* // KlvNameModifier: "STRING_VALUE",
1720+
* // NielsenId3NameModifier: "STRING_VALUE",
1721+
* // Scte35NameModifier: "STRING_VALUE",
17101722
* // },
17111723
* // SrtGroupSettings: { // SrtGroupSettings
17121724
* // InputLossAction: "DROP_PROGRAM" || "DROP_TS" || "EMIT_PROGRAM",

‎clients/client-medialive/src/commands/DeleteChannelCommand.ts

+6
Original file line numberDiff line numberDiff line change
@@ -52,6 +52,8 @@ export interface DeleteChannelCommandOutput extends DeleteChannelResponse, __Met
5252
* // MediaPackageSettings: [ // __listOfMediaPackageOutputDestinationSettings
5353
* // { // MediaPackageOutputDestinationSettings
5454
* // ChannelId: "STRING_VALUE",
55+
* // ChannelGroup: "STRING_VALUE",
56+
* // ChannelName: "STRING_VALUE",
5557
* // },
5658
* // ],
5759
* // MultiplexSettings: { // MultiplexProgramChannelDestinationSettings
@@ -529,6 +531,10 @@ export interface DeleteChannelCommandOutput extends DeleteChannelResponse, __Met
529531
* // SegmentLength: Number("int"),
530532
* // SegmentLengthUnits: "MILLISECONDS" || "SECONDS",
531533
* // SendDelayMs: Number("int"),
534+
* // KlvBehavior: "NO_PASSTHROUGH" || "PASSTHROUGH",
535+
* // KlvNameModifier: "STRING_VALUE",
536+
* // NielsenId3NameModifier: "STRING_VALUE",
537+
* // Scte35NameModifier: "STRING_VALUE",
532538
* // },
533539
* // SrtGroupSettings: { // SrtGroupSettings
534540
* // InputLossAction: "DROP_PROGRAM" || "DROP_TS" || "EMIT_PROGRAM",

‎clients/client-medialive/src/commands/DescribeChannelCommand.ts

+6
Original file line numberDiff line numberDiff line change
@@ -52,6 +52,8 @@ export interface DescribeChannelCommandOutput extends DescribeChannelResponse, _
5252
* // MediaPackageSettings: [ // __listOfMediaPackageOutputDestinationSettings
5353
* // { // MediaPackageOutputDestinationSettings
5454
* // ChannelId: "STRING_VALUE",
55+
* // ChannelGroup: "STRING_VALUE",
56+
* // ChannelName: "STRING_VALUE",
5557
* // },
5658
* // ],
5759
* // MultiplexSettings: { // MultiplexProgramChannelDestinationSettings
@@ -529,6 +531,10 @@ export interface DescribeChannelCommandOutput extends DescribeChannelResponse, _
529531
* // SegmentLength: Number("int"),
530532
* // SegmentLengthUnits: "MILLISECONDS" || "SECONDS",
531533
* // SendDelayMs: Number("int"),
534+
* // KlvBehavior: "NO_PASSTHROUGH" || "PASSTHROUGH",
535+
* // KlvNameModifier: "STRING_VALUE",
536+
* // NielsenId3NameModifier: "STRING_VALUE",
537+
* // Scte35NameModifier: "STRING_VALUE",
532538
* // },
533539
* // SrtGroupSettings: { // SrtGroupSettings
534540
* // InputLossAction: "DROP_PROGRAM" || "DROP_TS" || "EMIT_PROGRAM",

‎clients/client-medialive/src/commands/ListChannelsCommand.ts

+2
Original file line numberDiff line numberDiff line change
@@ -55,6 +55,8 @@ export interface ListChannelsCommandOutput extends ListChannelsResponse, __Metad
5555
* // MediaPackageSettings: [ // __listOfMediaPackageOutputDestinationSettings
5656
* // { // MediaPackageOutputDestinationSettings
5757
* // ChannelId: "STRING_VALUE",
58+
* // ChannelGroup: "STRING_VALUE",
59+
* // ChannelName: "STRING_VALUE",
5860
* // },
5961
* // ],
6062
* // MultiplexSettings: { // MultiplexProgramChannelDestinationSettings

‎clients/client-medialive/src/commands/RestartChannelPipelinesCommand.ts

+6
Original file line numberDiff line numberDiff line change
@@ -55,6 +55,8 @@ export interface RestartChannelPipelinesCommandOutput extends RestartChannelPipe
5555
* // MediaPackageSettings: [ // __listOfMediaPackageOutputDestinationSettings
5656
* // { // MediaPackageOutputDestinationSettings
5757
* // ChannelId: "STRING_VALUE",
58+
* // ChannelGroup: "STRING_VALUE",
59+
* // ChannelName: "STRING_VALUE",
5860
* // },
5961
* // ],
6062
* // MultiplexSettings: { // MultiplexProgramChannelDestinationSettings
@@ -532,6 +534,10 @@ export interface RestartChannelPipelinesCommandOutput extends RestartChannelPipe
532534
* // SegmentLength: Number("int"),
533535
* // SegmentLengthUnits: "MILLISECONDS" || "SECONDS",
534536
* // SendDelayMs: Number("int"),
537+
* // KlvBehavior: "NO_PASSTHROUGH" || "PASSTHROUGH",
538+
* // KlvNameModifier: "STRING_VALUE",
539+
* // NielsenId3NameModifier: "STRING_VALUE",
540+
* // Scte35NameModifier: "STRING_VALUE",
535541
* // },
536542
* // SrtGroupSettings: { // SrtGroupSettings
537543
* // InputLossAction: "DROP_PROGRAM" || "DROP_TS" || "EMIT_PROGRAM",

‎clients/client-medialive/src/commands/StartChannelCommand.ts

+6
Original file line numberDiff line numberDiff line change
@@ -52,6 +52,8 @@ export interface StartChannelCommandOutput extends StartChannelResponse, __Metad
5252
* // MediaPackageSettings: [ // __listOfMediaPackageOutputDestinationSettings
5353
* // { // MediaPackageOutputDestinationSettings
5454
* // ChannelId: "STRING_VALUE",
55+
* // ChannelGroup: "STRING_VALUE",
56+
* // ChannelName: "STRING_VALUE",
5557
* // },
5658
* // ],
5759
* // MultiplexSettings: { // MultiplexProgramChannelDestinationSettings
@@ -529,6 +531,10 @@ export interface StartChannelCommandOutput extends StartChannelResponse, __Metad
529531
* // SegmentLength: Number("int"),
530532
* // SegmentLengthUnits: "MILLISECONDS" || "SECONDS",
531533
* // SendDelayMs: Number("int"),
534+
* // KlvBehavior: "NO_PASSTHROUGH" || "PASSTHROUGH",
535+
* // KlvNameModifier: "STRING_VALUE",
536+
* // NielsenId3NameModifier: "STRING_VALUE",
537+
* // Scte35NameModifier: "STRING_VALUE",
532538
* // },
533539
* // SrtGroupSettings: { // SrtGroupSettings
534540
* // InputLossAction: "DROP_PROGRAM" || "DROP_TS" || "EMIT_PROGRAM",

‎clients/client-medialive/src/commands/StopChannelCommand.ts

+6
Original file line numberDiff line numberDiff line change
@@ -52,6 +52,8 @@ export interface StopChannelCommandOutput extends StopChannelResponse, __Metadat
5252
* // MediaPackageSettings: [ // __listOfMediaPackageOutputDestinationSettings
5353
* // { // MediaPackageOutputDestinationSettings
5454
* // ChannelId: "STRING_VALUE",
55+
* // ChannelGroup: "STRING_VALUE",
56+
* // ChannelName: "STRING_VALUE",
5557
* // },
5658
* // ],
5759
* // MultiplexSettings: { // MultiplexProgramChannelDestinationSettings
@@ -529,6 +531,10 @@ export interface StopChannelCommandOutput extends StopChannelResponse, __Metadat
529531
* // SegmentLength: Number("int"),
530532
* // SegmentLengthUnits: "MILLISECONDS" || "SECONDS",
531533
* // SendDelayMs: Number("int"),
534+
* // KlvBehavior: "NO_PASSTHROUGH" || "PASSTHROUGH",
535+
* // KlvNameModifier: "STRING_VALUE",
536+
* // NielsenId3NameModifier: "STRING_VALUE",
537+
* // Scte35NameModifier: "STRING_VALUE",
532538
* // },
533539
* // SrtGroupSettings: { // SrtGroupSettings
534540
* // InputLossAction: "DROP_PROGRAM" || "DROP_TS" || "EMIT_PROGRAM",

‎clients/client-medialive/src/commands/UpdateChannelClassCommand.ts

+8
Original file line numberDiff line numberDiff line change
@@ -44,6 +44,8 @@ export interface UpdateChannelClassCommandOutput extends UpdateChannelClassRespo
4444
* MediaPackageSettings: [ // __listOfMediaPackageOutputDestinationSettings
4545
* { // MediaPackageOutputDestinationSettings
4646
* ChannelId: "STRING_VALUE",
47+
* ChannelGroup: "STRING_VALUE",
48+
* ChannelName: "STRING_VALUE",
4749
* },
4850
* ],
4951
* MultiplexSettings: { // MultiplexProgramChannelDestinationSettings
@@ -83,6 +85,8 @@ export interface UpdateChannelClassCommandOutput extends UpdateChannelClassRespo
8385
* // MediaPackageSettings: [ // __listOfMediaPackageOutputDestinationSettings
8486
* // { // MediaPackageOutputDestinationSettings
8587
* // ChannelId: "STRING_VALUE",
88+
* // ChannelGroup: "STRING_VALUE",
89+
* // ChannelName: "STRING_VALUE",
8690
* // },
8791
* // ],
8892
* // MultiplexSettings: { // MultiplexProgramChannelDestinationSettings
@@ -560,6 +564,10 @@ export interface UpdateChannelClassCommandOutput extends UpdateChannelClassRespo
560564
* // SegmentLength: Number("int"),
561565
* // SegmentLengthUnits: "MILLISECONDS" || "SECONDS",
562566
* // SendDelayMs: Number("int"),
567+
* // KlvBehavior: "NO_PASSTHROUGH" || "PASSTHROUGH",
568+
* // KlvNameModifier: "STRING_VALUE",
569+
* // NielsenId3NameModifier: "STRING_VALUE",
570+
* // Scte35NameModifier: "STRING_VALUE",
563571
* // },
564572
* // SrtGroupSettings: { // SrtGroupSettings
565573
* // InputLossAction: "DROP_PROGRAM" || "DROP_TS" || "EMIT_PROGRAM",

‎clients/client-medialive/src/commands/UpdateChannelCommand.ts

+12
Original file line numberDiff line numberDiff line change
@@ -46,6 +46,8 @@ export interface UpdateChannelCommandOutput extends UpdateChannelResponse, __Met
4646
* MediaPackageSettings: [ // __listOfMediaPackageOutputDestinationSettings
4747
* { // MediaPackageOutputDestinationSettings
4848
* ChannelId: "STRING_VALUE",
49+
* ChannelGroup: "STRING_VALUE",
50+
* ChannelName: "STRING_VALUE",
4951
* },
5052
* ],
5153
* MultiplexSettings: { // MultiplexProgramChannelDestinationSettings
@@ -518,6 +520,10 @@ export interface UpdateChannelCommandOutput extends UpdateChannelResponse, __Met
518520
* SegmentLength: Number("int"),
519521
* SegmentLengthUnits: "MILLISECONDS" || "SECONDS",
520522
* SendDelayMs: Number("int"),
523+
* KlvBehavior: "NO_PASSTHROUGH" || "PASSTHROUGH",
524+
* KlvNameModifier: "STRING_VALUE",
525+
* NielsenId3NameModifier: "STRING_VALUE",
526+
* Scte35NameModifier: "STRING_VALUE",
521527
* },
522528
* SrtGroupSettings: { // SrtGroupSettings
523529
* InputLossAction: "DROP_PROGRAM" || "DROP_TS" || "EMIT_PROGRAM",
@@ -1217,6 +1223,8 @@ export interface UpdateChannelCommandOutput extends UpdateChannelResponse, __Met
12171223
* // MediaPackageSettings: [ // __listOfMediaPackageOutputDestinationSettings
12181224
* // { // MediaPackageOutputDestinationSettings
12191225
* // ChannelId: "STRING_VALUE",
1226+
* // ChannelGroup: "STRING_VALUE",
1227+
* // ChannelName: "STRING_VALUE",
12201228
* // },
12211229
* // ],
12221230
* // MultiplexSettings: { // MultiplexProgramChannelDestinationSettings
@@ -1694,6 +1702,10 @@ export interface UpdateChannelCommandOutput extends UpdateChannelResponse, __Met
16941702
* // SegmentLength: Number("int"),
16951703
* // SegmentLengthUnits: "MILLISECONDS" || "SECONDS",
16961704
* // SendDelayMs: Number("int"),
1705+
* // KlvBehavior: "NO_PASSTHROUGH" || "PASSTHROUGH",
1706+
* // KlvNameModifier: "STRING_VALUE",
1707+
* // NielsenId3NameModifier: "STRING_VALUE",
1708+
* // Scte35NameModifier: "STRING_VALUE",
16971709
* // },
16981710
* // SrtGroupSettings: { // SrtGroupSettings
16991711
* // InputLossAction: "DROP_PROGRAM" || "DROP_TS" || "EMIT_PROGRAM",

‎clients/client-medialive/src/models/models_0.ts

+12
Original file line numberDiff line numberDiff line change
@@ -2752,6 +2752,18 @@ export interface MediaPackageOutputDestinationSettings {
27522752
* @public
27532753
*/
27542754
ChannelId?: string | undefined;
2755+
2756+
/**
2757+
* Name of the channel group in MediaPackageV2. Only use if you are sending CMAF Ingest output to a CMAF ingest endpoint on a MediaPackage channel that uses MediaPackage v2.
2758+
* @public
2759+
*/
2760+
ChannelGroup?: string | undefined;
2761+
2762+
/**
2763+
* Name of the channel in MediaPackageV2. Only use if you are sending CMAF Ingest output to a CMAF ingest endpoint on a MediaPackage channel that uses MediaPackage v2.
2764+
* @public
2765+
*/
2766+
ChannelName?: string | undefined;
27552767
}
27562768

27572769
/**

‎clients/client-medialive/src/models/models_1.ts

+47-24
Original file line numberDiff line numberDiff line change
@@ -177,7 +177,7 @@ export interface Fmp4HlsSettings {
177177
NielsenId3Behavior?: Fmp4NielsenId3Behavior | undefined;
178178

179179
/**
180-
* When set to passthrough, timed metadata is passed through from input to output.
180+
* Set to PASSTHROUGH to enable ID3 metadata insertion. To include metadata, you configure other parameters in the output group or individual outputs, or you add an ID3 action to the channel schedule.
181181
* @public
182182
*/
183183
TimedMetadataBehavior?: Fmp4TimedMetadataBehavior | undefined;
@@ -343,7 +343,7 @@ export interface M3u8Settings {
343343
Scte35Pid?: string | undefined;
344344

345345
/**
346-
* When set to passthrough, timed metadata is passed through from input to output.
346+
* Set to PASSTHROUGH to enable ID3 metadata insertion. To include metadata, you configure other parameters in the output group or individual outputs, or you add an ID3 action to the channel schedule.
347347
* @public
348348
*/
349349
TimedMetadataBehavior?: M3u8TimedMetadataBehavior | undefined;
@@ -970,6 +970,20 @@ export interface ArchiveGroupSettings {
970970
RolloverInterval?: number | undefined;
971971
}
972972

973+
/**
974+
* @public
975+
* @enum
976+
*/
977+
export const CmafKLVBehavior = {
978+
NO_PASSTHROUGH: "NO_PASSTHROUGH",
979+
PASSTHROUGH: "PASSTHROUGH",
980+
} as const;
981+
982+
/**
983+
* @public
984+
*/
985+
export type CmafKLVBehavior = (typeof CmafKLVBehavior)[keyof typeof CmafKLVBehavior];
986+
973987
/**
974988
* @public
975989
* @enum
@@ -1053,6 +1067,30 @@ export interface CmafIngestGroupSettings {
10531067
* @public
10541068
*/
10551069
SendDelayMs?: number | undefined;
1070+
1071+
/**
1072+
* If set to passthrough, passes any KLV data from the input source to this output.
1073+
* @public
1074+
*/
1075+
KlvBehavior?: CmafKLVBehavior | undefined;
1076+
1077+
/**
1078+
* Change the modifier that MediaLive automatically adds to the Streams() name that identifies a KLV track. The default is "klv", which means the default name will be Streams(klv.cmfm). Any string you enter here will replace the "klv" string.\nThe modifier can only contain: numbers, letters, plus (+), minus (-), underscore (_) and period (.) and has a maximum length of 100 characters.
1079+
* @public
1080+
*/
1081+
KlvNameModifier?: string | undefined;
1082+
1083+
/**
1084+
* Change the modifier that MediaLive automatically adds to the Streams() name that identifies a Nielsen ID3 track. The default is "nid3", which means the default name will be Streams(nid3.cmfm). Any string you enter here will replace the "nid3" string.\nThe modifier can only contain: numbers, letters, plus (+), minus (-), underscore (_) and period (.) and has a maximum length of 100 characters.
1085+
* @public
1086+
*/
1087+
NielsenId3NameModifier?: string | undefined;
1088+
1089+
/**
1090+
* Change the modifier that MediaLive automatically adds to the Streams() name for a SCTE 35 track. The default is "scte", which means the default name will be Streams(scte.cmfm). Any string you enter here will replace the "scte" string.\nThe modifier can only contain: numbers, letters, plus (+), minus (-), underscore (_) and period (.) and has a maximum length of 100 characters.
1091+
* @public
1092+
*/
1093+
Scte35NameModifier?: string | undefined;
10561094
}
10571095

10581096
/**
@@ -2842,30 +2880,30 @@ export interface RouteUpdateRequest {
28422880
}
28432881

28442882
/**
2845-
* Settings for the action to insert a user-defined ID3 tag in each HLS segment
2883+
* Settings for the action to insert ID3 metadata in every segment, in HLS output groups.
28462884
* @public
28472885
*/
28482886
export interface HlsId3SegmentTaggingScheduleActionSettings {
28492887
/**
2850-
* ID3 tag to insert into each segment. Supports special keyword identifiers to substitute in segment-related values.\nSupported keyword identifiers: https://docs.aws.amazon.com/medialive/latest/ug/variable-data-identifiers.html
2888+
* Complete this parameter if you want to specify only the metadata, not the entire frame. MediaLive will insert the metadata in a TXXX frame. Enter the value as plain text. You can include standard MediaLive variable data such as the current segment number.
28512889
* @public
28522890
*/
28532891
Tag?: string | undefined;
28542892

28552893
/**
2856-
* Base64 string formatted according to the ID3 specification: http://id3.org/id3v2.4.0-structure
2894+
* Complete this parameter if you want to specify the entire ID3 metadata. Enter a base64 string that contains one or more fully formed ID3 tags, according to the ID3 specification: http://id3.org/id3v2.4.0-structure
28572895
* @public
28582896
*/
28592897
Id3?: string | undefined;
28602898
}
28612899

28622900
/**
2863-
* Settings for the action to emit HLS metadata
2901+
* Settings for the action to insert ID3 metadata (as a one-time action) in HLS output groups.
28642902
* @public
28652903
*/
28662904
export interface HlsTimedMetadataScheduleActionSettings {
28672905
/**
2868-
* Base64 string formatted according to the ID3 specification: http://id3.org/id3v2.4.0-structure
2906+
* Enter a base64 string that contains one or more fully formed ID3 tags.See the ID3 specification: http://id3.org/id3v2.4.0-structure
28692907
* @public
28702908
*/
28712909
Id3: string | undefined;
@@ -3510,13 +3548,13 @@ export interface StaticImageOutputDeactivateScheduleActionSettings {
35103548
*/
35113549
export interface ScheduleActionSettings {
35123550
/**
3513-
* Action to insert HLS ID3 segment tagging
3551+
* Action to insert ID3 metadata in every segment, in HLS output groups
35143552
* @public
35153553
*/
35163554
HlsId3SegmentTaggingSettings?: HlsId3SegmentTaggingScheduleActionSettings | undefined;
35173555

35183556
/**
3519-
* Action to insert HLS metadata
3557+
* Action to insert ID3 metadata once, in HLS output groups
35203558
* @public
35213559
*/
35223560
HlsTimedMetadataSettings?: HlsTimedMetadataScheduleActionSettings | undefined;
@@ -7138,18 +7176,3 @@ export interface OutputLockingSettings {
71387176
*/
71397177
PipelineLockingSettings?: PipelineLockingSettings | undefined;
71407178
}
7141-
7142-
/**
7143-
* @public
7144-
* @enum
7145-
*/
7146-
export const GlobalConfigurationOutputTimingSource = {
7147-
INPUT_CLOCK: "INPUT_CLOCK",
7148-
SYSTEM_CLOCK: "SYSTEM_CLOCK",
7149-
} as const;
7150-
7151-
/**
7152-
* @public
7153-
*/
7154-
export type GlobalConfigurationOutputTimingSource =
7155-
(typeof GlobalConfigurationOutputTimingSource)[keyof typeof GlobalConfigurationOutputTimingSource];

0 commit comments

Comments
 (0)
Please sign in to comment.