Play

Play

The Play verb is used to play an audio file to the remote party.

Play Attributes

Name Allowed Values Default Value

loop

integer > 1

1

  • loop. The 'loop' attribute specifies how many times you’d like the audio file to be repeated. Specifying '0' will cause the <Play> verb to loop until the call is hung up.

Supported Audio Formats

MIME type Description

audio/wav

wav format audio

audio/wave

wav format audio

audio/x-wav

wav format audio

Media Server Audio File Format

Technical Specification and Capacity

The CPaaS Media Server is capable of

  • Media and Codecs:

    G711 (a-Law, u-Law)
    GSM
    Linear PCM(L16)
    G729
    DTMF(RFC 2833, INBAND)

  • Media Files:

    Wav (Sample rate 8000Hz, bit rate of 16, Mono)
    GSM

How to Convert a Wav File to the Correct Bitrate

You can use a software call ffmpeg as follows:

ffmpeg -i source_file.wav -acodec pcm_s16le -ac 1 -ar 8000 result_file.wav

Nesting

The <Play> verb cannot have any other verbs or nouns nested. Only a URL it points to.

Basic examples

<Response>
<Play>http://example.com/demo.wav</Play>
</Response>
If the Play verb does not contain a URL, the verb will be ignored, and the next verb will be executed.

Disk cache for Play verb

Please refer to Cache Strategy document for details about Disk Cache and Play verb execution.