Class: MediaMetadata

  • cast.framework.messages.MediaMetadata is a class used for common media metadata within MediaInformation or container metadata.

  • The constructor MediaMetadata(type) requires a non-null type parameter of cast.framework.messages.MetadataType.

  • Key properties include metadataType (required), and optional properties like posterUrl, queueItemId, sectionDuration, sectionStartAbsoluteTime, sectionStartTimeInContainer, and sectionStartTimeInMedia.

  • Several properties (queueItemId, sectionDuration, sectionStartTimeInContainer, sectionStartTimeInMedia) are specifically relevant when describing media sections within a container.

  • sectionStartAbsoluteTime provides an alternative way to specify the section start time for live media using UNIX Epoch time.

cast.framework.messages.MediaMetadata

class   static

Common media metadata used as part of MediaInformation or to describe a media section as part of the container metadata.

Constructor

MediaMetadata

new MediaMetadata(type)

Parameter

type

cast.framework.messages.MetadataType

Type of metadata.

Value must not be null.

Properties

metadataType

non-null cast.framework.messages.MetadataType

The type of metadata.

posterUrl

(string or undefined)

Optional image URL to be shown when video is loading.

queueItemId

(number or undefined)

The queue item that include this media section. This is only relevant if used in container sections, and if there are multiple media items for the container.

sectionDuration

(number or undefined)

The media section duration in seconds. This is only required if the metadata describes a section of the media file that has a different duration value.

sectionStartAbsoluteTime

(number or undefined)

Alternative way to provide the section start time for live media. Provides the start time in UNIX Epoch time (seconds since the Unix epoch).

sectionStartTimeInContainer

(number or undefined)

The media section start time offset within the container, in seconds. If not provided, the framework assumes that it's the same as the offset within the media.

sectionStartTimeInMedia

(number or undefined)

The media section start time within the media file, in seconds. This can be negative if a section started in previous file.