SAPI Elements
Tag Description Type
volume
 The Volume tag controls the volume of a voice. The tag can be empty, in which case it applies to all subsequent text, or it can have content, in which case it only applies to that content.

The Volume tag has one required attribute: Level. The value of this attribute should be an integer between zero and one hundred. Values outside of this range will be truncated.

One hundred represents the default volume of a voice.

 <volume level="50">
This text should be spoken at volume level fifty.
<volume level="100">
This text should be spoken at volume level one hundred.
</volume>
</volume>
<volume level="80"/>
All text which follows should be spoken at volume level eighty.


rate
 The Rate tag controls the rate of a voice. The tag can be empty, in which case it applies to all subsequent text, or it can have content, in which case it only applies to that content.

The Rate tag has two attributes, Speed and AbsSpeed, one of which must be present. The value of both of these attributes should be an integer between negative ten and ten. Values outside of this range may be truncated by the engine.

The AbsSpeed attribute controls the absolute rate of the voice, so a value of ten always corresponds to a value of ten, a value of five always corresponds to a value of five.

The Speed attribute controls the relative rate of the voice. The absolute value is found by adding each Speed to the current absolute value.
Zero represents the default rate of a voice, with positive values being faster and negative values being slower.

Example1:
<rate absspeed="5">
This text should be spoken at rate five.
<rate absspeed="-5">
This text should be spoken at rate negative five.
</rate>
</rate>
<rate absspeed="10"/>

All text which follows should be spoken at rate ten.

Example2:
<rate speed="5">
This text should be spoken at rate five.
<rate speed="-5">
This text should be spoken at rate zero.
</rate>
</rate>



silence
 The Silence tag inserts a specified number of milliseconds of silence into the output audio stream. This tag must be empty, and must have one attribute, msec. Five hundred milliseconds of silence <silence msec="500"/> just occurred


pitch
 The Pitch tag controls the pitch of a voice. The tag can be empty, in which case it applies to all subsequent text, or it can have content, in which case it only applies to that content. The Pitch tag has two attributes, Middle and AbsMiddle, one of which must be present. The value of both of these attributes should be an integer between negative ten and ten. The AbsMiddle attribute controls the absolute pitch of the voice, so a value of ten always corresponds to a value of ten, a value of five always corresponds to a value of five. The Middle attribute controls the relative pitch of the voice. The absolute value is found by adding each Middle to the current absolute value. Zero represents the default middle pitch for a voice, with positive values being higher and negative values being lower. Example1:
<pitch absmiddle="5">This text should be spoken at pitch five.<pitch absmiddle="-5">This text should be spoken at pitch negative five.</pitch></pitch><pitch absmiddle="10"/>All text which follows should be spoken at pitch ten.


Example2:
<pitch middle="5">This text should be spoken at pitch five.<pitch middle="-5">This text should be spoken at pitch zero.</pitch></pitch>
emph
 The Emph tag instructs the voice to emphasize a word or section of text. The Emph tag cannot be empty. The following word should be emphasized. <emph> boo </emph>! The method of emphasis may vary from voice to voice.


spell
 The Spell tag forces the voice to spell out all text, rather than using its default word and sentence breaking rules, normalization rules, and so forth. All characters should be expanded to corresponding words (including punctuation, numbers, and so forth). The Spell tag cannot be empty. <spell>These words should be spelled out.</spell>These words should not be spelled out.


pron
 The Pron tag inserts a specified pronunciation. The voice will process the sequence of phonemes exactly as they are specified. This tag can be empty, or it can have content. If it does have content, it will be interpreted as providing the pronunciation for the enclosed text. That is, the enclosed text will not be processed as it normally would be. The Pron tag has one attribute, Sym, whose value is a string of white space separated phonemes. <pron sym="h eh 1 l ow & w er 1 l d "/> <pron sym="h eh 1 l ow & w er 1 l d"> hello world </pron>