Technical Helpweb

Dialogic® PowerMedia™ Extended Media Server (PowerMedia XMS) - more articles

Playing multiple URIs in a single play request using the RESTful API

This article provides an example of how one could chain multiple play commands together using the RESTful API for the Dialogic® PowerMedia™ XMS Software.

The Dialogic® PowerMedia™ XMS RESTful API User's Guide states the following on page 32 as the description for the "audio_uri" parameter for the "play_source" command:

"... Multiple URIs can be specified by using the newline character '\n' as a separator. Only URIs of type "file://..." are currently supported when playing multiple files."

As an additional clarification, the the newline character '\n'  must be ESCAPED since this is a URI.  The actual separator that must be inserted therefore is "
".   For example, the following command (on an already established / connected call) will play the "play_menu.wav" file twice:

<call>
   <call_action>
      <play>
         <play_source base_audio_uri="file://verification"
                      audio_uri="play_menu.wav&#10;play_menu.wav"
                      audio_type="audio/x-wav" />
       </play>
   </call_action>
</call>

Product List:

Dialogic® PowerMedia™ XMS Software (Release 2.1 and later)