CallXML 2.0 Development GuideHome  |  Frameset Home

  tutorial Cache Control  |  TOC  |  B: Outbound Dialing  
This documentation is for CallXML 2, which has been superceded by CallXML 3. The CallXML 2 language is not being updated any longer. CallXML 3, however, has many new features and is actively being enhanced. If you're writing a new CallXML application, you should use CallXML 3. Click here for the CallXML 3.0 documentation.

Appendix A: Audio Files & CallXML

Using TTS is fine and dandy when you are demoing an application, but eventually, we will want to add recorded audio to our application for a more user-friendly appeal to your callers.This guide will serve as your Holy Grail when it comes to questions that you might have about recording audio and using professional audio prompts in your CallXML applications.

Audio Formats

The supported audio formats for the CallXML markup are as follows:

Other supported formats are in the works, including the ability to stream MP3 files to your application. Stay tuned to the Updates section of the Community site for updates as they happen. If you are developing both CallXML and VoiceXML applications, and would like to keep your audio prompts as 'universal' as possible, it is recommended that you stick with the 8bit/8kHz wav format, which is supported on both platforms.


Alternate Text-to-Speech

The implementation of CallXML 2.0+ has added support for alternate Text To Speech in your application in the event that your audio files return a '404' error, and cannot be found. The "text" attribute, (for callXML 2.0), and the "say'' attribute, (for CallXML3.0), has been added to the following elements to allow for this functionality:

An example of this in action would look like this:
CallXML 2.0

...
  <block>
    <playaudio value="BogusFile.wav" text="here is some backup TTS"/>
  </block>
...


CallXML 3.0

...
  <do>
    <playaudio value="BogusFile.wav" say="here is some backup TTS"/>
  </do>
...


Audio Terminology


Some Facts


Some Problems


Some Solutions


Ignoring Our Advice -- Recording your own prompts


Voxeo Audio Library

Voxeo has anticipated your audio needs, and has a bountiful selection of professional prerecorded audio files available for download, free of charge. These audio files are in 8,000 Hz, 8 bit, MuLaw .wav format, which you can download right here!

The recorded prompts cover the following:

Audio Tools

If you are not certain how to go about getting your files in the proper format, Windows users can use the Sound Recorder to check the file and make changes to it; simply open the file, then select "File" "Save as"..., press the "Change..." button, and change the attributes to "8,000 Hz, 8 Bit, Mono" and you should be ready to launch. However, for the folks that prefer more powerful sound editing software, there are a number of freeware programs that can fit the bill. A listing, (by no means complete), of some good offerings are as follows:

Audio Links

If you are looking for professional voice talent for your application, and you don't see files that meet your specific needs in our download library, you would do well to contact:

GreatVoice.com

UniDig.com

Allison Smith at The IVR Voice

Lecia Macryn Voice Services

ISDNVoices.com


Recording Audio

When recording audio with CallXML, keep in mind that before we attempt any kind of playback to the caller, we must first store the recording on a webserver via FTP:


<recordaudio 
      value="ftp://MyPassword:MyUserName@Myserver.com/MyMsgTitle.wav"
      format="audio/wav" termdigits="all" maxtime="10s" maxsilence="2s"
      beep="true">


Afetr which, we can reference the audio file as a URL within the <playaudio> element:


<playaudio value="http://MyServer.com/MyMsgTitle.wav"/>


If playback isn't a concern, then you can also send the recorded audio as an email attachment. In the email itself, we can specify a number of parameters to properly format the email message that gets sent out, as illustrated in the below snippet:


<recordaudio value="mailto:hasselhoff@baywatch.com?subject=
        Youre fired&fromname=
        The Network&fromaddress=
        muckitymucks@TheNetwork.com&body=
        Sorry dave. Just found out that you have no appreciable talent.
        The enclosed recording details the fact that Baywatch On The Moon 
        is cancelled"/>



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

login
  tutorial Cache Control  |  TOC  |  B: Outbound Dialing  

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