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()	检索可以查找 playack 位置的时间范围的只读列表。 对于实时传送视频流，这些范围表示数据仍然可用的时间范围。
IsSupportedPlaybackRateRange(Double, Double)	获取一个值，该值指示是否支持指定的播放速率范围。

事件

BufferedRangesChanged	在缓冲数据的时间范围集更改时发生。
BufferingEnded	在 MediaPlaybackSession 的缓冲结束时发生。
BufferingProgressChanged	在 MediaPlaybackSession 的缓冲进度更改时发生。
BufferingStarted	在 MediaPlaybackSession 的缓冲开始时发生。
DownloadProgressChanged	在 MediaPlaybackSession 的下载进度更改时发生。
NaturalDurationChanged	在当前播放的媒体项的持续时间更改时发生。
NaturalVideoSizeChanged	在当前播放的媒体项中的视频大小更改时发生。
PlaybackRateChanged	当 MediaPlaybackSession 的当前播放速率更改时发生。
PlaybackStateChanged	在当前播放状态更改时发生。
PlayedRangesChanged	在已播放的时间范围集更改时发生。
PositionChanged	在当前播放的媒体中的当前播放位置更改时发生。
SeekableRangesChanged	当可查找的时间范围集更改时发生。
SeekCompleted	在 MediaPlaybackSession 的查找操作完成时发生。
SupportedPlaybackRatesChanged	当媒体播放会话支持的播放速率集更改时发生。

另请参阅

• 使用 MediaPlayer 播放音频和视频