MediaPlaybackSession 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
提供有关 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 MediaPlaybackSessionPublic NotInheritable Class MediaPlaybackSession- 继承
- 属性
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 | |
| 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 |
当媒体播放会话支持的播放速率集更改时发生。 |