Plum DEV Documentation
developer_reference:tts

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
developer_reference:tts [2020/02/28 12:32]
admin
developer_reference:tts [2020/02/28 14:10] (current)
admin
Line 210: Line 210:
  
 ## These voices can be used with both the Conversational and Newscaster speaking styles when used with the Neural format. For more information,​ see NTTS Speaking Styles [[https://​docs.aws.amazon.com/​polly/​latest/​dg/​ntts-speakingstyles.html]]. ## These voices can be used with both the Conversational and Newscaster speaking styles when used with the Neural format. For more information,​ see NTTS Speaking Styles [[https://​docs.aws.amazon.com/​polly/​latest/​dg/​ntts-speakingstyles.html]].
 +
 +==== Voice Selection for Polly ====
 +
 +If the Amazon Polly TTS is specified, and neither a <​speak>​ nor <​voice>​ tag are specified, ​ Plum Voice uses the en_US, standard, female voice Joanna by default.
 +
 +=== <​speak>​ ===
 +
 +The <​speak>​ tag should be used to specify the desired language through the attribute xml:​lang=”//​lg-CN//​”,​ where //lg-CN// is the language-country pair specified in the Language column from that table of supported languages here: https://​docs.aws.amazon.com/​polly/​latest/​dg/​voicelist.html. ​
 +
 +Please note that each voice has an associated language. Selecting a language that is not associated with the voice will result in unpredictable behavior; however, in many cases, you will hear the language the text was written in accented by that voice’s associated language.
 +
 +=== <​voice>​ ===
 +
 +The <​voice>​ tag should be used to specify the desired voice through the attribute name=”//​name//​”,​ where //name// is the voice specified in the Name/ID column for the table of supported voices here: https://​docs.aws.amazon.com/​polly/​latest/​dg/​voicelist.html.
 +
 +Within the <​voice>​ tag the attribute variant=”//​number//​” should be used to specify whether a standard voice (variant=1) or neural voice (variant=2) is desired. ​ \\
 +\\
 +Note that only certain voices support the neural option. ​ See: [[https://​docs.aws.amazon.com/​polly/​latest/​dg/​voicelist.html]] for a list of voices that support neural, and [[https://​docs.aws.amazon.com/​polly/​latest/​dg/​NTTS-main.html]] for the differences between standard and neural voices.
 +
 +If another voice is desired, it should specified using the <​speak>​ and <​voice>​ tags as follows within the prompt block: ​
 +
 +<​code>​
 +<?xml version="​1.0"?>​
 +<vxml version="​2.0">​
 + <​form>​
 +  <​block>​
 +   <​prompt>​
 +    <speak xml:​lang=”es-MX”>​
 +    <voice name="​Mia"​ variant=”1”>​
 +     ​Hello,​ thank you for calling Plum Voice.
 +    </​voice>​
 +    </​speak>​
 +   </​prompt>​
 +  </​block>​
 + </​form>​
 +</​vxml>​
 +</​code>​
 +
 +To sequentially use multiple languages and voices within a <​prompt>​ block, use multiple <​speak> ​ and <​voice>​ blocks. ​ For example:
 +<​code>​
 +<?xml version="​1.0"?>​
 +<vxml version="​2.0">​
 + <​form>​
 +  <​block>​
 +   <​prompt>​
 +    <speak xml:​lang="​en-US">​
 +    <voice name="​Joanna"​ variant="​2">​
 +     Press one to continue in English.
 +    </​voice>​
 +    </​speak>​
 +    <speak xml:​lang="​es-US">​
 +    <voice name="​Lupe"​ variant="​2">​
 +     ​Presione dos para continuar en español.
 +    </​voice>​
 +    </​speak> ​
 +    <speak xml:​lang="​fr-FR">​
 +    <voice name="​Celine"​ variant="​standard">​
 +     ​Appuyez sur trois pour continuer en français.
 +    </​voice>​
 +    </​speak>​
 +   </​prompt>​
 +  </​block>​
 + </​form>​
 +</​vxml>​
 +</​code>​
  
 **<​xml:​lang>:​** **<​xml:​lang>:​**
Line 740: Line 805:
  
 The xml:lang attribute does not work with the sentence element. The xml:lang attribute does not work with the sentence element.
- 
-====== Amazon Polly TTS Engine ====== 
-\\ 
-\\ 
-===== TTS Engine Selection ===== 
-Select the Amazon Polly TTS from the list of engines available in the TTS drop down found in our online Plum Dev environment. 
- 
-==== Voice Selection ==== 
- 
-If the Amazon Polly TTS is specified, and neither a <​speak>​ nor <​voice>​ tag are specified, by default Plum Voice will use the en_US, standard, female voice Joanna. 
- 
-If another voice is desired, it should specified using the <​speak>​ and <​voice>​ tags as follows within the prompt block: ​ 
- 
-<​code>​ 
-<?xml version="​1.0"?>​ 
-<vxml version="​2.0">​ 
- <​form>​ 
-  <​block>​ 
-   <​prompt>​ 
-    <speak xml:​lang=”es-MX”>​ 
-    <voice name="​Mia"​ variant=”1”>​ 
-     ​Hello,​ thank you for calling Plum Voice. 
-    </​voice>​ 
-    </​speak>​ 
-   </​prompt>​ 
-  </​block>​ 
- </​form>​ 
-</​vxml>​ 
-</​code>​ 
- 
-To sequentially use multiple languages and voices within a <​prompt>​ block, use multiple <​speak> ​ and <​voice>​ blocks. ​ For example: 
-<​code>​ 
-<?xml version="​1.0"?>​ 
-<vxml version="​2.0">​ 
- <​form>​ 
-  <​block>​ 
-   <​prompt>​ 
-    <speak xml:​lang="​en-US">​ 
-    <voice name="​Joanna"​ variant="​2">​ 
-     Press one to continue in English. 
-    </​voice>​ 
-    </​speak>​ 
-    <speak xml:​lang="​es-US">​ 
-    <voice name="​Lupe"​ variant="​2">​ 
-     ​Presione dos para continuar en español. 
-    </​voice>​ 
-    </​speak> ​ 
-    <speak xml:​lang="​fr-FR">​ 
-    <voice name="​Celine"​ variant="​standard">​ 
-     ​Appuyez sur trois pour continuer en français. 
-    </​voice>​ 
-    </​speak>​ 
-   </​prompt>​ 
-  </​block>​ 
- </​form>​ 
-</​vxml>​ 
-</​code>​ 
- 
-==== <​speak>​ ==== 
- 
-The <​speak>​ tag should be used to specify the desired language through the attribute xml:​lang=”//​lg-CN//​”,​where //lg-CN// is the language-country pair specified in the Language column from that table of supported languages here: https://​docs.aws.amazon.com/​polly/​latest/​dg/​voicelist.html. ​ 
- 
-Please note that each voice has an associated language. Selecting a language that is not associated with the voice will result in unpredictable behavior; however, in many cases, you will hear the language the text was written in accented by that voice’s associated language. 
- 
-==== <​voice>​ ==== 
- 
-The <​voice>​ tag should be used to specify the desired voice through the attribute name=”//​name//​”,​ where //name// is the voice specified in the Name/ID column for the table of supported voices here: https://​docs.aws.amazon.com/​polly/​latest/​dg/​voicelist.html. 
- 
-Within the <​voice>​ tag the attribute variant=”//​number//​” should be used to specify whether a standard voice (variant=1) or neural voice (variant=2) is desired. ​ \\ 
-\\ 
-Note that only certain voices support the neural option. ​ See: [[https://​docs.aws.amazon.com/​polly/​latest/​dg/​voicelist.html]] for a list of voices that support neural, and [[https://​docs.aws.amazon.com/​polly/​latest/​dg/​NTTS-main.html]] for the differences between standard and neural voices. 
- 
- 
-===== Supported SSML Tags ===== 
- 
-The text to be spoken that is specified within the <​voice>​ block can further be marked up with the following SSML tags that are supported by Plum Voice for Amazon Polly. 
- 
-| **Tag** | **Description** | 
-| <​emphasis>​ | Emphasizing Words | 
-| <​phoneme>​ | Using Phonetic Pronunciation | 
-| <​prosody>​ | Controlling Volume, Speaking Rate, and Pitch | 
-| <​say-as>​ | Controlling How Special Types of Words Are Spoken | 
-| <sub> | Pronouncing Acronyms and Abbreviations | 
- 
-