Skip to content

Commit

Permalink
API Update for Aws::ElasticTranscoder
Browse files Browse the repository at this point in the history 
Elastic Transcoder now supports additional formats, including MXF, FLAC,
and OGA, and additional flexibility for your output audio. You can use
these formats to transcode files to the XDCAM format or to a lossless
audio format.
  • Loading branch information
@awood45
awood45 committed May 21, 2015
1 parent 0eafb3a commit 0e021e0
Show file tree
Hide file tree
Showing 3 changed files with 58 additions and 9 deletions.
5 changes: 5 additions & 0 deletions CHANGELOG.md
View file
Original file line number Diff line number Diff line change
@@ -1,6 +1,11 @@
Unreleased Changes
------------------

* Feature - Aws::ElasticTranscoder - Elastic Transcoder now supports additional
formats, including MXF, FLAC, and OGA, and additional flexibility for your
output audio. You can use these formats to transcode files to the XDCAM format
or to a lossless audio format.

* Feature - Aws::Kinesis - The Amazon Kinesis API `#get_records` now includes a
new parameter `:millis_behind_latest`: the number of milliseconds the
GetRecords response is from the end of the stream, indicating how far behind
Expand Down
28 changes: 24 additions & 4 deletions aws-sdk-core/apis/elastictranscoder/2012-09-25/api-2.json
View file
Original file line number Diff line number Diff line change
Expand Up @@ -695,6 +695,14 @@
"type":"string",
"pattern":"(^auto$)|(^1:1$)|(^4:3$)|(^3:2$)|(^16:9$)"
},
"AudioBitDepth":{
"type":"string",
"pattern":"(^16$)|(^24$)"
},
"AudioBitOrder":{
"type":"string",
"pattern":"(^LittleEndian$)"
},
"AudioBitRate":{
"type":"string",
"pattern":"^\\d{1,3}$"
Expand All @@ -705,31 +713,43 @@
},
"AudioCodec":{
"type":"string",
"pattern":"(^AAC$)|(^vorbis$)|(^mp3$)|(^mp2$)"
"pattern":"(^AAC$)|(^vorbis$)|(^mp3$)|(^mp2$)|(^pcm$)|(^flac$)"
},
"AudioCodecOptions":{
"type":"structure",
"members":{
"Profile":{"shape":"AudioCodecProfile"}
"Profile":{"shape":"AudioCodecProfile"},
"BitDepth":{"shape":"AudioBitDepth"},
"BitOrder":{"shape":"AudioBitOrder"},
"Signed":{"shape":"AudioSigned"}
}
},
"AudioCodecProfile":{
"type":"string",
"pattern":"(^auto$)|(^AAC-LC$)|(^HE-AAC$)|(^HE-AACv2$)"
},
"AudioPackingMode":{
"type":"string",
"pattern":"(^SingleTrack$)|(^OneChannelPerTrack$)|(^OneChannelPerTrackWithMosTo8Tracks$)"
},
"AudioParameters":{
"type":"structure",
"members":{
"Codec":{"shape":"AudioCodec"},
"SampleRate":{"shape":"AudioSampleRate"},
"BitRate":{"shape":"AudioBitRate"},
"Channels":{"shape":"AudioChannels"},
"AudioPackingMode":{"shape":"AudioPackingMode"},
"CodecOptions":{"shape":"AudioCodecOptions"}
}
},
"AudioSampleRate":{
"type":"string",
"pattern":"(^auto$)|(^22050$)|(^32000$)|(^44100$)|(^48000$)|(^96000$)"
"pattern":"(^auto$)|(^22050$)|(^32000$)|(^44100$)|(^48000$)|(^96000$)|(^192000$)"
},
"AudioSigned":{
"type":"string",
"pattern":"(^Signed$)"
},
"Base64EncodedString":{
"type":"string",
Expand Down Expand Up @@ -1437,7 +1457,7 @@
},
"PresetContainer":{
"type":"string",
"pattern":"(^mp4$)|(^ts$)|(^webm$)|(^mp3$)|(^ogg$)|(^fmp4$)|(^mpg$)|(^flv$)|(^gif$)"
"pattern":"(^mp4$)|(^ts$)|(^webm$)|(^mp3$)|(^flac$)|(^oga$)|(^ogg$)|(^fmp4$)|(^mpg$)|(^flv$)|(^gif$)|(^mxf$)"
},
"PresetType":{
"type":"string",
Expand Down
34 changes: 29 additions & 5 deletions aws-sdk-core/apis/elastictranscoder/2012-09-25/docs-2.json
View file
Original file line number Diff line number Diff line change
Expand Up @@ -68,6 +68,18 @@
"VideoParameters$DisplayAspectRatio": "<p>The value that Elastic Transcoder adds to the metadata in the output file.</p>"
}
},
"AudioBitDepth": {
"base": null,
"refs": {
"AudioCodecOptions$BitDepth": "<p>You can only choose an audio bit depth when you specify <code>flac</code> or <code>pcm</code> for the value of Audio:Codec.</p> <p>The bit depth of a sample is how many bits of information are included in the audio samples. The higher the bit depth, the better the audio, but the larger the file.</p> <p>Valid values are <code>16</code> and <code>24</code>.</p> <p>The most common bit depth is <code>24</code>.</p>"
}
},
"AudioBitOrder": {
"base": null,
"refs": {
"AudioCodecOptions$BitOrder": "<p>You can only choose an audio bit order when you specify <code>pcm</code> for the value of Audio:Codec.</p> <p>The order the bits of a PCM sample are stored in.</p> <p>The supported value is <code>LittleEndian</code>.</p>"
}
},
"AudioBitRate": {
"base": null,
"refs": {
Expand All @@ -77,13 +89,13 @@
"AudioChannels": {
"base": null,
"refs": {
"AudioParameters$Channels": "<p>The number of audio channels in the output file. Valid values include:</p> <p><code>auto</code>, <code>0</code>, <code>1</code>, <code>2</code></p> <p>If you specify <code>auto</code>, Elastic Transcoder automatically detects the number of channels in the input file.</p>"
"AudioParameters$Channels": "<p>The number of audio channels in the output file. The following values are valid:</p> <p><code>auto</code>, <code>0</code>, <code>1</code>, <code>2</code></p> <p>One channel carries the information played by a single speaker. For example, a stereo track with two channels sends one channel to the left speaker, and the other channel to the right speaker. The output channels are organized into tracks. If you want Elastic Transcoder to automatically detect the number of audio channels in the input file and use that value for the output file, select <code>auto</code>.</p> <p>The output of a specific channel value and inputs are as follows:</p> <ul> <li> <code>auto</code><b> channel specified, with any input:</b> Pass through up to eight input channels.</li> <li> <code>0</code><b> channels specified, with any input:</b> Audio omitted from the output.</li> <li> <code>1</code><b> channel specified, with at least one input channel:</b> Mono sound.</li> <li> <code>2</code><b> channels specified, with any input:</b> Two identical mono channels or stereo. For more information about tracks, see <code>Audio:AudioPackingMode.</code> </li> </ul> <p> For more information about how Elastic Transcoder organizes channels and tracks, see <code>Audio:AudioPackingMode</code>.</p>"
}
},
"AudioCodec": {
"base": null,
"refs": {
"AudioParameters$Codec": "<p>The audio codec for the output file. Valid values include <code>aac</code>, <code>mp2</code>, <code>mp3</code>, and <code>vorbis</code>.</p>"
"AudioParameters$Codec": "<p>The audio codec for the output file. Valid values include <code>aac</code>, <code>flac</code>, <code>mp2</code>, <code>mp3</code>, <code>pcm</code>, and <code>vorbis</code>.</p>"
}
},
"AudioCodecOptions": {
Expand All @@ -98,6 +110,12 @@
"AudioCodecOptions$Profile": "<p>You can only choose an audio profile when you specify AAC for the value of Audio:Codec.</p> <p>Specify the AAC profile for the output file. Elastic Transcoder supports the following profiles:</p> <ul> <li> <code>auto</code>: If you specify <code>auto</code>, Elastic Transcoder will select the profile based on the bit rate selected for the output file.</li> <li> <code>AAC-LC</code>: The most common AAC profile. Use for bit rates larger than 64 kbps.</li> <li> <code>HE-AAC</code>: Not supported on some older players and devices. Use for bit rates between 40 and 80 kbps.</li> <li> <code>HE-AACv2</code>: Not supported on some players and devices. Use for bit rates less than 48 kbps.</li> </ul> <p>All outputs in a <code>Smooth</code> playlist must have the same value for <code>Profile</code>.</p> <note><p>If you created any presets before AAC profiles were added, Elastic Transcoder automatically updated your presets to use AAC-LC. You can change the value as required.</p></note>"
}
},
"AudioPackingMode": {
"base": null,
"refs": {
"AudioParameters$AudioPackingMode": "<p>The method of organizing audio channels and tracks. Use <code>Audio:Channels</code> to specify the number of channels in your output, and <code>Audio:AudioPackingMode</code> to specify the number of tracks and their relation to the channels. If you do not specify an <code>Audio:AudioPackingMode</code>, Elastic Transcoder uses <code>SingleTrack</code>.</p> <p>The following values are valid:</p> <p><code>SingleTrack</code>, <code>OneChannelPerTrack</code>, and <code>OneChannelPerTrackWithMosTo8Tracks</code></p> <p>When you specify <code>SingleTrack</code>, Elastic Transcoder creates a single track for your output. The track can have up to eight channels. Use <code>SingleTrack</code> for all non-<code>mxf</code> containers.</p> <p>The outputs of <code>SingleTrack</code> for a specific channel value and inputs are as follows:</p> <ul> <li> <code>0</code> <b> channels with any input:</b> Audio omitted from the output</li> <li> <code>1, 2, or auto </code> <b>channels with no audio input:</b> Audio omitted from the output</li> <li> <code>1 </code> <b>channel with any input with audio:</b> One track with one channel, downmixed if necessary</li> <li> <code>2 </code> <b>channels with one track with one channel:</b> One track with two identical channels</li> <li> <code>2 or auto </code> <b>channels with two tracks with one channel each:</b> One track with two channels</li> <li> <code>2 or auto </code> <b>channels with one track with two channels:</b> One track with two channels</li> <li> <code>2 </code> <b>channels with one track with multiple channels:</b> One track with two channels</li> <li> <code>auto </code> <b>channels with one track with one channel:</b> One track with one channel</li> <li> <code>auto </code> <b>channels with one track with multiple channels:</b> One track with multiple channels</li> </ul> <p>When you specify <code>OneChannelPerTrack</code>, Elastic Transcoder creates a new track for every channel in your output. Your output can have up to eight single-channel tracks.</p> <p>The outputs of <code>OneChannelPerTrack</code> for a specific channel value and inputs are as follows:</p> <ul> <li> <code>0 </code> <b>channels with any input:</b> Audio omitted from the output</li> <li> <code>1, 2, or auto </code> <b>channels with no audio input:</b> Audio omitted from the output</li> <li> <code>1 </code> <b>channel with any input with audio:</b> One track with one channel, downmixed if necessary</li> <li> <code>2 </code> <b>channels with one track with one channel:</b> Two tracks with one identical channel each</li> <li> <code>2 or auto </code> <b>channels with two tracks with one channel each:</b> Two tracks with one channel each</li> <li> <code>2 or auto </code> <b>channels with one track with two channels:</b> Two tracks with one channel each</li> <li> <code>2 </code> <b>channels with one track with multiple channels:</b> Two tracks with one channel each</li> <li> <code>auto </code> <b>channels with one track with one channel:</b> One track with one channel</li> <li> <code>auto </code> <b>channels with one track with multiple channels:</b> Up to eight tracks with one channel each</li> </ul> <p>When you specify <code>OneChannelPerTrackWithMosTo8Tracks</code>, Elastic Transcoder creates eight single-channel tracks for your output. All tracks that do not contain audio data from an input channel are MOS, or Mit Out Sound, tracks.</p> <p>The outputs of <code>OneChannelPerTrackWithMosTo8Tracks</code> for a specific channel value and inputs are as follows:</p> <ul> <li> <code>0 </code> <b>channels with any input:</b> Audio omitted from the output</li> <li> <code>1, 2, or auto </code> <b>channels with no audio input:</b> Audio omitted from the output</li> <li> <code>1 </code> <b>channel with any input with audio:</b> One track with one channel, downmixed if necessary, plus six MOS tracks</li> <li> <code>2 </code> <b>channels with one track with one channel:</b> Two tracks with one identical channel each, plus six MOS tracks</li> <li> <code>2 or auto </code> <b>channels with two tracks with one channel each:</b> Two tracks with one channel each, plus six MOS tracks</li> <li> <code>2 or auto </code> <b>channels with one track with two channels:</b> Two tracks with one channel each, plus six MOS tracks</li> <li> <code>2 </code> <b>channels with one track with multiple channels:</b> Two tracks with one channel each, plus six MOS tracks</li> <li> <code>auto </code> <b>channels with one track with one channel:</b> One track with one channel, plus seven MOS tracks</li> <li> <code>auto </code> <b>channels with one track with multiple channels:</b> Up to eight tracks with one channel each, plus MOS tracks until there are eight tracks in all</li> </ul>"
}
},
"AudioParameters": {
"base": "<p>Parameters required for transcoding audio.</p>",
"refs": {
Expand All @@ -111,6 +129,12 @@
"AudioParameters$SampleRate": "<p>The sample rate of the audio stream in the output file, in Hertz. Valid values include:</p> <p><code>auto</code>, <code>22050</code>, <code>32000</code>, <code>44100</code>, <code>48000</code>, <code>96000</code></p> <p>If you specify <code>auto</code>, Elastic Transcoder automatically detects the sample rate.</p>"
}
},
"AudioSigned": {
"base": null,
"refs": {
"AudioCodecOptions$Signed": "<p>You can only choose whether an audio sample is signed when you specify <code>pcm</code> for the value of Audio:Codec.</p> <p>Whether audio samples are represented with negative and positive numbers (signed) or only positive numbers (unsigned).</p> <p>The supported value is <code>Signed</code>.</p>"
}
},
"Base64EncodedString": {
"base": null,
"refs": {
Expand Down Expand Up @@ -152,7 +176,7 @@
"CaptionFormatFormat": {
"base": null,
"refs": {
"CaptionFormat$Format": "<p>The format you specify determines whether Elastic Transcoder generates an embedded or sidecar caption for this output.</p> <ul> <li> <p><b>Valid Embedded Caption Formats:</b></p> <ul> <li><p><b>For MP3</b>: None</p></li> <li><p><b>For MP4</b>: mov-text</p></li> <li><p><b>For MPEG-TS</b>: None</p></li> <li><p><b>For ogg</b>: None</p></li> <li><p><b>For webm</b>: None</p></li> </ul> </li> <li> <p><b>Valid Sidecar Caption Formats:</b> Elastic Transcoder supports dfxp (first div element only), scc, srt, and webvtt. If you want ttml or smpte-tt compatible captions, specify dfxp as your output format.</p> <ul> <li><p><b>For FMP4</b>: dfxp</p></li> <li><p><b>Non-FMP4 outputs</b>: All sidecar types</p></li> </ul> <p><code>fmp4</code> captions have an extension of <code>.ismt</code></p> </li> </ul>"
"CaptionFormat$Format": "<p>The format you specify determines whether Elastic Transcoder generates an embedded or sidecar caption for this output.</p> <ul> <li> <p><b>Valid Embedded Caption Formats:</b></p> <ul> <li><p><b>for FLAC</b>: None</p></li> <li><p><b>For MP3</b>: None</p></li> <li><p><b>For MP4</b>: mov-text</p></li> <li><p><b>For MPEG-TS</b>: None</p></li> <li><p><b>For ogg</b>: None</p></li> <li><p><b>For webm</b>: None</p></li> </ul> </li> <li> <p><b>Valid Sidecar Caption Formats:</b> Elastic Transcoder supports dfxp (first div element only), scc, srt, and webvtt. If you want ttml or smpte-tt compatible captions, specify dfxp as your output format.</p> <ul> <li><p><b>For FMP4</b>: dfxp</p></li> <li><p><b>Non-FMP4 outputs</b>: All sidecar types</p></li> </ul> <p><code>fmp4</code> captions have an extension of <code>.ismt</code></p> </li> </ul>"
}
},
"CaptionFormatPattern": {
Expand Down Expand Up @@ -805,8 +829,8 @@
"PresetContainer": {
"base": null,
"refs": {
"CreatePresetRequest$Container": "<p>The container type for the output file. Valid values include <code>flv</code>, <code>fmp4</code>, <code>gif</code>, <code>mp3</code>, <code>mp4</code>, <code>mpg</code>, <code>ogg</code>, <code>ts</code>, and <code>webm</code>.</p>",
"Preset$Container": "<p>The container type for the output file. Valid values include <code>flv</code>, <code>fmp4</code>, <code>gif</code>, <code>mp3</code>, <code>mp4</code>, <code>mpg</code>, <code>ogg</code>, <code>ts</code>, and <code>webm</code>.</p>"
"CreatePresetRequest$Container": "<p>The container type for the output file. Valid values include <code>flac</code>, <code>flv</code>, <code>fmp4</code>, <code>gif</code>, <code>mp3</code>, <code>mp4</code>, <code>mpg</code>, <code>mxf</code>, <code>oga</code>, <code>ogg</code>, <code>ts</code>, and <code>webm</code>.</p>",
"Preset$Container": "<p>The container type for the output file. Valid values include <code>flac</code>, <code>flv</code>, <code>fmp4</code>, <code>gif</code>, <code>mp3</code>, <code>mp4</code>, <code>mpg</code>, <code>mxf</code>, <code>oga</code>, <code>ogg</code>, <code>ts</code>, and <code>webm</code>.</p>"
}
},
"PresetType": {
Expand Down

0 comments on commit 0e021e0

Please sign in to comment.