Specify XML file to be spoken using TTS
$tts_file pathname [IsXML|IsSSML|NoXML|SAPI]
This command specifies the text in a file to be spoken as a prompt or message. The text is converted to WAV on-the-fly as the call proceeds. For more information see the topic Using Text-to-Speech.
The parameters on this command are used as follows:
| pathname | the full pathname of a file, normally XML, containing the text to be spoken |
| IsXML | a keyword indicating that the file content is to be processed as simple XML (if not automatically detected) |
| IsSSML | a keyword indicating that the file content is to be processed as SMML (if not automatically detected) |
| NoXML | a keyword indicating that the file content is to be processed as text even if an XML element is found. |
| SAPI | force the XML elements to be parsed as for SAPI. |
The keyword option, if given, overrides the value from the TTS_OPTIONS variable.
In TTS files (and TTS text), CopiaFacts variables are expanded using the defined e-mail variable-expansion character (default ` accent-grave). In TTS files, you can also use the CopiaFacts Conditional Text feature to conditionally include phrases, enabling this with the TTS keyword in the CONDITIONAL_TEXT variable. You should bear in mind the XML syntax must remain valid when the conditionals are applied.
If the text is a full XML file containing an ssml:speak element, it will be processed as SSML unless the NoXML keyword is found. For a full specification of the language, see http://www.w3.org/TR/speech-synthesis. For details of the Microsoft implementation, see the Microsoft Speech documentation at http://msdn.microsoft.com/en-us/library/hh378377(v=office.14).aspx.
If the text starts with a < and the NoXML keyword is not found, it will be processed as simple XML. For a specification of the supported elements download the above CHM helpfile and see Microsoft Speech Platform API / Application-Level Interfaces / Text-to-Speech Interfaces / Text Synthesis. Note that line-breaks are significant in this type of file and will introduce a short pause.
Example:
; filename 00004000.iif
$type question
$tts_file question1.xml
$script "get zip code" ; note: this is a comment only
$get_var ZIP 5 5
$next_box 4001
$error_exit 999
