Skip to content

Commit abdcf5b

Browse files
This release provides the flexibility to configure what renditions or thumbnail qualities to record when creating recording configuration.
1 parent f21dd7c commit abdcf5b

24 files changed

+3838
-6
lines changed

generator/ServiceModels/ivs/ivs-2020-07-14.api.json

Lines changed: 58 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,10 @@
4343
"input":{"shape":"BatchStartViewerSessionRevocationRequest"},
4444
"output":{"shape":"BatchStartViewerSessionRevocationResponse"},
4545
"errors":[
46-
{"shape":"ValidationException"}
46+
{"shape":"AccessDeniedException"},
47+
{"shape":"ValidationException"},
48+
{"shape":"PendingVerification"},
49+
{"shape":"ThrottlingException"}
4750
]
4851
},
4952
"CreateChannel":{
@@ -399,9 +402,11 @@
399402
"input":{"shape":"StartViewerSessionRevocationRequest"},
400403
"output":{"shape":"StartViewerSessionRevocationResponse"},
401404
"errors":[
405+
{"shape":"ResourceNotFoundException"},
402406
{"shape":"InternalServerException"},
403407
{"shape":"AccessDeniedException"},
404408
{"shape":"ValidationException"},
409+
{"shape":"PendingVerification"},
405410
{"shape":"ThrottlingException"}
406411
]
407412
},
@@ -708,6 +713,7 @@
708713
"destinationConfiguration":{"shape":"DestinationConfiguration"},
709714
"name":{"shape":"RecordingConfigurationName"},
710715
"recordingReconnectWindowSeconds":{"shape":"RecordingReconnectWindowSeconds"},
716+
"renditionConfiguration":{"shape":"RenditionConfiguration"},
711717
"tags":{"shape":"Tags"},
712718
"thumbnailConfiguration":{"shape":"ThumbnailConfiguration"}
713719
}
@@ -1101,6 +1107,7 @@
11011107
"destinationConfiguration":{"shape":"DestinationConfiguration"},
11021108
"name":{"shape":"RecordingConfigurationName"},
11031109
"recordingReconnectWindowSeconds":{"shape":"RecordingReconnectWindowSeconds"},
1110+
"renditionConfiguration":{"shape":"RenditionConfiguration"},
11041111
"state":{"shape":"RecordingConfigurationState"},
11051112
"tags":{"shape":"Tags"},
11061113
"thumbnailConfiguration":{"shape":"ThumbnailConfiguration"}
@@ -1157,6 +1164,34 @@
11571164
"max":300,
11581165
"min":0
11591166
},
1167+
"RenditionConfiguration":{
1168+
"type":"structure",
1169+
"members":{
1170+
"renditionSelection":{"shape":"RenditionConfigurationRenditionSelection"},
1171+
"renditions":{"shape":"RenditionConfigurationRenditionList"}
1172+
}
1173+
},
1174+
"RenditionConfigurationRendition":{
1175+
"type":"string",
1176+
"enum":[
1177+
"FULL_HD",
1178+
"HD",
1179+
"SD",
1180+
"LOWEST_RESOLUTION"
1181+
]
1182+
},
1183+
"RenditionConfigurationRenditionList":{
1184+
"type":"list",
1185+
"member":{"shape":"RenditionConfigurationRendition"}
1186+
},
1187+
"RenditionConfigurationRenditionSelection":{
1188+
"type":"string",
1189+
"enum":[
1190+
"ALL",
1191+
"NONE",
1192+
"CUSTOM"
1193+
]
1194+
},
11601195
"ResourceArn":{
11611196
"type":"string",
11621197
"max":128,
@@ -1444,9 +1479,31 @@
14441479
"type":"structure",
14451480
"members":{
14461481
"recordingMode":{"shape":"RecordingMode"},
1482+
"resolution":{"shape":"ThumbnailConfigurationResolution"},
1483+
"storage":{"shape":"ThumbnailConfigurationStorageList"},
14471484
"targetIntervalSeconds":{"shape":"TargetIntervalSeconds"}
14481485
}
14491486
},
1487+
"ThumbnailConfigurationResolution":{
1488+
"type":"string",
1489+
"enum":[
1490+
"FULL_HD",
1491+
"HD",
1492+
"SD",
1493+
"LOWEST_RESOLUTION"
1494+
]
1495+
},
1496+
"ThumbnailConfigurationStorage":{
1497+
"type":"string",
1498+
"enum":[
1499+
"SEQUENTIAL",
1500+
"LATEST"
1501+
]
1502+
},
1503+
"ThumbnailConfigurationStorageList":{
1504+
"type":"list",
1505+
"member":{"shape":"ThumbnailConfigurationStorage"}
1506+
},
14501507
"Time":{
14511508
"type":"timestamp",
14521509
"timestampFormat":"iso8601"

generator/ServiceModels/ivs/ivs-2020-07-14.docs.json

Lines changed: 44 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -645,6 +645,31 @@
645645
"RecordingConfiguration$recordingReconnectWindowSeconds": "<p>If a broadcast disconnects and then reconnects within the specified interval, the multiple streams will be considered a single broadcast and merged together. Default: 0.</p>"
646646
}
647647
},
648+
"RenditionConfiguration": {
649+
"base": "<p>Object that describes which renditions should be recorded for a stream.</p>",
650+
"refs": {
651+
"CreateRecordingConfigurationRequest$renditionConfiguration": "<p>Object that describes which renditions should be recorded for a stream.</p>",
652+
"RecordingConfiguration$renditionConfiguration": "<p>Object that describes which renditions should be recorded for a stream.</p>"
653+
}
654+
},
655+
"RenditionConfigurationRendition": {
656+
"base": null,
657+
"refs": {
658+
"RenditionConfigurationRenditionList$member": null
659+
}
660+
},
661+
"RenditionConfigurationRenditionList": {
662+
"base": null,
663+
"refs": {
664+
"RenditionConfiguration$renditions": "<p>Indicates which renditions are recorded for a stream, if <code>renditionSelection</code> is <code>CUSTOM</code>; otherwise, this field is irrelevant. The selected renditions are recorded if they are available during the stream. If a selected rendition is unavailable, the best available rendition is recorded. For details on the resolution dimensions of each rendition, see <a href=\"https://docs.aws.amazon.com/ivs/latest/userguide/record-to-s3.html\">Auto-Record to Amazon S3</a>.</p>"
665+
}
666+
},
667+
"RenditionConfigurationRenditionSelection": {
668+
"base": null,
669+
"refs": {
670+
"RenditionConfiguration$renditionSelection": "<p>Indicates which set of renditions are recorded for a stream. For <code>BASIC</code> channels, the <code>CUSTOM</code> value has no effect. If <code>CUSTOM</code> is specified, a set of renditions must be specified in the <code>renditions</code> field. Default: <code>ALL</code>.</p>"
671+
}
672+
},
648673
"ResourceArn": {
649674
"base": null,
650675
"refs": {
@@ -912,7 +937,7 @@
912937
"TargetIntervalSeconds": {
913938
"base": null,
914939
"refs": {
915-
"ThumbnailConfiguration$targetIntervalSeconds": "<p>The targeted thumbnail-generation interval in seconds. This is configurable (and required) only if <code>recordingMode</code> is <code>INTERVAL</code>. Default: 60.</p> <p> <b>Important:</b> Setting a value for <code>targetIntervalSeconds</code> does not guarantee that thumbnails are generated at the specified interval. For thumbnails to be generated at the <code>targetIntervalSeconds</code> interval, the <code>IDR/Keyframe</code> value for the input video must be less than the <code>targetIntervalSeconds</code> value. See <a href=\"https://docs.aws.amazon.com/ivs/latest/userguide/streaming-config.html\"> Amazon IVS Streaming Configuration</a> for information on setting <code>IDR/Keyframe</code> to the recommended value in video-encoder settings.</p>"
940+
"ThumbnailConfiguration$targetIntervalSeconds": "<p>The targeted thumbnail-generation interval in seconds. This is configurable (and required) only if <code>recordingMode</code> is <code>INTERVAL</code>. Default: 60.</p> <p> <b>Important:</b> For the <code>BASIC</code> channel type, setting a value for <code>targetIntervalSeconds</code> does not guarantee that thumbnails are generated at the specified interval. For thumbnails to be generated at the <code>targetIntervalSeconds</code> interval, the <code>IDR/Keyframe</code> value for the input video must be less than the <code>targetIntervalSeconds</code> value. See <a href=\"https://docs.aws.amazon.com/ivs/latest/userguide/streaming-config.html\"> Amazon IVS Streaming Configuration</a> for information on setting <code>IDR/Keyframe</code> to the recommended value in video-encoder settings.</p>"
916941
}
917942
},
918943
"ThrottlingException": {
@@ -927,6 +952,24 @@
927952
"RecordingConfiguration$thumbnailConfiguration": "<p>A complex type that allows you to enable/disable the recording of thumbnails for a live session and modify the interval at which thumbnails are generated for the live session.</p>"
928953
}
929954
},
955+
"ThumbnailConfigurationResolution": {
956+
"base": null,
957+
"refs": {
958+
"ThumbnailConfiguration$resolution": "<p>Indicates the desired resolution of recorded thumbnails. Thumbnails are recorded at the selected resolution if the corresponding rendition is available during the stream; otherwise, they are recorded at source resolution. For more information about resolution values and their corresponding height and width dimensions, see <a href=\"https://docs.aws.amazon.com/ivs/latest/userguide/record-to-s3.html\">Auto-Record to Amazon S3</a>. Default: Null (source resolution is returned).</p>"
959+
}
960+
},
961+
"ThumbnailConfigurationStorage": {
962+
"base": null,
963+
"refs": {
964+
"ThumbnailConfigurationStorageList$member": null
965+
}
966+
},
967+
"ThumbnailConfigurationStorageList": {
968+
"base": null,
969+
"refs": {
970+
"ThumbnailConfiguration$storage": "<p>Indicates the format in which thumbnails are recorded. <code>SEQUENTIAL</code> records all generated thumbnails in a serial manner, to the media/thumbnails directory. <code>LATEST</code> saves the latest thumbnail in media/latest_thumbnail/thumb.jpg and overwrites it at the interval specified by <code>targetIntervalSeconds</code>. You can enable both <code>SEQUENTIAL</code> and <code>LATEST</code>. Default: <code>SEQUENTIAL</code>.</p>"
971+
}
972+
},
930973
"Time": {
931974
"base": null,
932975
"refs": {

0 commit comments

Comments
 (0)