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
• メディア項目、プレイリスト、トラック
• バックグラウンド メディア再生のサンプル