Skip to content

Commit 333dd69

Browse files
author
AWS
committed
AWS Elemental MediaPackage v2 Update: Dash v2 is a MediaPackage V2 feature to support egressing on DASH manifest format.
1 parent 6cb167d commit 333dd69

File tree

2 files changed

+264
-1
lines changed

2 files changed

+264
-1
lines changed

‎.changes/next-release/feature-AWSElementalMediaPackagev2-3de05aa.json‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
{
2+
"type": "feature",
3+
"category": "AWS Elemental MediaPackage v2",
4+
"contributor": "",
5+
"description": "Dash v2 is a MediaPackage V2 feature to support egressing on DASH manifest format."
6+
}

‎services/mediapackagev2/src/main/resources/codegen-resources/service-2.json‎

Lines changed: 258 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -469,6 +469,13 @@
469469
},
470470
"exception":true
471471
},
472+
"AdMarkerDash":{
473+
"type":"string",
474+
"enum":[
475+
"BINARY",
476+
"XML"
477+
]
478+
},
472479
"AdMarkerHls":{
473480
"type":"string",
474481
"enum":["DATERANGE"]
@@ -743,6 +750,81 @@
743750
}
744751
}
745752
},
753+
"CreateDashManifestConfiguration":{
754+
"type":"structure",
755+
"required":["ManifestName"],
756+
"members":{
757+
"ManifestName":{
758+
"shape":"ManifestName",
759+
"documentation":"<p>A short string that's appended to the endpoint URL. The child manifest name creates a unique path to this endpoint.</p>"
760+
},
761+
"ManifestWindowSeconds":{
762+
"shape":"CreateDashManifestConfigurationManifestWindowSecondsInteger",
763+
"documentation":"<p>The total duration (in seconds) of the manifest's content.</p>"
764+
},
765+
"FilterConfiguration":{"shape":"FilterConfiguration"},
766+
"MinUpdatePeriodSeconds":{
767+
"shape":"CreateDashManifestConfigurationMinUpdatePeriodSecondsInteger",
768+
"documentation":"<p>Minimum amount of time (in seconds) that the player should wait before requesting updates to the manifest.</p>"
769+
},
770+
"MinBufferTimeSeconds":{
771+
"shape":"CreateDashManifestConfigurationMinBufferTimeSecondsInteger",
772+
"documentation":"<p>Minimum amount of content (in seconds) that a player must keep available in the buffer.</p>"
773+
},
774+
"SuggestedPresentationDelaySeconds":{
775+
"shape":"CreateDashManifestConfigurationSuggestedPresentationDelaySecondsInteger",
776+
"documentation":"<p>The amount of time (in seconds) that the player should be from the end of the manifest.</p>"
777+
},
778+
"SegmentTemplateFormat":{
779+
"shape":"DashSegmentTemplateFormat",
780+
"documentation":"<p>Determines the type of variable used in the <code>media</code> URL of the <code>SegmentTemplate</code> tag in the manifest. Also specifies if segment timeline information is included in <code>SegmentTimeline</code> or <code>SegmentTemplate</code>.</p> <p>Value description:</p> <ul> <li> <p> <code>NUMBER_WITH_TIMELINE</code> - The <code>$Number$</code> variable is used in the <code>media</code> URL. The value of this variable is the sequential number of the segment. A full <code>SegmentTimeline</code> object is presented in each <code>SegmentTemplate</code>.</p> </li> </ul>"
781+
},
782+
"PeriodTriggers":{
783+
"shape":"DashPeriodTriggers",
784+
"documentation":"<p>A list of triggers that controls when AWS Elemental MediaPackage separates the MPEG-DASH manifest into multiple periods. Type <code>ADS</code> to indicate that AWS Elemental MediaPackage must create periods in the output manifest that correspond to SCTE-35 ad markers in the input source. Leave this value empty to indicate that the manifest is contained all in one period. For more information about periods in the DASH manifest, see <a href=\"https://docs.aws.amazon.com/mediapackage/latest/userguide/multi-period.html\">Multi-period DASH in AWS Elemental MediaPackage</a>.</p>"
785+
},
786+
"ScteDash":{
787+
"shape":"ScteDash",
788+
"documentation":"<p>The SCTE configuration.</p>"
789+
},
790+
"DrmSignaling":{
791+
"shape":"DashDrmSignaling",
792+
"documentation":"<p>Determines how the DASH manifest signals the DRM content.</p>"
793+
},
794+
"UtcTiming":{
795+
"shape":"DashUtcTiming",
796+
"documentation":"<p>Determines the type of UTC timing included in the DASH Media Presentation Description (MPD).</p>"
797+
}
798+
},
799+
"documentation":"<p>Create a DASH manifest configuration.</p>"
800+
},
801+
"CreateDashManifestConfigurationManifestWindowSecondsInteger":{
802+
"type":"integer",
803+
"box":true,
804+
"min":30
805+
},
806+
"CreateDashManifestConfigurationMinBufferTimeSecondsInteger":{
807+
"type":"integer",
808+
"box":true,
809+
"max":3600,
810+
"min":0
811+
},
812+
"CreateDashManifestConfigurationMinUpdatePeriodSecondsInteger":{
813+
"type":"integer",
814+
"box":true,
815+
"max":3600,
816+
"min":1
817+
},
818+
"CreateDashManifestConfigurationSuggestedPresentationDelaySecondsInteger":{
819+
"type":"integer",
820+
"box":true,
821+
"max":3600,
822+
"min":0
823+
},
824+
"CreateDashManifests":{
825+
"type":"list",
826+
"member":{"shape":"CreateDashManifestConfiguration"}
827+
},
746828
"CreateHlsManifestConfiguration":{
747829
"type":"structure",
748830
"required":["ManifestName"],
@@ -879,6 +961,10 @@
879961
"shape":"CreateLowLatencyHlsManifests",
880962
"documentation":"<p>A low-latency HLS manifest configuration.</p>"
881963
},
964+
"DashManifests":{
965+
"shape":"CreateDashManifests",
966+
"documentation":"<p>A DASH manifest configuration.</p>"
967+
},
882968
"Tags":{
883969
"shape":"TagMap",
884970
"documentation":"<p>A comma-separated list of tag key:value pairs that you define. For example:</p> <p> <code>\"Key1\": \"Value1\",</code> </p> <p> <code>\"Key2\": \"Value2\"</code> </p>"
@@ -952,6 +1038,10 @@
9521038
"shape":"GetLowLatencyHlsManifests",
9531039
"documentation":"<p>A low-latency HLS manifest configuration.</p>"
9541040
},
1041+
"DashManifests":{
1042+
"shape":"GetDashManifests",
1043+
"documentation":"<p>A DASH manifest configuration.</p>"
1044+
},
9551045
"ETag":{
9561046
"shape":"EntityTag",
9571047
"documentation":"<p>The current Entity Tag (ETag) associated with this resource. The entity tag can be used to safely make concurrent updates to the resource.</p>"
@@ -962,6 +1052,61 @@
9621052
}
9631053
}
9641054
},
1055+
"DashDrmSignaling":{
1056+
"type":"string",
1057+
"enum":[
1058+
"INDIVIDUAL",
1059+
"REFERENCED"
1060+
]
1061+
},
1062+
"DashPeriodTrigger":{
1063+
"type":"string",
1064+
"enum":[
1065+
"AVAILS",
1066+
"DRM_KEY_ROTATION",
1067+
"SOURCE_CHANGES",
1068+
"SOURCE_DISRUPTIONS",
1069+
"NONE"
1070+
]
1071+
},
1072+
"DashPeriodTriggers":{
1073+
"type":"list",
1074+
"member":{"shape":"DashPeriodTrigger"},
1075+
"max":100,
1076+
"min":0
1077+
},
1078+
"DashSegmentTemplateFormat":{
1079+
"type":"string",
1080+
"enum":["NUMBER_WITH_TIMELINE"]
1081+
},
1082+
"DashUtcTiming":{
1083+
"type":"structure",
1084+
"members":{
1085+
"TimingMode":{
1086+
"shape":"DashUtcTimingMode",
1087+
"documentation":"<p>The UTC timing mode.</p>"
1088+
},
1089+
"TimingSource":{
1090+
"shape":"DashUtcTimingTimingSourceString",
1091+
"documentation":"<p>The the method that the player uses to synchronize to coordinated universal time (UTC) wall clock time.</p>"
1092+
}
1093+
},
1094+
"documentation":"<p>Determines the type of UTC timing included in the DASH Media Presentation Description (MPD).</p>"
1095+
},
1096+
"DashUtcTimingMode":{
1097+
"type":"string",
1098+
"enum":[
1099+
"HTTP_HEAD",
1100+
"HTTP_ISO",
1101+
"HTTP_XSDATE",
1102+
"UTC_DIRECT"
1103+
]
1104+
},
1105+
"DashUtcTimingTimingSourceString":{
1106+
"type":"string",
1107+
"max":1024,
1108+
"min":1
1109+
},
9651110
"DeleteChannelGroupRequest":{
9661111
"type":"structure",
9671112
"required":["ChannelGroupName"],
@@ -1381,6 +1526,65 @@
13811526
}
13821527
}
13831528
},
1529+
"GetDashManifestConfiguration":{
1530+
"type":"structure",
1531+
"required":[
1532+
"ManifestName",
1533+
"Url"
1534+
],
1535+
"members":{
1536+
"ManifestName":{
1537+
"shape":"ResourceName",
1538+
"documentation":"<p>A short string that's appended to the endpoint URL. The manifest name creates a unique path to this endpoint. If you don't enter a value, MediaPackage uses the default manifest name, index. </p>"
1539+
},
1540+
"Url":{
1541+
"shape":"String",
1542+
"documentation":"<p>The egress domain URL for stream delivery from MediaPackage.</p>"
1543+
},
1544+
"ManifestWindowSeconds":{
1545+
"shape":"Integer",
1546+
"documentation":"<p>The total duration (in seconds) of the manifest's content.</p>"
1547+
},
1548+
"FilterConfiguration":{"shape":"FilterConfiguration"},
1549+
"MinUpdatePeriodSeconds":{
1550+
"shape":"Integer",
1551+
"documentation":"<p>Minimum amount of time (in seconds) that the player should wait before requesting updates to the manifest.</p>"
1552+
},
1553+
"MinBufferTimeSeconds":{
1554+
"shape":"Integer",
1555+
"documentation":"<p>Minimum amount of content (in seconds) that a player must keep available in the buffer.</p>"
1556+
},
1557+
"SuggestedPresentationDelaySeconds":{
1558+
"shape":"Integer",
1559+
"documentation":"<p>The amount of time (in seconds) that the player should be from the end of the manifest.</p>"
1560+
},
1561+
"SegmentTemplateFormat":{
1562+
"shape":"DashSegmentTemplateFormat",
1563+
"documentation":"<p>Determines the type of variable used in the <code>media</code> URL of the <code>SegmentTemplate</code> tag in the manifest. Also specifies if segment timeline information is included in <code>SegmentTimeline</code> or <code>SegmentTemplate</code>.</p> <p>Value description:</p> <ul> <li> <p> <code>NUMBER_WITH_TIMELINE</code> - The <code>$Number$</code> variable is used in the <code>media</code> URL. The value of this variable is the sequential number of the segment. A full <code>SegmentTimeline</code> object is presented in each <code>SegmentTemplate</code>.</p> </li> </ul>"
1564+
},
1565+
"PeriodTriggers":{
1566+
"shape":"DashPeriodTriggers",
1567+
"documentation":"<p>A list of triggers that controls when AWS Elemental MediaPackage separates the MPEG-DASH manifest into multiple periods. Leave this value empty to indicate that the manifest is contained all in one period. For more information about periods in the DASH manifest, see <a href=\"https://docs.aws.amazon.com/mediapackage/latest/userguide/multi-period.html\">Multi-period DASH in AWS Elemental MediaPackage</a>.</p>"
1568+
},
1569+
"ScteDash":{
1570+
"shape":"ScteDash",
1571+
"documentation":"<p>The SCTE configuration.</p>"
1572+
},
1573+
"DrmSignaling":{
1574+
"shape":"DashDrmSignaling",
1575+
"documentation":"<p>Determines how the DASH manifest signals the DRM content.</p>"
1576+
},
1577+
"UtcTiming":{
1578+
"shape":"DashUtcTiming",
1579+
"documentation":"<p>Determines the type of UTC timing included in the DASH Media Presentation Description (MPD).</p>"
1580+
}
1581+
},
1582+
"documentation":"<p>Retrieve the DASH manifest configuration.</p>"
1583+
},
1584+
"GetDashManifests":{
1585+
"type":"list",
1586+
"member":{"shape":"GetDashManifestConfiguration"}
1587+
},
13841588
"GetHlsManifestConfiguration":{
13851589
"type":"structure",
13861590
"required":[
@@ -1601,6 +1805,10 @@
16011805
"Tags":{
16021806
"shape":"TagMap",
16031807
"documentation":"<p>The comma-separated list of tag key:value pairs assigned to the origin endpoint.</p>"
1808+
},
1809+
"DashManifests":{
1810+
"shape":"GetDashManifests",
1811+
"documentation":"<p>A DASH manifest configuration.</p>"
16041812
}
16051813
}
16061814
},
@@ -1710,6 +1918,25 @@
17101918
}
17111919
}
17121920
},
1921+
"ListDashManifestConfiguration":{
1922+
"type":"structure",
1923+
"required":["ManifestName"],
1924+
"members":{
1925+
"ManifestName":{
1926+
"shape":"ResourceName",
1927+
"documentation":"<p>A short string that's appended to the endpoint URL. The manifest name creates a unique path to this endpoint. If you don't enter a value, MediaPackage uses the default manifest name, index. </p>"
1928+
},
1929+
"Url":{
1930+
"shape":"String",
1931+
"documentation":"<p>The egress domain URL for stream delivery from MediaPackage.</p>"
1932+
}
1933+
},
1934+
"documentation":"<p>List the DASH manifest configuration.</p>"
1935+
},
1936+
"ListDashManifests":{
1937+
"type":"list",
1938+
"member":{"shape":"ListDashManifestConfiguration"}
1939+
},
17131940
"ListHlsManifestConfiguration":{
17141941
"type":"structure",
17151942
"required":["ManifestName"],
@@ -1885,6 +2112,10 @@
18852112
"LowLatencyHlsManifests":{
18862113
"shape":"ListLowLatencyHlsManifests",
18872114
"documentation":"<p>A low-latency HLS manifest configuration.</p>"
2115+
},
2116+
"DashManifests":{
2117+
"shape":"ListDashManifests",
2118+
"documentation":"<p>A DASH manifest configuration.</p>"
18882119
}
18892120
},
18902121
"documentation":"<p>The configuration of the origin endpoint.</p>"
@@ -2037,6 +2268,16 @@
20372268
},
20382269
"documentation":"<p>The SCTE configuration.</p>"
20392270
},
2271+
"ScteDash":{
2272+
"type":"structure",
2273+
"members":{
2274+
"AdMarkerDash":{
2275+
"shape":"AdMarkerDash",
2276+
"documentation":"<p>Choose how ad markers are included in the packaged content. If you include ad markers in the content stream in your upstream encoders, then you need to inform MediaPackage what to do with the ad markers in the output.</p> <p>Value description:</p> <ul> <li> <p> <code>Binary</code> - The SCTE-35 marker is expressed as a hex-string (Base64 string) rather than full XML.</p> </li> <li> <p> <code>XML</code> - The SCTE marker is expressed fully in XML.</p> </li> </ul>"
2277+
}
2278+
},
2279+
"documentation":"<p>The SCTE configuration.</p>"
2280+
},
20402281
"ScteFilter":{
20412282
"type":"string",
20422283
"enum":[
@@ -2446,6 +2687,10 @@
24462687
"shape":"CreateLowLatencyHlsManifests",
24472688
"documentation":"<p>A low-latency HLS manifest configuration.</p>"
24482689
},
2690+
"DashManifests":{
2691+
"shape":"CreateDashManifests",
2692+
"documentation":"<p>A DASH manifest configuration.</p>"
2693+
},
24492694
"ETag":{
24502695
"shape":"EntityTag",
24512696
"documentation":"<p>The expected current Entity Tag (ETag) for the resource. If the specified ETag does not match the resource's current entity tag, the update request will be rejected.</p>",
@@ -2529,6 +2774,10 @@
25292774
"shape":"TagMap",
25302775
"documentation":"<p>The comma-separated list of tag key:value pairs assigned to the origin endpoint.</p>",
25312776
"locationName":"tags"
2777+
},
2778+
"DashManifests":{
2779+
"shape":"GetDashManifests",
2780+
"documentation":"<p>A DASH manifest configuration.</p>"
25322781
}
25332782
}
25342783
},
@@ -2560,6 +2809,7 @@
25602809
"ENCRYPTION_CONTRACT_SHARED",
25612810
"NUM_MANIFESTS_LOW",
25622811
"NUM_MANIFESTS_HIGH",
2812+
"MANIFEST_DRM_SYSTEMS_INCOMPATIBLE",
25632813
"DRM_SYSTEMS_ENCRYPTION_METHOD_INCOMPATIBLE",
25642814
"ROLE_ARN_NOT_ASSUMABLE",
25652815
"ROLE_ARN_LENGTH_OUT_OF_RANGE",
@@ -2583,7 +2833,14 @@
25832833
"MEMBER_DOES_NOT_MATCH_PATTERN",
25842834
"INVALID_MANIFEST_FILTER",
25852835
"INVALID_TIME_DELAY_SECONDS",
2586-
"END_TIME_EARLIER_THAN_START_TIME"
2836+
"END_TIME_EARLIER_THAN_START_TIME",
2837+
"TS_CONTAINER_TYPE_WITH_DASH_MANIFEST",
2838+
"DIRECT_MODE_WITH_TIMING_SOURCE",
2839+
"NONE_MODE_WITH_TIMING_SOURCE",
2840+
"TIMING_SOURCE_MISSING",
2841+
"UPDATE_PERIOD_SMALLER_THAN_SEGMENT_DURATION",
2842+
"PERIOD_TRIGGERS_NONE_SPECIFIED_WITH_ADDITIONAL_VALUES",
2843+
"DRM_SIGNALING_MISMATCH_SEGMENT_ENCRYPTION_STATUS"
25872844
]
25882845
}
25892846
},

0 commit comments

Comments
 (0)