Programmer's Reference Manual

Plum Voice Platform v. 2.6

© 2007 Plum Group, Inc. All rights reserved.

6. TTS Speech Engine Characteristics

6.1 Voice Tag Attributes

<gender>:

AT&T Natural Voices, Cepstral Engine, and RealSpeak Engine:

This attribute works fine for these speech engines.

<age>:

AT&T Natural Voices:

This attribute is not supported. 

Cepstral Engine:

This attribute looks for an exact match, instead of looking for the closest match. For example, <voice age="10"> will only select a ten-year-old voice, or fall back to the default voice if one is not found.

RealSpeak Engine:

This attribute is not supported.

<name>:

Please contact your sales account manager for which of these voices you have installed on your server.

The following names are supported by its respective engine: 

AT&T Natural Voices:

de_de (German): reiner (male), klara (female)
en_uk (British English): charles (male), anjali (female), audrey (female)
en_us (American English): mel (male), mike (male), ray (male), rich (male), claire(female),
                                          crystal (female), julia (female), lauren (female)
es_us (Spanish): alberto (male), rosa (female)
fr_fr (French): alain (male), juliette (female)

These names are used for US production hosting.

Note:

In the UK, the following Cepstral names will work:

en_uk (British English): Lawrence (male), Millie (female)
en_us (American English): Diane (female), David (male), Callie (female), William (male)
fr_fr (French): Isabelle (female)

The AT&T Natural Voices versions of these names are:

Lawrence -> charles
Millie -> audrey
Diane -> lauren
David -> mike
Callie -> crystal
William -> ray
Isabelle -> juliette

Cepstral Engine (case-sensitive):

de_de (German): Matthias (male), Katrin (female)
en_uk (British English): Lawrence (male), Millie (female)
en_us (American English): Diane (female), David (male), Callie (female), William (male)
es_us (Spanish): Marta (female), Miguel (male)
fr_fr (French): Isabelle (female), Jean-Pierre (male)
it_it (Italian): Vittoria (female)

These names are used for on-site hosting.

RealSpeak Engine (case-sensitive): 

da-DK (Danish): Nanna (female)
de-DE (German): Steffi (female), Yannick (male)
en-AU (Australian English): Karen (female), Lee (male)
en-GB (British English): Emily (female), Daniel (male)
en-IN (Indian English): Sangeeta (female)
en-US (American English): Jill (female), Samantha (female), Tom (male)
es-ES (Spanish): Isabel (female), Monica (female)
es-MX (Mexican Spanish): Paulina (female), Javier (male)
eu-ES (Basque): Arantxa (female)
fr-CA (Canadian French): Julie (female), Felix (male)
fr-FR (French): Virginie (female), Sebastien (male)
it-IT (Italian): Silvia (female), Paolo (male)
ja-JP (Japanese): Kyoko (female)
ko-KR (Korean): Narae (female)
kr-KR (Korean): Narae (female)
nl-BE (Belgian Dutch): Ellen (female)
nl-NL (Dutch): Claire (female)
no-NO (Norwegian): Nora (female)
pl-PL (Polish): Agata (female)
pt-BR (Brazilian Portuguese): Raquel (female)
pt-PT (Portuguese): Madalena (female)
ru-RU (Russian): Katerina (female)
sv-SE (Swedish): Ingrid (female)
zh-CN (Mandarin Chinese): Mei-Ling (female)
zh-HK (Hong Kong Cantonese): Sin-Ji (female)

For the RealSpeak Engine, this attribute MUST be used along with its corresponding xml:lang attribute if the language is not en-US (American English). For example, to hear the French voice "Sebastien", one must type <voice name="Sebastien" xml:lang="fr-FR">. To hear the British voice "Emily", one must type <voice name="Emily" xml:lang="en-GB">.

<xml:lang>:

Please contact your sales account manager for which of these languages you have installed on your server.

The following languages are supported by their respective engines:

AT&T Natural Voices:

de_de (German)
en_uk (British English)
en_us (American English)
es_us (Spanish)
fr_fr (French)

Cepstral Engine:

en_us (American English)

RealSpeak Engine:

da-DK (Danish)
de-CH (Swiss German)
de-DE (German)
en-AU (Australian English)
en-GB (British English)
en-IN (Indian English)
en-US (American English)
es-ES (Spanish)
es-MX (Mexican Spanish)
eu-ES (Basque)
fr-BE (Belgian French)
fr-CA (Canadian French)
fr-CH (Swiss French)
fr-FR (French)
it-CHC (Swiss Italian)
it-IT (Italian)
ja-JP (Japanese)
ko-KR (Korean)
kr-KR (Korean)
nl-BE (Belgian Dutch)
nl-NL (Dutch)
no-NO (Norwegian)
pl-PL (Polish)
pt-BR (Brazilian Portuguese)
pt-PT (Portuguese)
ru-RU (Russian)
sv-SE (Swedish)
zh-CN (Mandarin Chinese)
zh-HK (Hong Kong Cantonese)

Note that different syntax is used for the xml:lang attribute for the RealSpeak Engine. For example, <voice xml:lang="fr-FR"> would have to be typed to hear a French speaker. For the AT&T Natural Voices Engine and Cepstral Engine, one would type <voice xml:lang="en_us"> to hear an American speaker.

6.2 Voice Child Tags

An "x" marks that the Child Tag is supported by the speech engine. An asterisk (*) means that there are notes to explain the difference between the speech engines.

Child Tag

AT&T Natural Voices

Cepstral Engine

RealSpeak Engine

 <break>*

x

x

x

<emphasis>

 

 

 

<enumerate>

 

 

 

<mark>

 

 

 

 <paragraph>*

x

x

x

 <phoneme>*

x

x

 

 <prosody>*

x

x

x

 <say-as>*

x

x

x

 <sentence>*

x

x

x

<speak>

x

x

x

<sub>

x

x

x

<value>

x

x

x


<break>:

AT&T Natural Voices:

The break element works fine for when the voice speaker is en_us (American English) or when the language is set to en-us (American English). However, for the other languages (de_de (German), fr_fr (French), en_uk (British English), es_us (Spanish)), the "size" attribute does not work. 

Cepstral Engine:

The "size" attribute of the break element does not work for the Cepstral Engine.

RealSpeak Engine:

The break element works fine for the RealSpeak Engine. 

<paragraph>:

Cepstral Engine:

The "xml:lang" attribute does not work with the paragraph element. 

<phoneme>:

AT&T Natural Voices and Cepstral Engine:

The phoneme element works fine using the Phoneme Set in Section A.2 of the Appendix of the Programmer’s Reference Manual. Keep in mind that the phoneme set of AT&T Natural Voices and Cepstral differ.

RealSpeak Engine:

This element is not supported.

<prosody>: 

AT&T Natural Voices:

The prosody element works fine for this engine. You can specify a preset rate ("fast", "medium", "slow", or "default"). However, using a preset rate is not recommended because it either sets the voice rate to too slow or too fast. The "rate" attribute can also be set to an integer value such as "100.0" or "50.0". A normal voice rate should be set to around "150.0". These values are not in accordance with the SSML spec, where rates are specified relative to 1. Additionally, you can also adjust the voice rate by using percentages. To increase the rate you could type "+50%" to make the voice rate 50% faster or "-50%" to make the voice rate 50% slower.

Cepstral Engine:

The prosody element works fine for the Cepstral Engine. Also, the "pitch" attribute only works for the Cepstral Engine. 

RealSpeak Engine:

The prosody element works fine for the RealSpeak Engine.

<say-as>:

An "x" marks that the Say-as Tag is supported by the speech engine. An asterisk (*) means that there are notes to explain on the say-as tag type for AT&T Natural Voices.

Say-as Tag Types

AT&T Natural Voices

Cepstral Engine

RealSpeak Engine

acronym*

x

x

 

number

x

x

x

number:cardinal

x

x

x

number:ordinal

 x

x

x

number:digits

 

x

x

date

x

x

x

date:dmy

 

x

x

date:mdy*

x

x

x

date:ymd

 

x

x

date:ym

 

x

x

date:my*

 x

x

x

date:md*

 x

x

x

date:y*

 x

x

x

date:m

 x

x

x

date:d

 

x

x

time*

x

 

x

telephone*

x

x

x

currency

x

x

x

acronym: The acronym tag type works fine in the US, but does not work in the UK. To spell out words or say back digits in the UK, you would have to use commas inside of a string such as "a, c, r, o, n, y, m" or "1, 2, 3, 4, 5".

date:mdy: The preferred format of this tag is "month abbreviation day, year". For example, to return "December 25, 2001", you would type "Dec 25, 2001". You can also use the "month/day/year" format such as "12/25/01" for the US, but this format will not work in the UK.

date:my: The format of this tag should be "month abbreviation, year". For example, to return "December, 2001", you would type "Dec, 2001".

date:md: The preferred format for this tag is "month abbreviation day". For example, to return "December 25", you would type "Dec 25". You can also use the "month/day" format such as "12/25" for the US, but this format will not work in the UK.

date:y: The date:y tag type works fine in the US, but does not work in the UK.

time: The time tag type works fine in the US, but does not work in the UK.

telephone: The telephone tag type works fine in the US, but does not work in the UK.

<sentence>: 

Cepstral Engine:

The xml:lang attribute does not work with the sentence element.