MediaPlaybackItem 類別

定義

命名空間:

Windows.Media.Playback

表示可播放的媒體專案。 這個類別可作為 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	取得 MediaBreakSchedule ，定義 MediaPlaybackItem的媒體中斷排程。
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	發生于與MediaPlaybackItem相關聯之 MediaSource中的音訊播放軌清單變更時。
TimedMetadataTracksChanged	發生于與MediaPlaybackItem相關聯之 MediaSource中的計時中繼資料追蹤清單變更時。
VideoTracksChanged	發生于與MediaPlaybackItem相關聯之 MediaSource中的視訊播放軌清單變更時。

另請參閱

• IMediaPlaybackSource
• 媒體項目、播放清單與曲目