共用方式為


MediaPlaybackSession 類別

定義

提供 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
屬性

Windows 需求

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

備註

存取MediaPlayerPlaybackSession屬性或MediaBreakManagerPlaybackSession屬性,以取得這個類別的實例。

如需使用 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

發生于媒體播放會話支援的播放速率集變更時。

適用於

另請參閱