CallXML 3.0 Development GuideHome  |  Frameset Home


<text>  element

DEPRECATED ELEMENT -- use the <say> element instead
Text is an element that is used to tell the CallXML browser to use a text-to-speech engine to read text contained within the element to the user. No other tags may be nested within this element, the only allowable content is either variable names or TTS values. Note that the default TTS voice is the 'English Female' voice; this can be modified by specifying the 'voice' attribute of this element.



usage
<text cleardigits="(true|false)" termdigits="(123456789*#|ABCD)" voice="(TTS Voice)">


attributes
cleardigitsData Type: (true|false)Default: none - attribute is optional
This attribute's value is a Boolean, indicating whether the queued digits buffer should be cleared when this action starts. "true" clears the digits buffer; "false" leaves the contents of the digit buffer alone.
termdigitsData Type: (123456789*#|ABCD)Default: none - attribute is optional
This attribute holds the list of touch-tone digits which can terminate the current caller action. Note that for each termdigit specified, there should be an <ontermdigit> handler in the code to catch the event. Allowable values are any one of "012356789*#", the ordinary DTMF (Touch-Tone) keypad possibilities, plus the special keypad tones found on some telephones "ABCD".
voiceData Type: (TTS Voice)Default: none - attribute is optional
The voice attribute defines the Text-to-Speech voice that should be used for what is enclosed within that particular <text> element. This allows the developer a way to override the default voice genders/styles on a prompt by prompt basis. The currently supported voices for the CallXML2.0 platform are:

  • English-Female2 (default)
  • English-Male2
  • French-Female1
  • Spanish-Female1



code samples
<Text termdigits - voice>
<?xml version="1.0" encoding="UTF-8"?>

<callxml version="3.0">
  <block label="B_1">
    <say termdigits="#" voice="English-Female2">
      Here is some TTS in the default English Female voice from Speechify.
      This TTS output can be ended at any time by pressing the pound key.
      So what the heck are you waiting for?
      Press the gol durn key on your phone!
    </say>

    <on value="#">
      <say voice="English-Female2">
        Moving on, we will next check out the English male voice.
      </say>
      <goto value="#B_2"/>
    </on>

  </block>

  <block label="B_2">
    <say termdigits="#" voice="English-Male2">
      Here is some TTS in the English Male voice from Speechify.
      This TTS output can be ended at any time by pressing the pound key.
      So what the heck are you waiting for?
      Press the gol durn key on your phone!
    </say>

    <on value="#">
      <say voice="English-Female2">
        Moving on, we will next check out the Spanish Female voice.
      </say>
      <goto value="#B_3"/>
    </on>

  </block>

  <block label="B_3">
    <say termdigits="#" voice="Spanish-Female1">
      Aqui esta algun TTS en la voz femenina espanola de Speechify.
      Usted tienen gusto de mis pantalones?
      Presione la llave de la libra para parar TTS.
    </say>

    <on value="#">
      <say voice="English-Female2">
        Next, we will boogie down with the French Female voice.
      </say>
      <goto value="#B_4"/>
    </on>

  </block>

  <block label="B_4">
    <say termdigits="#" voice="French-Female2">
      Voici un certain TTS dans la voix femelle francaise de Speechify.
      Veuillez appuyer sur la touche de livre pour
      me faire la reddition.
    </say>

    <on value="#">
      <say voice="English-Female2">
        We are now done messing with the TTS voices.
        What did you expect, a celebrity voice?
    </say>
    </on>

  </block>
</callxml>




additional links
none


  ANNOTATIONS: EXISTING POSTS
0 posts - click the button below to add a note to this page

login



© 2008 Voxeo Corporation  |  Voxeo IVR  |  VoiceXML & CCXML IVR Developer Site