Module: src/core/Data

Contains configuration options for how the media is parsed and validated.

Reference to the player instance.

Contains the players' mediaData.

Reference to the root DOM element.

Secret key only known to the player instance and initialized components. Used to be able to restrict access to API methods in conjunction with secure mode.

Reference to the Async Task instance. Used to handle async tasks, which can be cancelled, resolved or rejected.

Timeout ID for data error publishing. Used to prevent race conditions when component is destroyed.

The previous mediaData argument. Used for handling repeated calls to setMediaData. If two calls have the same mediaData, both will get the same promise. If the new call is different, the old one is cancelled.

Depending on the selector, returns a specific media item (selector is a number representing the index in the media playlist), the entire data object (selector = 'all'), the current media item (selector = 'current') or the currently active index (selector = 'index').

Assigns media data to the player instance. mediaData can be a valid data object or a string, in this case the player will either

• try to to load it as a media resource directly (if the extension matches a known type) or
• try to load it as a mediaData object in JSON format.

Switches playback to another media item, with index representing the position of the media to switch to in the internal playlist. Additional options can influence switching behavior in the Media component, like trying to restore the previous seek position (rememberState) or controlling if and how the media is played after switching (ignoreAutoplay, play).

Returns the best matching media variant, considering the user's language and quality preferences. Falls back to the closest possible match if an exact match isn't found. In this case, language preferences have priority over quality preferences.

Loads media data definition from a given URL into the player.

Parses a single media item (either as URL or object) and returns a normalized media data structure. This includes resolving variants & representations, validating MIME types, applying quality/height heuristics, and optionally loading remote JSON if the input is a URL pointing to a JSON file. This method is used internally by #setMediaData() and supports both individual items and full playlists.

This helper function searches a source object for a playable source, i.e. A source which has a mime type which at least results in a 'maybe' using the engines 'canPlay' test method. Representations which return a 'probably' are preferred. If no mime type is provided, the method tries to guess it from the source path file ext.

This method should be called when a 'data error' occurs. In contrast to a 'media error' which usually indicates problems with playing back certain media (for example, due to network problems or decoding errors), a data error usually means that the player - or some component - wasn't able to correctly and completely parse the data it was provided. A typical case would be some essential things missing from the media data, like no src. Also publishes an appropriate event, so other components can for example display an error message to the user.