Class: Break

  • cast.framework.messages.Break represents an ad break or similar interruption within the main video.

  • A Break is constructed with a unique ID, a list of break clip IDs, and a position within the main video.

  • Properties include breakClipIds, optional duration, optional expanded status, unique id, optional isEmbedded status, isWatched status, and position.

cast.framework.messages.Break

class   static

Represents a break (an ad break, for example) included in the main video.

Constructor

Break

new Break(id, breakClipIds, position)

Parameter

id

string

Unique ID of a break.

breakClipIds

Array of string

List of break clip IDs included in this break.

Value must not be null.

position

number

Position of this break inside the main video.

Properties

breakClipIds

non-null Array of string

A list of break clip IDs included in this break.

duration

(number or undefined)

The duration of a break in seconds.

expanded

(boolean or undefined)

Indicates whether the break is expanded on the timeline. The duration of expanded breaks is included in the total playback duration. A value of true indicates that the break is expanded. When omitted, the value is assumed to be false.

id

string

The unique break ID. For seek breaks, the ID is an autogenerated string in a format seek-<timestampInMs>.

isEmbedded

(boolean or undefined)

Indicates whether the break is embedded in the main stream. When omitted, the value is assumed to be false.

isWatched

boolean

Whether a break was watched. This is marked as true when the break begins to play. A sender can change the color of a progress bar marker corresponding to this break once this field changes from false to true, indicating that the user has viewed the break.

position

number

The location of the break inside the main video in seconds. -1 represents the position at the end of the main video (post-roll) and is only valid for the client-side ad stitching. For the server-side ad stitching, an exact position is required.