Documentation

Overview

Package mediaconvert provides the client and types for making API requests to AWS Elemental MediaConvert.

AWS Elemental MediaConvert

See https://docs.aws.amazon.com/goto/WebAPI/mediaconvert-2017-08-29 for more information on this service.

See mediaconvert package documentation for more information. https://docs.aws.amazon.com/sdk-for-go/api/service/mediaconvert/

Using the Client

To contact AWS Elemental MediaConvert with the SDK use the New function to create a new service client. With that client you can make API requests to the service. These clients are safe to use concurrently.

See the SDK's documentation for more information on how to use the SDK. https://docs.aws.amazon.com/sdk-for-go/api/

See aws.Config documentation for more information on configuring SDK clients. https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config

See the AWS Elemental MediaConvert client MediaConvert for more information on creating client for this service. https://docs.aws.amazon.com/sdk-for-go/api/service/mediaconvert/#New

Index

Constants

View Source
const (
	// AacAudioDescriptionBroadcasterMixBroadcasterMixedAd is a AacAudioDescriptionBroadcasterMix enum value
	AacAudioDescriptionBroadcasterMixBroadcasterMixedAd = "BROADCASTER_MIXED_AD"

	// AacAudioDescriptionBroadcasterMixNormal is a AacAudioDescriptionBroadcasterMix enum value
	AacAudioDescriptionBroadcasterMixNormal = "NORMAL"
)

    Choose BROADCASTER_MIXED_AD when the input contains pre-mixed main audio + audio description (AD) as a stereo pair. The value for AudioType will be set to 3, which signals to downstream systems that this stream contains "broadcaster mixed AD". Note that the input received by the encoder must contain pre-mixed audio; the encoder does not perform the mixing. When you choose BROADCASTER_MIXED_AD, the encoder ignores any values you provide in AudioType and FollowInputAudioType. Choose NORMAL when the input does not contain pre-mixed audio + audio description (AD). In this case, the encoder will use any values you provide for AudioType and FollowInputAudioType.

    View Source
    const (
    	// AacCodecProfileLc is a AacCodecProfile enum value
    	AacCodecProfileLc = "LC"
    
    	// AacCodecProfileHev1 is a AacCodecProfile enum value
    	AacCodecProfileHev1 = "HEV1"
    
    	// AacCodecProfileHev2 is a AacCodecProfile enum value
    	AacCodecProfileHev2 = "HEV2"
    )

      AAC Profile.

      View Source
      const (
      	// AacCodingModeAdReceiverMix is a AacCodingMode enum value
      	AacCodingModeAdReceiverMix = "AD_RECEIVER_MIX"
      
      	// AacCodingModeCodingMode10 is a AacCodingMode enum value
      	AacCodingModeCodingMode10 = "CODING_MODE_1_0"
      
      	// AacCodingModeCodingMode11 is a AacCodingMode enum value
      	AacCodingModeCodingMode11 = "CODING_MODE_1_1"
      
      	// AacCodingModeCodingMode20 is a AacCodingMode enum value
      	AacCodingModeCodingMode20 = "CODING_MODE_2_0"
      
      	// AacCodingModeCodingMode51 is a AacCodingMode enum value
      	AacCodingModeCodingMode51 = "CODING_MODE_5_1"
      )

        Mono (Audio Description), Mono, Stereo, or 5.1 channel layout. Valid values depend on rate control mode and profile. "1.0 - Audio Description (Receiver Mix)" setting receives a stereo description plus control track and emits a mono AAC encode of the description track, with control data emitted in the PES header as per ETSI TS 101 154 Annex E.

        View Source
        const (
        	// AacRateControlModeCbr is a AacRateControlMode enum value
        	AacRateControlModeCbr = "CBR"
        
        	// AacRateControlModeVbr is a AacRateControlMode enum value
        	AacRateControlModeVbr = "VBR"
        )

          Rate Control Mode.

          View Source
          const (
          	// AacRawFormatLatmLoas is a AacRawFormat enum value
          	AacRawFormatLatmLoas = "LATM_LOAS"
          
          	// AacRawFormatNone is a AacRawFormat enum value
          	AacRawFormatNone = "NONE"
          )

            Enables LATM/LOAS AAC output. Note that if you use LATM/LOAS AAC in an output, you must choose "No container" for the output container.

            View Source
            const (
            	// AacSpecificationMpeg2 is a AacSpecification enum value
            	AacSpecificationMpeg2 = "MPEG2"
            
            	// AacSpecificationMpeg4 is a AacSpecification enum value
            	AacSpecificationMpeg4 = "MPEG4"
            )

              Use MPEG-2 AAC instead of MPEG-4 AAC audio for raw or MPEG-2 Transport Stream containers.

              View Source
              const (
              	// AacVbrQualityLow is a AacVbrQuality enum value
              	AacVbrQualityLow = "LOW"
              
              	// AacVbrQualityMediumLow is a AacVbrQuality enum value
              	AacVbrQualityMediumLow = "MEDIUM_LOW"
              
              	// AacVbrQualityMediumHigh is a AacVbrQuality enum value
              	AacVbrQualityMediumHigh = "MEDIUM_HIGH"
              
              	// AacVbrQualityHigh is a AacVbrQuality enum value
              	AacVbrQualityHigh = "HIGH"
              )

                VBR Quality Level - Only used if rate_control_mode is VBR.

                View Source
                const (
                	// Ac3BitstreamModeCompleteMain is a Ac3BitstreamMode enum value
                	Ac3BitstreamModeCompleteMain = "COMPLETE_MAIN"
                
                	// Ac3BitstreamModeCommentary is a Ac3BitstreamMode enum value
                	Ac3BitstreamModeCommentary = "COMMENTARY"
                
                	// Ac3BitstreamModeDialogue is a Ac3BitstreamMode enum value
                	Ac3BitstreamModeDialogue = "DIALOGUE"
                
                	// Ac3BitstreamModeEmergency is a Ac3BitstreamMode enum value
                	Ac3BitstreamModeEmergency = "EMERGENCY"
                
                	// Ac3BitstreamModeHearingImpaired is a Ac3BitstreamMode enum value
                	Ac3BitstreamModeHearingImpaired = "HEARING_IMPAIRED"
                
                	// Ac3BitstreamModeMusicAndEffects is a Ac3BitstreamMode enum value
                	Ac3BitstreamModeMusicAndEffects = "MUSIC_AND_EFFECTS"
                
                	// Ac3BitstreamModeVisuallyImpaired is a Ac3BitstreamMode enum value
                	Ac3BitstreamModeVisuallyImpaired = "VISUALLY_IMPAIRED"
                
                	// Ac3BitstreamModeVoiceOver is a Ac3BitstreamMode enum value
                	Ac3BitstreamModeVoiceOver = "VOICE_OVER"
                )

                  Specify the bitstream mode for the AC-3 stream that the encoder emits. For more information about the AC3 bitstream mode, see ATSC A/52-2012 (Annex E).

                  View Source
                  const (
                  	// Ac3CodingModeCodingMode10 is a Ac3CodingMode enum value
                  	Ac3CodingModeCodingMode10 = "CODING_MODE_1_0"
                  
                  	// Ac3CodingModeCodingMode11 is a Ac3CodingMode enum value
                  	Ac3CodingModeCodingMode11 = "CODING_MODE_1_1"
                  
                  	// Ac3CodingModeCodingMode20 is a Ac3CodingMode enum value
                  	Ac3CodingModeCodingMode20 = "CODING_MODE_2_0"
                  
                  	// Ac3CodingModeCodingMode32Lfe is a Ac3CodingMode enum value
                  	Ac3CodingModeCodingMode32Lfe = "CODING_MODE_3_2_LFE"
                  )

                    Dolby Digital coding mode. Determines number of channels.

                    View Source
                    const (
                    	// Ac3DynamicRangeCompressionProfileFilmStandard is a Ac3DynamicRangeCompressionProfile enum value
                    	Ac3DynamicRangeCompressionProfileFilmStandard = "FILM_STANDARD"
                    
                    	// Ac3DynamicRangeCompressionProfileNone is a Ac3DynamicRangeCompressionProfile enum value
                    	Ac3DynamicRangeCompressionProfileNone = "NONE"
                    )

                      If set to FILM_STANDARD, adds dynamic range compression signaling to the output bitstream as defined in the Dolby Digital specification.

                      View Source
                      const (
                      	// Ac3LfeFilterEnabled is a Ac3LfeFilter enum value
                      	Ac3LfeFilterEnabled = "ENABLED"
                      
                      	// Ac3LfeFilterDisabled is a Ac3LfeFilter enum value
                      	Ac3LfeFilterDisabled = "DISABLED"
                      )

                        Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode.

                        View Source
                        const (
                        	// Ac3MetadataControlFollowInput is a Ac3MetadataControl enum value
                        	Ac3MetadataControlFollowInput = "FOLLOW_INPUT"
                        
                        	// Ac3MetadataControlUseConfigured is a Ac3MetadataControl enum value
                        	Ac3MetadataControlUseConfigured = "USE_CONFIGURED"
                        )

                          When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used.

                          View Source
                          const (
                          	// AccelerationModeDisabled is a AccelerationMode enum value
                          	AccelerationModeDisabled = "DISABLED"
                          
                          	// AccelerationModeEnabled is a AccelerationMode enum value
                          	AccelerationModeEnabled = "ENABLED"
                          
                          	// AccelerationModePreferred is a AccelerationMode enum value
                          	AccelerationModePreferred = "PREFERRED"
                          )

                            Specify whether the service runs your job with accelerated transcoding. Choose DISABLED if you don't want accelerated transcoding. Choose ENABLED if you want your job to run with accelerated transcoding and to fail if your input files or your job settings aren't compatible with accelerated transcoding. Choose PREFERRED if you want your job to run with accelerated transcoding if the job is compatible with the feature and to run at standard speed if it's not.

                            View Source
                            const (
                            	// AccelerationStatusNotApplicable is a AccelerationStatus enum value
                            	AccelerationStatusNotApplicable = "NOT_APPLICABLE"
                            
                            	// AccelerationStatusInProgress is a AccelerationStatus enum value
                            	AccelerationStatusInProgress = "IN_PROGRESS"
                            
                            	// AccelerationStatusAccelerated is a AccelerationStatus enum value
                            	AccelerationStatusAccelerated = "ACCELERATED"
                            
                            	// AccelerationStatusNotAccelerated is a AccelerationStatus enum value
                            	AccelerationStatusNotAccelerated = "NOT_ACCELERATED"
                            )

                              Describes whether the current job is running with accelerated transcoding. For jobs that have Acceleration (AccelerationMode) set to DISABLED, AccelerationStatus is always NOT_APPLICABLE. For jobs that have Acceleration (AccelerationMode) set to ENABLED or PREFERRED, AccelerationStatus is one of the other states. AccelerationStatus is IN_PROGRESS initially, while the service determines whether the input files and job settings are compatible with accelerated transcoding. If they are, AcclerationStatus is ACCELERATED. If your input files and job settings aren't compatible with accelerated transcoding, the service either fails your job or runs it without accelerated transcoding, depending on how you set Acceleration (AccelerationMode). When the service runs your job without accelerated transcoding, AccelerationStatus is NOT_ACCELERATED.

                              View Source
                              const (
                              	// AfdSignalingNone is a AfdSignaling enum value
                              	AfdSignalingNone = "NONE"
                              
                              	// AfdSignalingAuto is a AfdSignaling enum value
                              	AfdSignalingAuto = "AUTO"
                              
                              	// AfdSignalingFixed is a AfdSignaling enum value
                              	AfdSignalingFixed = "FIXED"
                              )

                                This setting only applies to H.264, H.265, and MPEG2 outputs. Use Insert AFD signaling (AfdSignaling) to specify whether the service includes AFD values in the output video data and what those values are. * Choose None to remove all AFD values from this output. * Choose Fixed to ignore input AFD values and instead encode the value specified in the job. * Choose Auto to calculate output AFD values based on the input AFD scaler data.

                                View Source
                                const (
                                	// AlphaBehaviorDiscard is a AlphaBehavior enum value
                                	AlphaBehaviorDiscard = "DISCARD"
                                
                                	// AlphaBehaviorRemapToLuma is a AlphaBehavior enum value
                                	AlphaBehaviorRemapToLuma = "REMAP_TO_LUMA"
                                )

                                  Ignore this setting unless this input is a QuickTime animation with an alpha channel. Use this setting to create separate Key and Fill outputs. In each output, specify which part of the input MediaConvert uses. Leave this setting at the default value DISCARD to delete the alpha channel and preserve the video. Set it to REMAP_TO_LUMA to delete the video and map the alpha channel to the luma channel of your outputs.

                                  View Source
                                  const (
                                  	// AncillaryConvert608To708Upconvert is a AncillaryConvert608To708 enum value
                                  	AncillaryConvert608To708Upconvert = "UPCONVERT"
                                  
                                  	// AncillaryConvert608To708Disabled is a AncillaryConvert608To708 enum value
                                  	AncillaryConvert608To708Disabled = "DISABLED"
                                  )

                                    Specify whether this set of input captions appears in your outputs in both 608 and 708 format. If you choose Upconvert (UPCONVERT), MediaConvert includes the captions data in two ways: it passes the 608 data through using the 608 compatibility bytes fields of the 708 wrapper, and it also translates the 608 data into 708.

                                    View Source
                                    const (
                                    	// AncillaryTerminateCaptionsEndOfInput is a AncillaryTerminateCaptions enum value
                                    	AncillaryTerminateCaptionsEndOfInput = "END_OF_INPUT"
                                    
                                    	// AncillaryTerminateCaptionsDisabled is a AncillaryTerminateCaptions enum value
                                    	AncillaryTerminateCaptionsDisabled = "DISABLED"
                                    )

                                      By default, the service terminates any unterminated captions at the end of each input. If you want the caption to continue onto your next input, disable this setting.

                                      View Source
                                      const (
                                      	// AntiAliasDisabled is a AntiAlias enum value
                                      	AntiAliasDisabled = "DISABLED"
                                      
                                      	// AntiAliasEnabled is a AntiAlias enum value
                                      	AntiAliasEnabled = "ENABLED"
                                      )

                                        The anti-alias filter is automatically applied to all outputs. The service no longer accepts the value DISABLED for AntiAlias. If you specify that in your job, the service will ignore the setting.

                                        View Source
                                        const (
                                        	// AudioCodecAac is a AudioCodec enum value
                                        	AudioCodecAac = "AAC"
                                        
                                        	// AudioCodecMp2 is a AudioCodec enum value
                                        	AudioCodecMp2 = "MP2"
                                        
                                        	// AudioCodecMp3 is a AudioCodec enum value
                                        	AudioCodecMp3 = "MP3"
                                        
                                        	// AudioCodecWav is a AudioCodec enum value
                                        	AudioCodecWav = "WAV"
                                        
                                        	// AudioCodecAiff is a AudioCodec enum value
                                        	AudioCodecAiff = "AIFF"
                                        
                                        	// AudioCodecAc3 is a AudioCodec enum value
                                        	AudioCodecAc3 = "AC3"
                                        
                                        	// AudioCodecEac3 is a AudioCodec enum value
                                        	AudioCodecEac3 = "EAC3"
                                        
                                        	// AudioCodecEac3Atmos is a AudioCodec enum value
                                        	AudioCodecEac3Atmos = "EAC3_ATMOS"
                                        
                                        	// AudioCodecVorbis is a AudioCodec enum value
                                        	AudioCodecVorbis = "VORBIS"
                                        
                                        	// AudioCodecOpus is a AudioCodec enum value
                                        	AudioCodecOpus = "OPUS"
                                        
                                        	// AudioCodecPassthrough is a AudioCodec enum value
                                        	AudioCodecPassthrough = "PASSTHROUGH"
                                        )

                                          Type of Audio codec.

                                          View Source
                                          const (
                                          	// AudioDefaultSelectionDefault is a AudioDefaultSelection enum value
                                          	AudioDefaultSelectionDefault = "DEFAULT"
                                          
                                          	// AudioDefaultSelectionNotDefault is a AudioDefaultSelection enum value
                                          	AudioDefaultSelectionNotDefault = "NOT_DEFAULT"
                                          )

                                            Enable this setting on one audio selector to set it as the default for the job. The service uses this default for outputs where it can't find the specified input audio. If you don't set a default, those outputs have no audio.

                                            View Source
                                            const (
                                            	// AudioLanguageCodeControlFollowInput is a AudioLanguageCodeControl enum value
                                            	AudioLanguageCodeControlFollowInput = "FOLLOW_INPUT"
                                            
                                            	// AudioLanguageCodeControlUseConfigured is a AudioLanguageCodeControl enum value
                                            	AudioLanguageCodeControlUseConfigured = "USE_CONFIGURED"
                                            )

                                              Specify which source for language code takes precedence for this audio track. When you choose Follow input (FOLLOW_INPUT), the service uses the language code from the input track if it's present. If there's no languge code on the input track, the service uses the code that you specify in the setting Language code (languageCode or customLanguageCode). When you choose Use configured (USE_CONFIGURED), the service uses the language code that you specify.

                                              View Source
                                              const (
                                              	// AudioNormalizationAlgorithmItuBs17701 is a AudioNormalizationAlgorithm enum value
                                              	AudioNormalizationAlgorithmItuBs17701 = "ITU_BS_1770_1"
                                              
                                              	// AudioNormalizationAlgorithmItuBs17702 is a AudioNormalizationAlgorithm enum value
                                              	AudioNormalizationAlgorithmItuBs17702 = "ITU_BS_1770_2"
                                              
                                              	// AudioNormalizationAlgorithmItuBs17703 is a AudioNormalizationAlgorithm enum value
                                              	AudioNormalizationAlgorithmItuBs17703 = "ITU_BS_1770_3"
                                              
                                              	// AudioNormalizationAlgorithmItuBs17704 is a AudioNormalizationAlgorithm enum value
                                              	AudioNormalizationAlgorithmItuBs17704 = "ITU_BS_1770_4"
                                              )

                                                Choose one of the following audio normalization algorithms: ITU-R BS.1770-1: Ungated loudness. A measurement of ungated average loudness for an entire piece of content, suitable for measurement of short-form content under ATSC recommendation A/85. Supports up to 5.1 audio channels. ITU-R BS.1770-2: Gated loudness. A measurement of gated average loudness compliant with the requirements of EBU-R128. Supports up to 5.1 audio channels. ITU-R BS.1770-3: Modified peak. The same loudness measurement algorithm as 1770-2, with an updated true peak measurement. ITU-R BS.1770-4: Higher channel count. Allows for more audio channels than the other algorithms, including configurations such as 7.1.

                                                View Source
                                                const (
                                                	// AudioNormalizationAlgorithmControlCorrectAudio is a AudioNormalizationAlgorithmControl enum value
                                                	AudioNormalizationAlgorithmControlCorrectAudio = "CORRECT_AUDIO"
                                                
                                                	// AudioNormalizationAlgorithmControlMeasureOnly is a AudioNormalizationAlgorithmControl enum value
                                                	AudioNormalizationAlgorithmControlMeasureOnly = "MEASURE_ONLY"
                                                )

                                                  When enabled the output audio is corrected using the chosen algorithm. If disabled, the audio will be measured but not adjusted.

                                                  View Source
                                                  const (
                                                  	// AudioNormalizationLoudnessLoggingLog is a AudioNormalizationLoudnessLogging enum value
                                                  	AudioNormalizationLoudnessLoggingLog = "LOG"
                                                  
                                                  	// AudioNormalizationLoudnessLoggingDontLog is a AudioNormalizationLoudnessLogging enum value
                                                  	AudioNormalizationLoudnessLoggingDontLog = "DONT_LOG"
                                                  )

                                                    If set to LOG, log each output's audio track loudness to a CSV file.

                                                    View Source
                                                    const (
                                                    	// AudioNormalizationPeakCalculationTruePeak is a AudioNormalizationPeakCalculation enum value
                                                    	AudioNormalizationPeakCalculationTruePeak = "TRUE_PEAK"
                                                    
                                                    	// AudioNormalizationPeakCalculationNone is a AudioNormalizationPeakCalculation enum value
                                                    	AudioNormalizationPeakCalculationNone = "NONE"
                                                    )

                                                      If set to TRUE_PEAK, calculate and log the TruePeak for each output's audio track loudness.

                                                      View Source
                                                      const (
                                                      	// AudioSelectorTypePid is a AudioSelectorType enum value
                                                      	AudioSelectorTypePid = "PID"
                                                      
                                                      	// AudioSelectorTypeTrack is a AudioSelectorType enum value
                                                      	AudioSelectorTypeTrack = "TRACK"
                                                      
                                                      	// AudioSelectorTypeLanguageCode is a AudioSelectorType enum value
                                                      	AudioSelectorTypeLanguageCode = "LANGUAGE_CODE"
                                                      )

                                                        Specifies the type of the audio selector.

                                                        View Source
                                                        const (
                                                        	// AudioTypeControlFollowInput is a AudioTypeControl enum value
                                                        	AudioTypeControlFollowInput = "FOLLOW_INPUT"
                                                        
                                                        	// AudioTypeControlUseConfigured is a AudioTypeControl enum value
                                                        	AudioTypeControlUseConfigured = "USE_CONFIGURED"
                                                        )

                                                          When set to FOLLOW_INPUT, if the input contains an ISO 639 audio_type, then that value is passed through to the output. If the input contains no ISO 639 audio_type, the value in Audio Type is included in the output. Otherwise the value in Audio Type is included in the output. Note that this field and audioType are both ignored if audioDescriptionBroadcasterMix is set to BROADCAST