Working with Cue Points in the Media Module

ProductVersionEdition
Video CloudNew StudioExpress I, Express II, Express III, Professional, Enterprise

In this topic you will learn about cue points and how to add, edit and delete them using the Media module.

A cue point is a marker at a precise time point in the duration of a video. You can use cue points to trigger mid-roll ads (that is, ads that occur during playback of the video content, like a commercial break) or to separate chapters or scenes in a long-form video.

There are two types of cue points, but both simply supply a string value to the type property of the cue point object. The appropriate value is helpful only if used in custom JavaScript while processing the cue point information. 

  • Ad - Assigns the string value of AD to the type property
  • Code - Assigns the string value of CODE to the type property

Cue points can be added to videos using the Media module or by using the Catalog API. For more information on adding cue points using the Catalog API, see the developer document Using Cue Points.

This topic is organized into the following sections:

Adding cue points

To add cue points to a video, open the Media module and follow these steps:

  1. Click the video title link to open the video properties page.
  2. Use the preview player to play the video. Pause the video at the point where you want to add a cue point.
  3. Click Add Cue Point.
  4. If needed, adjust the Timecode (hh:mm:ss) values for the cue point. Note that the seconds field supports milliseconds after the decimal point.
  5. Select the type of cue point and then add the appropriate metadata.

After cue points are added to a video, at runtime, the cue points are converted into HTML5 WebVTT cue elements. When this conversion takes place, some of the cue point data, like type and cue point time, are converted into the text track. The cue point time value will be mapped into the WebVTT cue startTime and endTime properties. See this document for more information on the VTTCue interface.

Editing cue points

To edit cue points in a video, open the Media module and follow these steps:

  1. Click the video title link to open the video properties page.
  2. Click the cue point to edit in the timeline.

    Note: Once in edit mode, the Previous and Next buttons can be used to navigate to other cue points.

  3. Edit the cue point properties and then click Save.

Note: It is not possible to have multiple cue points with the same timecode.

Deleting cue points

To delete cue points, open the Media module and follow these steps:

  1. Click the video title link to open the video properties page.
  2. Click the cue point to delete in the timeline.
  3. Click the Delete icon () next to the cue point properties.
  4. Confirm the deletion.