Retrieves and plays the specified audio file. If the audio file is unavailable, any enclosed text is sent to the TTS engine for speech synthesis instead.
|src||The URI of the audio prompt. See Section 2.1 for supported audio formats.|
|expr||The expression may be either a reference to audio previously recorded with the item or evaluate to the URI of an audio resource to fetch.|
|stream||The URI of an audio stream to play. Any queued audio is immediately cleared if an MP3 audio stream is opened.|
|fetchhint||This attribute is not supported.|
|fetchtimeout||(defaults to "fetchtimeout" global property value) The timeout for fetches. Must be specified with the appropriate time units (e.g., "120s" for 120 seconds).|
|maxage||(defaults to "audiomaxage" global property value) Tells the platform the maximum acceptable age, in seconds, of cached audio resources.|
|maxstale||(defaults to "audiomaxstale" global property value) Tells the platform the maximum acceptable staleness, in seconds, of expired cached audio resources.|
|maxtime||(defaults to unlimited) The maximum number of seconds of the audio prompt to play.|
|starttime||(defaults to "0s") The number of seconds into the referenced audio prompt at which to begin playback.|
The setting for the "src" attribute has priority over the setting for the "expr" attribute.
<?xml version="1.0"?> <vxml version="2.0"> <form> <block> <prompt> I'm going to play an audio file. </prompt> <!-- If the wave file at the location specified by the --> <!-- "src" attribute can not be retrieved, the text within --> <!-- the "audio" tag will be read by the TTS engine. --> <audio src="http://nonexistent.domain.com/test.wav"> Oops, the audio file could not be retrieved! </audio> </block> </form> </vxml>
The output of the above script would be:
Computer: I'm going to play an audio file.
Computer: (plays audio file if available)
<audio>, <break>, <desc>, <emphasis>, <enumerate>, <mark>, <p>, <paragraph>, <phoneme>, <prosody>, <s>, <say-as>, <sentence>, <speak>, <sub>, <value>, <voice>
<audio>, <block>, <catch>, <emphasis>, <enumerate>, <error>, <field>, <filled>, <foreach>, <help>, <if>, <initial>, <menu>, <noinput>, <nomatch>, <p>, <paragraph>, <prompt>, <prosody>, <record>, <s>, <sentence>, <speak>, <subdialog>, <transfer>, <voice>