MediaPlaybackList 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
代表可播放的 MediaPlaybackItem 物件清單。 提供切換目前播放專案和啟用迴圈和隨機顯示的方法。
public ref class MediaPlaybackList sealed
/// [Windows.Foundation.Metadata.Activatable(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 MediaPlaybackList 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(65536, "Windows.Foundation.UniversalApiContract")]
class MediaPlaybackList final
[Windows.Foundation.Metadata.Activatable(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 MediaPlaybackList
[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
- 繼承
- 屬性
- 實作
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 成功開啟時發生。 |