本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# SynthesisTask
<a name="API_SynthesisTask"></a>

SynthesisTask 物件，可提供語音合成任務的相關資訊。

## 目錄
<a name="API_SynthesisTask_Contents"></a>

 ** CreationTime **   <a name="polly-Type-SynthesisTask-CreationTime"></a>
合成任務啟動時間的時間戳記。  
類型：Timestamp  
必要：否

 ** Engine **   <a name="polly-Type-SynthesisTask-Engine"></a>
指定 Amazon Polly 在處理語音合成的輸入文字時要使用的引擎 (`standard``neural`、 `long-form`或 `generative`)。使用所選引擎不支援的語音會導致錯誤。  
類型：字串  
有效值:`standard | neural | long-form | generative`   
必要：否

 ** LanguageCode **   <a name="polly-Type-SynthesisTask-LanguageCode"></a>
合成任務的選用語言程式碼。只有在使用 Aditi 等雙語語音時，才需要此語音，可用於印度英文 (en-IN) 或印地文 (hi-IN)。  
如果使用雙語語音且未指定語言代碼，Amazon Polly 會使用雙語語音的預設語言。任何語音的預設語言都是 [DescribeVoices](https://docs.aws.amazon.com/polly/latest/dg/API_DescribeVoices.html) 操作針對 `LanguageCode` 參數傳回的語言。例如，如果未指定語言代碼，Aditi 將使用印度英文，而不是印地文。  
類型：字串  
有效值:`arb | cmn-CN | cy-GB | da-DK | de-DE | en-AU | en-GB | en-GB-WLS | en-IN | en-US | es-ES | es-MX | es-US | fr-CA | fr-FR | is-IS | it-IT | ja-JP | hi-IN | ko-KR | nb-NO | nl-NL | pl-PL | pt-BR | pt-PT | ro-RO | ru-RU | sv-SE | tr-TR | en-NZ | en-ZA | ca-ES | de-AT | yue-CN | ar-AE | fi-FI | en-IE | nl-BE | fr-BE | cs-CZ | de-CH | en-SG`   
必要：否

 ** LexiconNames **   <a name="polly-Type-SynthesisTask-LexiconNames"></a>
您希望服務在合成期間套用的一或多個發音語彙名稱清單。只有在語彙的語言與語音的語言相同時，才會套用語彙。  
類型：字串陣列  
陣列成員：最多 5 個項目。  
模式：`[0-9A-Za-z]{1,20}`  
必要：否

 ** OutputFormat **   <a name="polly-Type-SynthesisTask-OutputFormat"></a>
將編碼傳回輸出的格式。對於音訊串流，這會是 mp3、ogg\$1vorbis、ogg\$1opus、mu-law、a-law 或 pcm。對於語音標記，這會是 json。  
類型：字串  
有效值:`json | mp3 | ogg_opus | ogg_vorbis | pcm`   
必要：否

 ** OutputUri **   <a name="polly-Type-SynthesisTask-OutputUri"></a>
輸出語音檔案的路徑。  
類型：字串  
必要：否

 ** RequestCharacters **   <a name="polly-Type-SynthesisTask-RequestCharacters"></a>
合成的計費字元數。  
類型：整數  
必要：否

 ** SampleRate **   <a name="polly-Type-SynthesisTask-SampleRate"></a>
以 Hz 指定的音訊頻率。  
mp3 和 ogg\$1vorbis 的有效值為 "8000"、"16000"、"22050" 和 "24000"。標準語音的預設值為「22050」。神經語音的預設值為「24000」。長格式語音的預設值為「24000」。生成語音的預設值為「24000」。  
pcm 的有效值為 "8000" 和 "16000" 預設值為 "16000"。  
ogg\$1opus 的有效值為 "48000"。  
mu-law 和 a-law 的有效值為 "8000"。  
類型：字串  
必要：否

 ** SnsTopicArn **   <a name="polly-Type-SynthesisTask-SnsTopicArn"></a>
SNS 主題的 ARN，選擇性用於為語音合成任務提供狀態通知。  
類型：字串  
模式：`^arn:aws(-(cn|iso(-b)?|us-gov))?:sns:[a-z0-9_-]{1,50}:\d{12}:[a-zA-Z0-9_-]{1,251}([a-zA-Z0-9_-]{0,5}|\.fifo)$`  
必要：否

 ** SpeechMarkTypes **   <a name="polly-Type-SynthesisTask-SpeechMarkTypes"></a>
針對輸入文字傳回的語音標記類型。  
類型：字串陣列  
陣列成員：最多 4 個項目。  
有效值:`sentence | ssml | viseme | word`   
必要：否

 ** TaskId **   <a name="polly-Type-SynthesisTask-TaskId"></a>
Amazon Polly 為語音合成任務產生的識別符。  
類型：字串  
模式：`^[a-zA-Z0-9_-]{1,100}$`  
必要：否

 ** TaskStatus **   <a name="polly-Type-SynthesisTask-TaskStatus"></a>
個別語音合成任務的目前狀態。  
類型：字串  
有效值:`scheduled | inProgress | completed | failed`   
必要：否

 ** TaskStatusReason **   <a name="polly-Type-SynthesisTask-TaskStatusReason"></a>
特定語音合成任務目前狀態的原因，包括任務失敗時的錯誤。  
類型：字串  
必要：否

 ** TextType **   <a name="polly-Type-SynthesisTask-TextType"></a>
指定輸入文字是純文字還是 SSML。預設值為純文字。  
類型：字串  
有效值:`ssml | text`   
必要：否

 ** VoiceId **   <a name="polly-Type-SynthesisTask-VoiceId"></a>
用於合成的語音 ID。  
類型：字串  
有效值:`Aditi | Amy | Astrid | Bianca | Brian | Camila | Carla | Carmen | Celine | Chantal | Conchita | Cristiano | Dora | Emma | Enrique | Ewa | Filiz | Gabrielle | Geraint | Giorgio | Gwyneth | Hans | Ines | Ivy | Jacek | Jan | Joanna | Joey | Justin | Karl | Kendra | Kevin | Kimberly | Lea | Liv | Lotte | Lucia | Lupe | Mads | Maja | Marlene | Mathieu | Matthew | Maxim | Mia | Miguel | Mizuki | Naja | Nicole | Olivia | Penelope | Raveena | Ricardo | Ruben | Russell | Salli | Seoyeon | Takumi | Tatyana | Vicki | Vitoria | Zeina | Zhiyu | Aria | Ayanda | Arlet | Hannah | Arthur | Daniel | Liam | Pedro | Kajal | Hiujin | Laura | Elin | Ida | Suvi | Ola | Hala | Andres | Sergio | Remi | Adriano | Thiago | Ruth | Stephen | Kazuha | Tomoko | Niamh | Sofie | Lisa | Isabelle | Zayd | Danielle | Gregory | Burcu | Jitka | Sabrina | Jasmine | Jihye | Ambre | Beatrice | Florian | Lennart | Lorenzo | Tiffany`   
必要：否

## 另請參閱
<a name="API_SynthesisTask_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/SynthesisTask) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/SynthesisTask) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/SynthesisTask)