Creates a new track
{string} - The name for the track.
{string} - The album name, if any.
{string} - The artist name, if any.
{number | null} - The track's custom pre-roll duration, in [seconds]
{number | null} - The track's initial playhead position, in [seconds]. The value will be applied once after a media resource with a player has been mounted.
{number} - The track's playback rate. If not finite, a default value is used.
{number} - The track's pitch shift in [cents]. If not finite, a default value is used.
{string} - The online URL (starting with http(s)) or the local file name (possibly including a path) for the media file. If it is relative, it may get made absolute using the compilation's media path.
{number | null} - Duration of the media associated with the track. This is not persisted, but set to a specific value once after a matching track has been loaded.
{volume} - Track volume.
The album name where this track was taken from.
This is a more descriptive information and not intended to uniquely identify an album.
The artist
The cues
The extracted duration of the loaded media file for this track.
This is only defined if there is a loaded media file for this track.
This must get calculated/reset if the track is loaded/unloaded. It must never get persisted.
A unique identifier for this track.
To work correctly, this identifier must be unique among all currenlty loaded compilations. Best, to make it universally unique by using a UUID.
This identifier allows to recognise this item over multiple edits
The musical meter for this track
This is only relevant for music tracks.
The name of the track
The amount of pitch shift in [cents] (aka detune) at which the track's media is being played back. A value of 0, the default, indicates no shift.
Not all types of track support a pitch shift.
The rate at which the track's media is being played back. A value of 1.0, the default, indicates normal speed.
Not all types of track support a custom playback tempo.
The track's (coarse, perodically persisted) playhead position, in [seconds].
This is not necessarily exactly the current position in the playing media. This value is intended to be periodically updated only to remember the playback position a track (re-)load. When loading a track, the value will be applied once after a media resource with a player has been mounted. If not set, zero may be used
The track's custom pre-roll duration, in [seconds]
If not set, the default pre-roll duration, if any, should be used at playback
The tags
The set of tags can be arbitrarily long. Tags classify a track.
The URL or the local file name (possibly including a path) for the media file.
If it is relative, it may get made absolute using the compilation's media path.
Whether to use the measure number to set and display the cue positions
The playback volume for this track in the range of [0..1].
This can be set by the user, and is persisted.
Static from
Implements a Replayer track