Skip to content
Snippets Groups Projects
  • Matt Jordan's avatar
    03d88b56
    ARI: Add the ability to play multiple media URIs in a single operation · 03d88b56
    Matt Jordan authored
    Many ARI applications will want to play multiple media files in a row to
    a resource. The most common use case is when building long-ish IVR prompts
    made up of multiple, smaller sound files. Today, that requires building a
    small state machine, listening for each PlaybackFinished event, and triggering
    the next sound file to play. While not especially challenging, it is tedious
    work. Since requiring developers to write tedious code to do normal activities
    stinks, this patch adds the ability to play back a list of media files to a
    resource.
    
    Each of the 'play' operations on supported resources (channels and bridges)
    now accepts a comma delineated list of media URIs to play. A single Playback
    resource is created as a handle to the entire list. The operation of playing
    a list is identical to playing a single media URI, save that a new event,
    PlaybackContinuing, is raised instead of a PlaybackFinished for each non-final
    media URI. When the entire list is finished being played, a PlaybackFinished
    event is raised.
    
    In order to help inform applications where they are in the list playback, the
    Playback resource now includes a new, optional attribute, 'next_media_uri',
    that contains the next URI in the list to be played.
    
    It's important to note the following:
     - If an offset is provided to the 'play' operations, it only applies to the
       first media URI, as it would be weird to skip n seconds forward in every
       media resource.
     - Operations that control the position of the media only affect the current
       media being played. For example, once a media resource in the list
       completes, a 'reverse' operation on a subsequent media resource will not
       start a previously completed media resource at the appropiate offset.
     - This patch does not add any new operations to control the list. Hopefully,
       user feedback and/or future patches would add that if people want it.
    
    ASTERISK-26022 #close
    
    Change-Id: Ie1ea5356573447b8f51f2e7964915ea01792f16f
    03d88b56
    History
    ARI: Add the ability to play multiple media URIs in a single operation
    Matt Jordan authored
    Many ARI applications will want to play multiple media files in a row to
    a resource. The most common use case is when building long-ish IVR prompts
    made up of multiple, smaller sound files. Today, that requires building a
    small state machine, listening for each PlaybackFinished event, and triggering
    the next sound file to play. While not especially challenging, it is tedious
    work. Since requiring developers to write tedious code to do normal activities
    stinks, this patch adds the ability to play back a list of media files to a
    resource.
    
    Each of the 'play' operations on supported resources (channels and bridges)
    now accepts a comma delineated list of media URIs to play. A single Playback
    resource is created as a handle to the entire list. The operation of playing
    a list is identical to playing a single media URI, save that a new event,
    PlaybackContinuing, is raised instead of a PlaybackFinished for each non-final
    media URI. When the entire list is finished being played, a PlaybackFinished
    event is raised.
    
    In order to help inform applications where they are in the list playback, the
    Playback resource now includes a new, optional attribute, 'next_media_uri',
    that contains the next URI in the list to be played.
    
    It's important to note the following:
     - If an offset is provided to the 'play' operations, it only applies to the
       first media URI, as it would be weird to skip n seconds forward in every
       media resource.
     - Operations that control the position of the media only affect the current
       media being played. For example, once a media resource in the list
       completes, a 'reverse' operation on a subsequent media resource will not
       start a previously completed media resource at the appropiate offset.
     - This patch does not add any new operations to control the list. Hopefully,
       user feedback and/or future patches would add that if people want it.
    
    ASTERISK-26022 #close
    
    Change-Id: Ie1ea5356573447b8f51f2e7964915ea01792f16f
To find the state of this project's repository at the time of any of these versions, check out the tags.