MediaPlaybackItem 类

定义

命名空间:

Windows.Media.Playback

表示可以播放的媒体项。 此类充当 MediaSource 的包装器， MediaSource 公开媒体源中包含的音频曲目、视频轨和计时元数据轨道。

public ref class MediaPlaybackItem 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.Playback.IMediaPlaybackItemFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(Windows.Media.Playback.IMediaPlaybackItemFactory2, 196608, "Windows.Foundation.UniversalApiContract")]
class MediaPlaybackItem 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.Playback.IMediaPlaybackItemFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Media.Playback.IMediaPlaybackItemFactory2), 196608, "Windows.Foundation.UniversalApiContract")]
public sealed class MediaPlaybackItem

function MediaPlaybackItem(source, startTime, durationLimit)

Public NotInheritable Class MediaPlaybackItem

继承

Object Platform::Object IInspectable MediaPlaybackItem

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

实现

IMediaPlaybackSource

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

MediaPlaybackItem 可以直接传递给播放器，例如 MediaPlayer、MediaElement 或 MediaPlayerElement。 或者，你甚至可以使用 MediaPlaybackList 类向播放器传递多个媒体播放项的列表。

有关使用媒体项的操作指南，请参阅 媒体项、播放列表和曲目。

版本历史记录

Windows 版本	SDK 版本	增值
1511	10586	FindFromMediaSource
1607	14393	MediaPlaybackItem (MediaSource，TimeSpan)
1607	14393	MediaPlaybackItem (MediaSource，TimeSpan，TimeSpan)
1607	14393	ApplyDisplayProperties
1607	14393	BreakSchedule
1607	14393	CanSkip
1607	14393	DurationLimit
1607	14393	GetDisplayProperties
1607	14393	StartTime
1703	15063	AutoLoadedDisplayProperties
1703	15063	IsDisabledInPlaybackList
1703	15063	TotalDownloadProgress

构造函数

MediaPlaybackItem(MediaSource)	初始化 MediaPlaybackItem 类的新实例。
MediaPlaybackItem(MediaSource, TimeSpan)	使用 StartTime 值初始化 MediaPlaybackItem 类的新实例，该值指示应开始播放的项内的位置。
MediaPlaybackItem(MediaSource, TimeSpan, TimeSpan)	使用 StartTime 值初始化 MediaPlaybackItem 类的新实例，该值指示应开始播放的项中的位置，以及指定项的最大播放持续时间的 DurationLimit 值。

属性

AudioTracks	获取与 MediaPlaybackItem 关联的 MediaSource 中音轨的只读列表。
AutoLoadedDisplayProperties	获取或设置一个值，该值指定系统应自动加载要在系统媒体传输控件中显示的元数据类型（如果有）。
BreakSchedule	获取用于定义 MediaPlaybackItem 的媒体中断计划的 MediaBreakSchedule。
CanSkip	获取或设置一个值，该值指示是否可以跳过 MediaPlaybackItem 。
DurationLimit	获取 MediaPlaybackItem 的最大播放持续时间。
IsDisabledInPlaybackList	获取或设置一个值，该值指定是否在 MediaPlaybackList 中禁用 MediaPlaybackItem。
Source	获取与 MediaPlaybackItem 关联的 MediaSource 对象。
StartTime	获取 MediaPlaybackItem 中播放应开始的位置。
TimedMetadataTracks	获取与 MediaPlaybackItem 关联的 MediaSource 中计时元数据轨的只读列表。
TotalDownloadProgress	获取一个值，该值指示当前下载的 MediaPlaybackItem 的数据比例。
VideoTracks	获取与 MediaPlaybackItem 关联的 MediaSource 中视频曲目的只读列表。

方法

ApplyDisplayProperties(MediaItemDisplayProperties)	汇报 MediaPlaybackItem 的显示属性。 系统媒体传输控件使用这些属性来显示有关当前播放的媒体项的信息。
FindFromMediaSource(MediaSource)	检索与提供的 MediaSource 关联的 MediaPlaybackItem。
GetDisplayProperties()	获取 MediaPlaybackItem 的显示属性。

事件

AudioTracksChanged	当 MediaSource 中与 MediaPlaybackItem 关联的音轨列表更改时发生。
TimedMetadataTracksChanged	当与 MediaPlaybackItem 关联的 MediaSource 中的计时元数据列表发生更改时发生。
VideoTracksChanged	当与 MediaPlaybackItem 关联的 MediaSource 中的视频轨列表更改时发生。

另请参阅

• IMediaPlaybackSource
• 媒体项、播放列表和曲目