本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# Settings
<a name="API_Settings"></a>

允许在您的[StartTranscriptionJob](API_StartTranscriptionJob.md)请求中添加其他可选设置，包括频道识别、替代转录和扬声器分区。你可以用它来将自定义词汇应用到你的转录工作中。

## 目录
<a name="API_Settings_Contents"></a>

 ** ChannelIdentification **   <a name="transcribe-Type-Settings-ChannelIdentification"></a>
在多声道音频中启用频道识别。  
频道识别可单独转录每个通道上的音频，然后将每个通道的输出附加到一个脚本中。  
您不能在同一个请求`ChannelIdentification`中同时包含`ShowSpeakerLabels`和。包含这两个参数将返回 a`BadRequestException`。  
有关更多信息，请参阅[转录多声道音频](https://docs.aws.amazon.com/transcribe/latest/dg/channel-id.html)。  
类型：布尔值  
必需：否

 ** MaxAlternatives **   <a name="transcribe-Type-Settings-MaxAlternatives"></a>
指明您希望 Amazon Transcribe 在成绩单中包含的替代转录的最大数量。  
如果您选择的数字大于 Amazon Transcribe 生成的替代转录数量，则仅包括替代转录的实际数量。  
如果您在请求`MaxAlternatives`中包含，则还必须`ShowAlternatives`包含值为`true`。  
有关更多信息，请参阅 “[替代转录”](https://docs.aws.amazon.com/transcribe/latest/dg/how-alternatives.html)。  
类型：整数  
有效范围：最小值为 2。最大值为 10。  
必需：否

 ** MaxSpeakerLabels **   <a name="transcribe-Type-Settings-MaxSpeakerLabels"></a>
指定要在媒体中分区的最大扬声器数量。  
请注意，如果您的媒体包含的扬声器数量超过指定数量，则多个扬声器将被视为单个扬声器。  
如果指定`MaxSpeakerLabels`字段，则必须将该`ShowSpeakerLabels`字段设置为 true。  
类型：整数  
有效范围：最小值为 2。最大值为 10。  
必需：否

 ** ShowAlternatives **   <a name="transcribe-Type-Settings-ShowAlternatives"></a>
要在转录输出中包含替代转录，请在转录请求`ShowAlternatives`中包含替代转录。  
如果您有多声道音频但未启用频道识别，则您的音频会以连续的方式转录，并且您的脚本不会按频道分隔语音。  
如果包括`ShowAlternatives`，则还必须包括`MaxAlternatives`，这是您希望 Amazon Transcribe 生成的最大替代转录数量。  
有关更多信息，请参阅 “[替代转录”](https://docs.aws.amazon.com/transcribe/latest/dg/how-alternatives.html)。  
类型：布尔值  
必需：否

 ** ShowSpeakerLabels **   <a name="transcribe-Type-Settings-ShowSpeakerLabels"></a>
在转录输出中启用扬声器分区（分音）。扬声器分区会标记媒体文件中单个扬声器的语音。  
如果您在请求`ShowSpeakerLabels`中启用，则还必须包括`MaxSpeakerLabels`。  
您不能在同一个请求`ChannelIdentification`中同时包含`ShowSpeakerLabels`和。包含这两个参数将返回 a`BadRequestException`。  
有关更多信息，请参阅 “对[扬声器进行分区（二维分区）](https://docs.aws.amazon.com/transcribe/latest/dg/diarization.html)”。  
类型：布尔值  
必需：否

 ** VocabularyFilterMethod **   <a name="transcribe-Type-Settings-VocabularyFilterMethod"></a>
指定您希望如何将自定义词汇过滤器应用于成绩单。  
要将单词替换为`***`，请选择`mask`。  
要删除字词，请选择`remove`。  
要标记单词而不对其进行更改，请选择`tag`。  
类型：字符串  
有效值:` remove | mask | tag`   
必需：否

 ** VocabularyFilterName **   <a name="transcribe-Type-Settings-VocabularyFilterName"></a>
您要在转录任务请求中使用的自定义词汇过滤器的名称。此名称区分大小写，不能包含空格，并且在中必须是唯一的AWS 账户。  
请注意，如果您在请求`VocabularyFilterName`中包含，则还必须包括`VocabularyFilterMethod`。  
类型：字符串  
长度限制：最小长度为 1。最大长度为 200。  
模式：`^[0-9a-zA-Z._-]+`  
必需：否

 ** VocabularyName **   <a name="transcribe-Type-Settings-VocabularyName"></a>
要在转录任务请求中使用的自定义词汇的名称。此名称区分大小写，不能包含空格，并且在中必须是唯一的AWS 账户。  
类型：字符串  
长度限制：最小长度为 1。最大长度为 200。  
模式：`^[0-9a-zA-Z._-]+`  
必需：否

## 另请参阅
<a name="API_Settings_SeeAlso"></a>

有关在特定语言的 AWS 软件开发工具包中使用此 API 的更多信息，请参阅以下内容：
+  [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/Settings) 
+  [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-2017-10-26/Settings) 
+  [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-2017-10-26/Settings) 
+  [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/Settings)