This is the new *Amazon CloudFormation Template Reference Guide*. Please update your bookmarks and links. For help getting started with CloudFormation, see the [Amazon CloudFormation User Guide](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/Welcome.html).

# AWS::MediaLive::Channel AudioDescription
<a name="aws-properties-medialive-channel-audiodescription"></a>

The encoding information for one output audio.

The parent of this entity is EncoderSettings.

## Syntax
<a name="aws-properties-medialive-channel-audiodescription-syntax"></a>

To declare this entity in your Amazon CloudFormation template, use the following syntax:

### JSON
<a name="aws-properties-medialive-channel-audiodescription-syntax.json"></a>

```
{
  "[AudioDashRoles](#cfn-medialive-channel-audiodescription-audiodashroles)" : [ String, ... ],
  "[AudioNormalizationSettings](#cfn-medialive-channel-audiodescription-audionormalizationsettings)" : AudioNormalizationSettings,
  "[AudioSelectorName](#cfn-medialive-channel-audiodescription-audioselectorname)" : String,
  "[AudioType](#cfn-medialive-channel-audiodescription-audiotype)" : String,
  "[AudioTypeControl](#cfn-medialive-channel-audiodescription-audiotypecontrol)" : String,
  "[AudioWatermarkingSettings](#cfn-medialive-channel-audiodescription-audiowatermarkingsettings)" : AudioWatermarkSettings,
  "[CodecSettings](#cfn-medialive-channel-audiodescription-codecsettings)" : AudioCodecSettings,
  "[DvbDashAccessibility](#cfn-medialive-channel-audiodescription-dvbdashaccessibility)" : String,
  "[LanguageCode](#cfn-medialive-channel-audiodescription-languagecode)" : String,
  "[LanguageCodeControl](#cfn-medialive-channel-audiodescription-languagecodecontrol)" : String,
  "[Name](#cfn-medialive-channel-audiodescription-name)" : String,
  "[RemixSettings](#cfn-medialive-channel-audiodescription-remixsettings)" : RemixSettings,
  "[StreamName](#cfn-medialive-channel-audiodescription-streamname)" : String
}
```

### YAML
<a name="aws-properties-medialive-channel-audiodescription-syntax.yaml"></a>

```
  [AudioDashRoles](#cfn-medialive-channel-audiodescription-audiodashroles): 
    - String
  [AudioNormalizationSettings](#cfn-medialive-channel-audiodescription-audionormalizationsettings): 
    AudioNormalizationSettings
  [AudioSelectorName](#cfn-medialive-channel-audiodescription-audioselectorname): String
  [AudioType](#cfn-medialive-channel-audiodescription-audiotype): String
  [AudioTypeControl](#cfn-medialive-channel-audiodescription-audiotypecontrol): String
  [AudioWatermarkingSettings](#cfn-medialive-channel-audiodescription-audiowatermarkingsettings): 
    AudioWatermarkSettings
  [CodecSettings](#cfn-medialive-channel-audiodescription-codecsettings): 
    AudioCodecSettings
  [DvbDashAccessibility](#cfn-medialive-channel-audiodescription-dvbdashaccessibility): String
  [LanguageCode](#cfn-medialive-channel-audiodescription-languagecode): String
  [LanguageCodeControl](#cfn-medialive-channel-audiodescription-languagecodecontrol): String
  [Name](#cfn-medialive-channel-audiodescription-name): String
  [RemixSettings](#cfn-medialive-channel-audiodescription-remixsettings): 
    RemixSettings
  [StreamName](#cfn-medialive-channel-audiodescription-streamname): String
```

## Properties
<a name="aws-properties-medialive-channel-audiodescription-properties"></a>

`AudioDashRoles`  <a name="cfn-medialive-channel-audiodescription-audiodashroles"></a>
Property description not available.  
*Required*: No  
*Type*: Array of String  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`AudioNormalizationSettings`  <a name="cfn-medialive-channel-audiodescription-audionormalizationsettings"></a>
The advanced audio normalization settings.  
*Required*: No  
*Type*: [AudioNormalizationSettings](aws-properties-medialive-channel-audionormalizationsettings.md)  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`AudioSelectorName`  <a name="cfn-medialive-channel-audiodescription-audioselectorname"></a>
The name of the AudioSelector that is used as the source for this AudioDescription.  
*Required*: No  
*Type*: String  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`AudioType`  <a name="cfn-medialive-channel-audiodescription-audiotype"></a>
Applies only if audioTypeControl is useConfigured. The values for audioType are defined in ISO-IEC 13818-1.  
*Required*: No  
*Type*: String  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`AudioTypeControl`  <a name="cfn-medialive-channel-audiodescription-audiotypecontrol"></a>
Determines how audio type is determined. followInput: If the input contains an ISO 639 audioType, then that value is passed through to the output. If the input contains no ISO 639 audioType, the value in Audio Type is included in the output. useConfigured: The value in Audio Type is included in the output. Note that this field and audioType are both ignored if inputType is broadcasterMixedAd.  
*Required*: No  
*Type*: String  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`AudioWatermarkingSettings`  <a name="cfn-medialive-channel-audiodescription-audiowatermarkingsettings"></a>
Settings to configure one or more solutions that insert audio watermarks in the audio encode  
*Required*: No  
*Type*: [AudioWatermarkSettings](aws-properties-medialive-channel-audiowatermarksettings.md)  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`CodecSettings`  <a name="cfn-medialive-channel-audiodescription-codecsettings"></a>
The audio codec settings.  
*Required*: No  
*Type*: [AudioCodecSettings](aws-properties-medialive-channel-audiocodecsettings.md)  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`DvbDashAccessibility`  <a name="cfn-medialive-channel-audiodescription-dvbdashaccessibility"></a>
Property description not available.  
*Required*: No  
*Type*: String  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`LanguageCode`  <a name="cfn-medialive-channel-audiodescription-languagecode"></a>
Indicates the language of the audio output track. Used only if languageControlMode is useConfigured, or there is no ISO 639 language code specified in the input.  
*Required*: No  
*Type*: String  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`LanguageCodeControl`  <a name="cfn-medialive-channel-audiodescription-languagecodecontrol"></a>
Choosing followInput causes the ISO 639 language code of the output to follow the ISO 639 language code of the input. The languageCode setting is used when useConfigured is set, or when followInput is selected but there is no ISO 639 language code specified by the input.  
*Required*: No  
*Type*: String  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Name`  <a name="cfn-medialive-channel-audiodescription-name"></a>
The name of this AudioDescription. Outputs use this name to uniquely identify this AudioDescription. Description names should be unique within this channel.  
*Required*: No  
*Type*: String  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`RemixSettings`  <a name="cfn-medialive-channel-audiodescription-remixsettings"></a>
The settings that control how input audio channels are remixed into the output audio channels.  
*Required*: No  
*Type*: [RemixSettings](aws-properties-medialive-channel-remixsettings.md)  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`StreamName`  <a name="cfn-medialive-channel-audiodescription-streamname"></a>
Used for Microsoft Smooth and Apple HLS outputs. Indicates the name displayed by the player (for example, English or Director Commentary).  
*Required*: No  
*Type*: String  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)