MediaTimelineController 类

定义

命名空间:

Windows.Media

提供有关和控制 MediaPlayer 的速率、位置和状态的信息。 借助此类，可以从单个控制器控制和同步多个媒体播放器，并更轻松地创建自定义传输控件。

public ref class MediaTimelineController sealed

/// [Windows.Foundation.Metadata.Activatable(196608, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class MediaTimelineController final

[Windows.Foundation.Metadata.Activatable(196608, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class MediaTimelineController

function MediaTimelineController()

Public NotInheritable Class MediaTimelineController

继承

Object Platform::Object IInspectable MediaTimelineController

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Windows 10 Anniversary Edition (在 10.0.14393.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v3.0 中引入)

注解

使用 构造函数或通过访问 MediaPlayer 的 TimelineController 属性获取此类的实例。

版本历史记录

Windows 版本	SDK 版本	增值
1703	15063	持续时间
1703	15063	已结束
1703	15063	已失败
1703	15063	IsLoopingEnabled

构造函数

MediaTimelineController()

初始化 MediaTimelineController 类的新实例。

属性

ClockRate	获取或设置 MediaTimelineController 位置变化的速度，以与正常播放速度的比率表示。 例如，将值设置为 1.0 将导致正常播放速度，值 4.0 将导致播放速度是正常速度的 4 倍。
Duration	获取一个值，该值指示时间线的持续时间。 指定的时间跨度过后，时间线时钟将不再进行。
IsLoopingEnabled	获取一个值，该值指示当时间线到达 Duration 指定的时间窗口的终点时，是否将循环，在零处重启时钟。
Position	获取或设置 MediaTimelineController 的当前位置。
State	获取一个值，该值指示 MediaTimelineController 的当前状态，它可以是正在运行或已暂停。

方法

Pause()	暂停 MediaTimelineController 的播放。
Resume()	从控制器暂停的位置恢复 MediaTimelineController 的播放。
Start()	从位置 0 开始播放 MediaTimelineController 。

事件

Ended	如果 IsLoopingEnabled 设置为 false，则当时间线控制器到达 Duration 指定的时间窗口结束时发生。
Failed	当时间线控制器遇到内部错误且无法继续播放时发生。
PositionChanged	当 MediaTimelineController 的位置更改时发生。
StateChanged	当 MediaTimelineController 的状态更改时发生。

另请参阅

• 视频播放同步示例