TimedMetadataTrack Class

  • Reference

Definition

Namespace:
Windows.Media.Core
Edit

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.Activatable(Windows.Media.Core.ITimedMetadataTrackFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class TimedMetadataTrack final
/// [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.Activatable(typeof(Windows.Media.Core.ITimedMetadataTrackFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class TimedMetadataTrack
[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.

Applies to

See also