共用方式為


MediaPlaybackItem 類別

定義

表示可播放的媒體專案。 這個類別可作為 MediaSource 的包裝函式,其會公開媒體來源中包含的音訊播放軌、視訊播放軌和計時中繼資料播放軌。

public ref class MediaPlaybackItem sealed
/// [Windows.Foundation.Metadata.Activatable(Windows.Media.Playback.IMediaPlaybackItemFactory, 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 MediaPlaybackItem 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(Windows.Media.Playback.IMediaPlaybackItemFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class MediaPlaybackItem 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(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.Activatable(typeof(Windows.Media.Playback.IMediaPlaybackItemFactory), 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 MediaPlaybackItem
[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")]
public sealed class MediaPlaybackItem
[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)
function MediaPlaybackItem(source, startTime, durationLimit)
Public NotInheritable Class MediaPlaybackItem
繼承
Object Platform::Object IInspectable MediaPlaybackItem
屬性
實作

Windows 需求

裝置系列
Windows 10 (已於 10.0.10240.0 引進)
API contract
Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

備註

MediaPlaybackItem可以直接傳遞至播放程式,例如MediaPlayerMediaElement 或 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中的視訊播放軌清單變更時。

適用於

另請參閱