Skip to content

Commit a2bc584

Browse files
MediaPackage v2 now supports the Media Quality Confidence Score (MQCS) published from MediaLive. Customers can control input switching based on the MQCS and publishing HTTP Headers for the MQCS via the API.
1 parent dbc8a28 commit a2bc584

24 files changed

+860
-22
lines changed

generator/ServiceModels/mediapackagev2/mediapackagev2-2022-12-25.api.json

Lines changed: 29 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -711,6 +711,8 @@
711711
},
712712
"InputType":{"shape":"InputType"},
713713
"Description":{"shape":"ResourceDescription"},
714+
"InputSwitchConfiguration":{"shape":"InputSwitchConfiguration"},
715+
"OutputHeaderConfiguration":{"shape":"OutputHeaderConfiguration"},
714716
"Tags":{
715717
"shape":"TagMap",
716718
"locationName":"tags"
@@ -736,7 +738,9 @@
736738
"IngestEndpoints":{"shape":"IngestEndpointList"},
737739
"InputType":{"shape":"InputType"},
738740
"ETag":{"shape":"EntityTag"},
739-
"Tags":{"shape":"TagMap"}
741+
"Tags":{"shape":"TagMap"},
742+
"InputSwitchConfiguration":{"shape":"InputSwitchConfiguration"},
743+
"OutputHeaderConfiguration":{"shape":"OutputHeaderConfiguration"}
740744
}
741745
},
742746
"CreateDashManifestConfiguration":{
@@ -1372,7 +1376,9 @@
13721376
"IngestEndpoints":{"shape":"IngestEndpointList"},
13731377
"InputType":{"shape":"InputType"},
13741378
"ETag":{"shape":"EntityTag"},
1375-
"Tags":{"shape":"TagMap"}
1379+
"Tags":{"shape":"TagMap"},
1380+
"InputSwitchConfiguration":{"shape":"InputSwitchConfiguration"},
1381+
"OutputHeaderConfiguration":{"shape":"OutputHeaderConfiguration"}
13761382
}
13771383
},
13781384
"GetDashManifestConfiguration":{
@@ -1717,6 +1723,12 @@
17171723
"type":"list",
17181724
"member":{"shape":"IngestEndpoint"}
17191725
},
1726+
"InputSwitchConfiguration":{
1727+
"type":"structure",
1728+
"members":{
1729+
"MQCSInputSwitching":{"shape":"Boolean"}
1730+
}
1731+
},
17201732
"InputType":{
17211733
"type":"string",
17221734
"enum":[
@@ -1982,6 +1994,12 @@
19821994
"type":"list",
19831995
"member":{"shape":"OriginEndpointListConfiguration"}
19841996
},
1997+
"OutputHeaderConfiguration":{
1998+
"type":"structure",
1999+
"members":{
2000+
"PublishMQCS":{"shape":"Boolean"}
2001+
}
2002+
},
19852003
"PolicyText":{
19862004
"type":"string",
19872005
"max":6144,
@@ -2375,7 +2393,9 @@
23752393
"location":"header",
23762394
"locationName":"x-amzn-update-if-match"
23772395
},
2378-
"Description":{"shape":"ResourceDescription"}
2396+
"Description":{"shape":"ResourceDescription"},
2397+
"InputSwitchConfiguration":{"shape":"InputSwitchConfiguration"},
2398+
"OutputHeaderConfiguration":{"shape":"OutputHeaderConfiguration"}
23792399
}
23802400
},
23812401
"UpdateChannelResponse":{
@@ -2400,7 +2420,9 @@
24002420
"Tags":{
24012421
"shape":"TagMap",
24022422
"locationName":"tags"
2403-
}
2423+
},
2424+
"InputSwitchConfiguration":{"shape":"InputSwitchConfiguration"},
2425+
"OutputHeaderConfiguration":{"shape":"OutputHeaderConfiguration"}
24042426
}
24052427
},
24062428
"UpdateOriginEndpointRequest":{
@@ -2549,7 +2571,9 @@
25492571
"HARVEST_JOB_UNABLE_TO_WRITE_TO_S3_DESTINATION",
25502572
"HARVEST_JOB_CUSTOMER_ENDPOINT_READ_ACCESS_DENIED",
25512573
"CLIP_START_TIME_WITH_START_OR_END",
2552-
"START_TAG_TIME_OFFSET_INVALID"
2574+
"START_TAG_TIME_OFFSET_INVALID",
2575+
"ONLY_CMAF_INPUT_TYPE_ALLOW_MQCS_INPUT_SWITCHING",
2576+
"ONLY_CMAF_INPUT_TYPE_ALLOW_MQCS_OUTPUT_CONFIGURATION"
25532577
]
25542578
}
25552579
}

generator/ServiceModels/mediapackagev2/mediapackagev2-2022-12-25.docs.json

Lines changed: 26 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -52,6 +52,8 @@
5252
"Boolean": {
5353
"base": null,
5454
"refs": {
55+
"InputSwitchConfiguration$MQCSInputSwitching": "<p>When true, AWS Elemental MediaPackage performs input switching based on the MQCS. Default is true. This setting is valid only when <code>InputType</code> is <code>CMAF</code>.</p>",
56+
"OutputHeaderConfiguration$PublishMQCS": "<p>When true, AWS Elemental MediaPackage includes the MQCS in responses to the CDN. This setting is valid only when <code>InputType</code> is <code>CMAF</code>.</p>",
5557
"Segment$TsUseAudioRenditionGroup": "<p>When selected, MediaPackage bundles all audio tracks in a rendition group. All other tracks in the stream can be used with any audio rendition from the group.</p>",
5658
"Segment$IncludeIframeOnlyStreams": "<p>When selected, the stream set includes an additional I-frame only stream, along with the other tracks. If false, this extra stream is not included. MediaPackage generates an I-frame only stream from the first rendition in the manifest. The service inserts EXT-I-FRAMES-ONLY tags in the output manifest, and then generates and includes an I-frames only playlist in the stream. This playlist permits player functionality like fast forward and rewind.</p>",
5759
"Segment$TsIncludeDvbSubtitles": "<p>By default, MediaPackage excludes all digital video broadcasting (DVB) subtitles from the output. When selected, MediaPackage passes through DVB subtitles into the output.</p>",
@@ -202,7 +204,7 @@
202204
"CreateHlsManifestConfigurationProgramDateTimeIntervalSecondsInteger": {
203205
"base": null,
204206
"refs": {
205-
"CreateHlsManifestConfiguration$ProgramDateTimeIntervalSeconds": "<p>Inserts EXT-X-PROGRAM-DATE-TIME tags in the output manifest at the interval that you specify. If you don't enter an interval, EXT-X-PROGRAM-DATE-TIME tags aren't included in the manifest. The tags sync the stream to the wall clock so that viewers can seek to a specific time in the playback timeline on the player. ID3Timed metadata messages generate every 5 seconds whenever the content is ingested.</p> <p>Irrespective of this parameter, if any ID3Timed metadata is in the HLS input, it is passed through to the HLS output.</p>"
207+
"CreateHlsManifestConfiguration$ProgramDateTimeIntervalSeconds": "<p>Inserts EXT-X-PROGRAM-DATE-TIME tags in the output manifest at the interval that you specify. If you don't enter an interval, EXT-X-PROGRAM-DATE-TIME tags aren't included in the manifest. The tags sync the stream to the wall clock so that viewers can seek to a specific time in the playback timeline on the player.</p> <p>Irrespective of this parameter, if any ID3Timed metadata is in the HLS input, it is passed through to the HLS output.</p>"
206208
}
207209
},
208210
"CreateHlsManifests": {
@@ -227,7 +229,7 @@
227229
"CreateLowLatencyHlsManifestConfigurationProgramDateTimeIntervalSecondsInteger": {
228230
"base": null,
229231
"refs": {
230-
"CreateLowLatencyHlsManifestConfiguration$ProgramDateTimeIntervalSeconds": "<p>Inserts EXT-X-PROGRAM-DATE-TIME tags in the output manifest at the interval that you specify. If you don't enter an interval, EXT-X-PROGRAM-DATE-TIME tags aren't included in the manifest. The tags sync the stream to the wall clock so that viewers can seek to a specific time in the playback timeline on the player. ID3Timed metadata messages generate every 5 seconds whenever the content is ingested.</p> <p>Irrespective of this parameter, if any ID3Timed metadata is in the HLS input, it is passed through to the HLS output.</p>"
232+
"CreateLowLatencyHlsManifestConfiguration$ProgramDateTimeIntervalSeconds": "<p>Inserts EXT-X-PROGRAM-DATE-TIME tags in the output manifest at the interval that you specify. If you don't enter an interval, EXT-X-PROGRAM-DATE-TIME tags aren't included in the manifest. The tags sync the stream to the wall clock so that viewers can seek to a specific time in the playback timeline on the player.</p> <p>Irrespective of this parameter, if any ID3Timed metadata is in the HLS input, it is passed through to the HLS output.</p>"
231233
}
232234
},
233235
"CreateLowLatencyHlsManifests": {
@@ -667,6 +669,16 @@
667669
"UpdateChannelResponse$IngestEndpoints": null
668670
}
669671
},
672+
"InputSwitchConfiguration": {
673+
"base": "<p>The configuration for input switching based on the media quality confidence score (MQCS) as provided from AWS Elemental MediaLive.</p>",
674+
"refs": {
675+
"CreateChannelRequest$InputSwitchConfiguration": "<p>The configuration for input switching based on the media quality confidence score (MQCS) as provided from AWS Elemental MediaLive. This setting is valid only when <code>InputType</code> is <code>CMAF</code>.</p>",
676+
"CreateChannelResponse$InputSwitchConfiguration": "<p>The configuration for input switching based on the media quality confidence score (MQCS) as provided from AWS Elemental MediaLive. This setting is valid only when <code>InputType</code> is <code>CMAF</code>.</p>",
677+
"GetChannelResponse$InputSwitchConfiguration": "<p>The configuration for input switching based on the media quality confidence score (MQCS) as provided from AWS Elemental MediaLive. This setting is valid only when <code>InputType</code> is <code>CMAF</code>.</p>",
678+
"UpdateChannelRequest$InputSwitchConfiguration": "<p>The configuration for input switching based on the media quality confidence score (MQCS) as provided from AWS Elemental MediaLive. This setting is valid only when <code>InputType</code> is <code>CMAF</code>.</p>",
679+
"UpdateChannelResponse$InputSwitchConfiguration": "<p>The configuration for input switching based on the media quality confidence score (MQCS) as provided from AWS Elemental MediaLive. This setting is valid only when <code>InputType</code> is <code>CMAF</code>.</p>"
680+
}
681+
},
670682
"InputType": {
671683
"base": null,
672684
"refs": {
@@ -686,9 +698,9 @@
686698
"GetDashManifestConfiguration$MinBufferTimeSeconds": "<p>Minimum amount of content (in seconds) that a player must keep available in the buffer.</p>",
687699
"GetDashManifestConfiguration$SuggestedPresentationDelaySeconds": "<p>The amount of time (in seconds) that the player should be from the end of the manifest.</p>",
688700
"GetHlsManifestConfiguration$ManifestWindowSeconds": "<p>The total duration (in seconds) of the manifest's content.</p>",
689-
"GetHlsManifestConfiguration$ProgramDateTimeIntervalSeconds": "<p>Inserts EXT-X-PROGRAM-DATE-TIME tags in the output manifest at the interval that you specify. If you don't enter an interval, EXT-X-PROGRAM-DATE-TIME tags aren't included in the manifest. The tags sync the stream to the wall clock so that viewers can seek to a specific time in the playback timeline on the player. ID3Timed metadata messages generate every 5 seconds whenever the content is ingested.</p> <p>Irrespective of this parameter, if any ID3Timed metadata is in the HLS input, it is passed through to the HLS output.</p>",
701+
"GetHlsManifestConfiguration$ProgramDateTimeIntervalSeconds": "<p>Inserts EXT-X-PROGRAM-DATE-TIME tags in the output manifest at the interval that you specify. If you don't enter an interval, EXT-X-PROGRAM-DATE-TIME tags aren't included in the manifest. The tags sync the stream to the wall clock so that viewers can seek to a specific time in the playback timeline on the player.</p> <p>Irrespective of this parameter, if any ID3Timed metadata is in the HLS input, it is passed through to the HLS output.</p>",
690702
"GetLowLatencyHlsManifestConfiguration$ManifestWindowSeconds": "<p>The total duration (in seconds) of the manifest's content.</p>",
691-
"GetLowLatencyHlsManifestConfiguration$ProgramDateTimeIntervalSeconds": "<p>Inserts EXT-X-PROGRAM-DATE-TIME tags in the output manifest at the interval that you specify. If you don't enter an interval, EXT-X-PROGRAM-DATE-TIME tags aren't included in the manifest. The tags sync the stream to the wall clock so that viewers can seek to a specific time in the playback timeline on the player. ID3Timed metadata messages generate every 5 seconds whenever the content is ingested.</p> <p>Irrespective of this parameter, if any ID3Timed metadata is in the HLS input, it is passed through to the HLS output.</p>",
703+
"GetLowLatencyHlsManifestConfiguration$ProgramDateTimeIntervalSeconds": "<p>Inserts EXT-X-PROGRAM-DATE-TIME tags in the output manifest at the interval that you specify. If you don't enter an interval, EXT-X-PROGRAM-DATE-TIME tags aren't included in the manifest. The tags sync the stream to the wall clock so that viewers can seek to a specific time in the playback timeline on the player.</p> <p>Irrespective of this parameter, if any ID3Timed metadata is in the HLS input, it is passed through to the HLS output.</p>",
692704
"GetOriginEndpointResponse$StartoverWindowSeconds": "<p>The size of the window (in seconds) to create a window of the live stream that's available for on-demand viewing. Viewers can start-over or catch-up on content that falls within the window.</p>",
693705
"UpdateOriginEndpointResponse$StartoverWindowSeconds": "<p>The size of the window (in seconds) to create a window of the live stream that's available for on-demand viewing. Viewers can start-over or catch-up on content that falls within the window.</p>"
694706
}
@@ -832,6 +844,16 @@
832844
"ListOriginEndpointsResponse$Items": "<p>The objects being returned.</p>"
833845
}
834846
},
847+
"OutputHeaderConfiguration": {
848+
"base": "<p>The settings for what common media server data (CMSD) headers AWS Elemental MediaPackage includes in responses to the CDN.</p>",
849+
"refs": {
850+
"CreateChannelRequest$OutputHeaderConfiguration": "<p>The settings for what common media server data (CMSD) headers AWS Elemental MediaPackage includes in responses to the CDN. This setting is valid only when <code>InputType</code> is <code>CMAF</code>.</p>",
851+
"CreateChannelResponse$OutputHeaderConfiguration": "<p>The settings for what common media server data (CMSD) headers AWS Elemental MediaPackage includes in responses to the CDN. This setting is valid only when <code>InputType</code> is <code>CMAF</code>.</p>",
852+
"GetChannelResponse$OutputHeaderConfiguration": "<p>The settings for what common media server data (CMSD) headers AWS Elemental MediaPackage includes in responses to the CDN. This setting is valid only when <code>InputType</code> is <code>CMAF</code>.</p>",
853+
"UpdateChannelRequest$OutputHeaderConfiguration": "<p>The settings for what common media server data (CMSD) headers AWS Elemental MediaPackage includes in responses to the CDN. This setting is valid only when <code>InputType</code> is <code>CMAF</code>.</p>",
854+
"UpdateChannelResponse$OutputHeaderConfiguration": "<p>The settings for what common media server data (CMSD) headers AWS Elemental MediaPackage includes in responses to the CDN. This setting is valid only when <code>InputType</code> is <code>CMAF</code>.</p>"
855+
}
856+
},
835857
"PolicyText": {
836858
"base": null,
837859
"refs": {

0 commit comments

Comments
 (0)