Create a Clip from a Rolling Buffer

Use the following procedure to retrieve a section of video from the rolling buffer.

To create a clip from a rolling buffer

  • Send the CreateClip action to Media Server. Set the following parameters:

    Stream The name of the rolling buffer to create the clip from.
    StartTime The start time of the clip in epoch-milliseconds or ISO-8601 format. Video must exist in the rolling buffer for the start time that you specify (or begin within 15 seconds of the start time). If video begins within 15 seconds after the start time that you specify, Media Server automatically adjusts the start time. If there is no video in the rolling buffer within 15 seconds after the start time, the action fails.
    Duration The duration of the clip.
    OutputFormat (Optional) The format of the container file that is returned (default ts, but you can also choose mp4).
    Path (Optional) The path to save the clip to. The directory must be on a file system that Media Server can access. If you do not set this parameter, the file is returned in the response.

    For example,

    http://localhost:14000/action=CreateClip&Stream=BBCNews
                                            &StartTime=1393000074243
                                            &Duration=5minutes
                                            &Path=./temp/News1.ts

    This action instructs Media Server to create a five minute clip from the rolling buffer BBCNews, beginning from Fri, 21 Feb 2014 16:27:54 GMT, and to save the clip as the News1.ts file in the temp directory.