SystemMediaTransportControls 类

定义

命名空间:

Windows.Media

表示一个对象，该对象支持与系统媒体传输控件的集成，并支持媒体命令。

public ref class SystemMediaTransportControls sealed

/// [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.MTA)]
class SystemMediaTransportControls final

[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.MTA)]
public sealed class SystemMediaTransportControls

Public NotInheritable Class SystemMediaTransportControls

继承

Object Platform::Object IInspectable SystemMediaTransportControls

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

SystemMediaTransportControls 替换 MediaControl 类。 在 Windows 8.1 及更高版本中，应使用此控件而不是 MediaControl 来与系统传输控件交互。 系统传输控件使媒体应用程序开发人员能够与内置系统 UI 集成，以显示媒体元数据，例如艺术家、专辑标题或章节标题。 系统传输控件还允许用户使用内置系统 UI 控制媒体应用的播放，例如暂停播放以及在播放列表中向前和向后跳过。

从 Windows 10 版本 1607 开始，默认情况下，使用 MediaPlayer 类或 AudioGraph 类播放媒体的 UWP 应用会自动与 SMTC 集成。 只需实例化 MediaPlayer 的新实例，并将 MediaSource、MediaPlaybackItem 或 MediaPlaybackList 分配给玩家的 Source 属性，然后用户将在 SMTC 中看到你的应用名称，并且可以使用 SMTC 控件播放、暂停和在播放列表中移动。 通过访问 MediaPlayer 对象的 SystemMediaTransportControls 属性获取 SMTC 的实例。 有关从应用使用 SMTC 的操作指南，请参阅 与 SystemMediaTransportControls 集成。

在某些情况下，可能需要禁用与 SMTC 的自动集成。 在这种情况下，应通过将 IsEnabled 属性设置为 false 来禁用 MediaPlayer 对象的 CommandManager。 调用 GetForCurrentView 以获取当前视图的 SystemMediaTransportControls 实例。 如果面向较旧版本的 Windows，则还需要以这种方式获取实例。 有关手动控制 SMTC 的操作指南，请参阅 手动控制系统媒体传输控件。

属性

AutoRepeatMode	获取或设置一个值，该值表示 SystemMediaTransportControls 的当前自动重复模式。
DisplayUpdater	获取 SystemMediaTransportControls 的显示更新程序，该更新程序允许更新显示有关当前播放的歌曲的信息。
IsChannelDownEnabled	获取或设置一个值，该值指定是否支持通道向下按钮。
IsChannelUpEnabled	获取或设置一个值，该值指定是否支持通道向上按钮。
IsEnabled	启用和禁用应用的系统媒体传输控件。
IsFastForwardEnabled	获取或设置一个值，该值指定是否支持快进按钮。
IsNextEnabled	获取或设置一个值，该值指定是否支持下一个按钮。
IsPauseEnabled	获取或设置一个值，该值指定是否支持暂停按钮。如果支持暂停按钮，则为 true ;否则为 false。
IsPlayEnabled	获取或设置一个值，该值指定是否支持播放按钮。
IsPreviousEnabled	获取或设置一个值，该值指定是否支持上一个按钮。
IsRecordEnabled	获取或设置一个值，该值指定是否支持记录按钮。如果支持记录按钮，则为 true ;否则为 false。
IsRewindEnabled	获取或设置一个值，该值指定是否支持倒退按钮。
IsStopEnabled	获取或设置一个值，该值指定是否支持停止按钮。
PlaybackRate	获取或设置 SystemMediaTransportControls 的播放速率。
PlaybackStatus	获取或设置媒体的播放状态。
ShuffleEnabled	获取或设置一个值，该值表示 SystemMediaTransportControls 的当前随机状态。
SoundLevel	获取捕获和呈现流的媒体声音级别。

方法

GetForCurrentView()	当前视图的系统媒体传输控件。
UpdateTimelineProperties(SystemMediaTransportControlsTimelineProperties)	汇报 SystemMediaTransportControls 时间线属性以及所提供的 对象中的值。

事件

AutoRepeatModeChangeRequested	当用户修改 SystemMediaTransportControls 自动重复模式时发生。
ButtonPressed	在 SystemMediaTransportControls 上按下按钮时发生。
PlaybackPositionChangeRequested	当用户修改 SystemMediaTransportControls 的播放位置时发生。
PlaybackRateChangeRequested	当用户修改 SystemMediaTransportControls 播放速率时发生。
PropertyChanged	当 SystemMediaTransportControls 上的属性发生更改时发生。
ShuffleEnabledChangeRequested	当用户修改 SystemMediaTransportControls 随机状态时发生。

另请参阅

• 与 SystemMediaTransportControls 集成
• 手动控制系统媒体传输控件
• 系统媒体传输控件示例