MediaPlaybackSession 類別

定義

命名空間:

Windows.Media.Playback

提供 MediaPlayer 目前播放會話狀態的相關資訊，並提供事件來回應播放會話狀態的變更。

public ref class MediaPlaybackSession sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class MediaPlaybackSession final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class MediaPlaybackSession

Public NotInheritable Class MediaPlaybackSession

繼承

Object Platform::Object IInspectable MediaPlaybackSession

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 需求

裝置系列	Windows 10 Anniversary Edition (已於 10.0.14393.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v3.0 引進)

備註

存取MediaPlayer的PlaybackSession屬性或MediaBreakManager的PlaybackSession屬性，以取得這個類別的實例。

如需使用 MediaPlayer 和播放會話的操作指南，請參閱 使用 MediaPlayer 播放音訊和視訊。

版本歷程記錄

Windows 版本	SDK 版本	已新增值
1703	15063	BufferedRangesChanged
1703	15063	GetBufferedRanges
1703	15063	GetPlayedRanges
1703	15063	GetSeekableRanges
1703	15063	IsMirroring
1703	15063	IsSupportedPlaybackRateRange
1703	15063	PlayedRangesChanged
1703	15063	SeekableRangesChanged
1703	15063	SphericalVideoProjection
1703	15063	SupportedPlaybackRatesChanged
1803	17134	GetOutputDegradationPolicyState
1803	17134	PlaybackRotation

屬性

BufferingProgress	取得值，這個值表示 MediaPlaybackSession的目前緩衝進度。
CanPause	取得值，這個值表示如果呼叫 MediaPlayer.Pause 方法，是否可以暫停媒體。
CanSeek	取得值，這個值表示媒體目前的播放位置是否可以藉由設定 MediaPlayer.Position 屬性的值來變更。
DownloadProgress	取得值，指出目前播放 位置 完成之後的位置，並緩衝處理內容。
IsMirroring	取得或設定值，指出媒體播放會話的內容目前是否正在水準鏡像。
IsProtected	取得值，指出目前在 MediaPlaybackSession 中播放的媒體是否受到數位版權管理保護， (DRM) 。
MediaPlayer	取得與MediaPlaybackSession相關聯的MediaPlayer。
NaturalDuration	取得值，指出目前播放媒體的持續時間，在正常速度播放時。
NaturalVideoHeight	取得目前播放媒體專案中影片的高度。
NaturalVideoWidth	取得目前播放媒體專案中影片的寬度。
NormalizedSourceRect	取得或設定 MediaPlayer轉譯之視訊來源內的正規化矩形。 這會啟用視訊內的移動流覽和縮放。
PlaybackRate	取得或設定值，表示 MediaPlaybackSession的目前播放速率。
PlaybackRotation	從 MediaRotation 列舉取得或設定值，指定播放期間套用至視訊內容的旋轉。
PlaybackState	取得值，指出 MediaPlaybackSession的目前播放狀態，例如緩衝或播放。
Position	取得或設定目前播放媒體內的目前播放位置。
SphericalVideoProjection	取得 物件，該物件會管理媒體播放會話所使用的球面視訊投影設定。
StereoscopicVideoPackingMode	取得或設定值，指定 MediaPlaybackSession的立體視訊封裝模式。

方法

GetBufferedRanges()	擷取緩衝處理資料的唯讀時間範圍清單，並立即開始播放。
GetOutputDegradationPolicyState()	取得 物件，表示 MediaPlaybackSession目前的輸出降低原則狀態。
GetPlayedRanges()	擷取已播放內容的唯讀時間範圍清單。
GetSeekableRanges()	擷取可搜尋遊戲位置的時間範圍唯讀清單。 針對即時串流，這些範圍代表資料仍可使用的時間範圍。
IsSupportedPlaybackRateRange(Double, Double)	取得值，指出是否支援指定的播放速率範圍。

事件

BufferedRangesChanged	發生于資料緩衝變更的時間範圍集合時。
BufferingEnded	當 MediaPlaybackSession的緩衝結束時發生。
BufferingProgressChanged	發生于 MediaPlaybackSession 的緩衝進度變更時。
BufferingStarted	當 MediaPlaybackSession的緩衝啟動時發生。
DownloadProgressChanged	發生于 MediaPlaybackSession 的下載進度變更時。
NaturalDurationChanged	發生于目前播放媒體專案的持續時間變更時。
NaturalVideoSizeChanged	發生于目前播放媒體專案中的視訊大小變更時。
PlaybackRateChanged	發生于 MediaPlaybackSession 的目前播放速率變更時。
PlaybackStateChanged	發生于目前的播放狀態變更時。
PlayedRangesChanged	發生于已播放的一組時間範圍變更時。
PositionChanged	發生于目前播放媒體內的目前播放位置變更時。
SeekableRangesChanged	發生于可搜尋變更的時間範圍集合時。
SeekCompleted	發生于 MediaPlaybackSession 的搜尋作業完成時。
SupportedPlaybackRatesChanged	發生于媒體播放會話支援的播放速率集變更時。

另請參閱

• 使用 MediaPlayer 播放音訊和視訊