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
IsXMLa keyword indicating that the file content is to be processed as simple XML (if not automatically detected)
IsSSMLa keyword indicating that the file content is to be processed as SMML (if not automatically detected)
NoXMLa keyword indicating that the file content is to be processed as text even if an XML element is found.
SAPIforce 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