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.