MediaPlaybackList 类

定义

命名空间:

Windows.Media.Playback

表示可播放的 MediaPlaybackItem 对象的列表。 提供用于切换当前正在播放的项目以及启用循环和随机播放的方法。

public ref class MediaPlaybackList 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(65536, "Windows.Foundation.UniversalApiContract")]
class MediaPlaybackList 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(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class MediaPlaybackList

function MediaPlaybackList()

Public NotInheritable Class MediaPlaybackList

继承

Object Platform::Object IInspectable MediaPlaybackList

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

实现

IMediaPlaybackSource

Windows 要求

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

注解

MediaPlaybackList 中的项是使用无间隙播放呈现的。 系统将使用 MP3 或 AAC 编码的文件中所提供的元数据来确定无缝播放所需的延迟或填充补偿。 如果 MP3 或 AAC 编码的文件不提供此元数据，则系统将试探性确定延迟或填充。 对于无损格式（如 PCM、FLAC 或 ALAC），系统不执行任何操作，因为这些编码器不会引入延迟或填充。

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

版本历史记录

Windows 版本	SDK 版本	增值
1511	10586	MaxPrefetchTime
1511	10586	SetShuffledItems
1511	10586	ShuffledItems
1511	10586	StartingItem
1703	15063	MaxPlayedItemsToKeepOpen

构造函数

MediaPlaybackList()

初始化 MediaPlaybackList 类的新实例。

属性

AutoRepeatEnabled	获取或设置一个值，该值指示在到达列表末尾时是否将循环播放列表。
CurrentItem	获取当前正在播放 的 MediaPlaybackItem。
CurrentItemIndex	获取MediaPlaybackList 中当前项的索引。
Items	获取播放列表的 IObservableVector 表示形式。
MaxPlayedItemsToKeepOpen	获取或设置一个值，该值指定播放后应保持打开的 MediaPlaybackItem 对象的数量。
MaxPrefetchTime	获取或设置播放列表中的 MediaPlaybackItem 对象的最大预提取时间。 预提取时间是系统检索项的媒体内容之前，预计项目开始播放的时间量。
ShuffledItems	获取将在随机模式中按播放顺序播放的 MediaPlaybackItem 对象的只读列表。
ShuffleEnabled	获取或设置一个值，该值指示是否按随机顺序播放播放列表中的项。
StartingItem	获取或设置将首先播放的 MediaPlaybackItem 。

方法

MoveNext()	将 MediaPlaybackList 的当前项更改为列表中的下一项。
MovePrevious()	将 MediaPlaybackList 的当前项更改为列表中的上一项。
MoveTo(UInt32)	将 MediaPlaybackList 的当前项更改为具有指定索引的项。
SetShuffledItems(IIterable<MediaPlaybackItem>)	设置将在随机模式下播放的 MediaPlaybackItem 对象的列表，其播放顺序相同。

事件

CurrentItemChanged	在当前播放的 MediaPlaybackItem 更改时发生。
ItemFailed	当播放列表中的 MediaPlaybackItem 遇到错误时发生。
ItemOpened	成功打开播放列表中的 MediaPlaybackItem 时发生。

另请参阅

• IMediaPlaybackSource
• 媒体项、播放列表和曲目
• 后台媒体播放示例