TimedMetadataTrack Class

Definition

Namespace:

Windows.Media.Core

Represents a timed metadata track. The track contains a list of IMediaCue objects and raises events at the beginning and end of the time window of each cue.

public ref class TimedMetadataTrack sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Media.Core.ITimedMetadataTrackFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class TimedMetadataTrack final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Media.Core.ITimedMetadataTrackFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class TimedMetadataTrack

function TimedMetadataTrack(id, language, kind)

Public NotInheritable Class TimedMetadataTrack

Inheritance

Object Platform::Object IInspectable TimedMetadataTrack

Attributes

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implements

IMediaTrack

Windows requirements

Device family	Windows 10 (introduced in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduced in v1.0)

Remarks

For how-to guidance for working with timed metadata tracks, see Media items, playlists, and tracks.

Version history

Windows version	SDK version	Value added
1607	14393	Name
1607	14393	PlaybackItem

Constructors

TimedMetadataTrack(String, String, TimedMetadataKind)

Initializes a new instance of the TimedMetadataTrack class.

Properties

ActiveCues	Gets the list of media cues in the TimedMetadataTrack that are currently active. A cue is considered active after its StartTime has been reached until its Duration has been exceeded.
Cues	Gets a read-only list of the media cues in the TimedMetadataTrack.
DispatchType	Gets the custom string value containing routing information for cues.
Id	Gets the identifier for the timed metadata track.
Label	Gets or sets the label for the timed metadata track.
Language	Gets a string indicating the language of the timed metadata track.
Name	Gets the name of the TimedMetadataTrack.
PlaybackItem	Gets the MediaPlaybackItem containing the TimedMetadataTrack.
TimedMetadataKind	Gets a value indicating the kind of metadata contained in the track.
TrackKind	Gets a value specifying the type of the media track. For TimedMetadataTrack this value will always be MediaTrackKind.TimedMetadata.

Methods

AddCue(IMediaCue)	Adds the specified media cue to the TimedMetadataTrack.
RemoveCue(IMediaCue)	Removes the specified media cue from the TimedMetadataTrack.

Events

CueEntered	Occurs when a media time window of a media cue is entered. The time window is defined by the StartTime and Duration of the cue.
CueExited	Occurs when a media time window of a media cue is exited. The time window is defined by the StartTime and Duration of the cue.
TrackFailed	Raised when an error occurs with the TimedMetadataTrack.

See also

• IMediaTrack
• Media items, playlists, and tracks