SystemMediaTransportControlsDisplayUpdater 类

定义

命名空间:

Windows.Media

提供更新 SystemMediaTransportControls 上显示的音乐信息的功能。

public ref class SystemMediaTransportControlsDisplayUpdater 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.Both)]
class SystemMediaTransportControlsDisplayUpdater 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.Both)]
public sealed class SystemMediaTransportControlsDisplayUpdater

Public NotInheritable Class SystemMediaTransportControlsDisplayUpdater

继承

Object Platform::Object IInspectable SystemMediaTransportControlsDisplayUpdater

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

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

注解

从 Windows 10 版本 1607 开始，使用 MediaPlayer 类播放媒体的 UWP 应用默认自动与 SMTC 集成。 通过自动集成，可以使用 MediaPlaybackItem 类更新媒体元数据，例如媒体项的标题。 调用 GetDisplayProperties 以获取 MediaItemDisplayProperties 类的实例。 使用要在 SMTC 中为项显示的值更新 对象，然后调用 ApplyDisplayProperties 以提交更改。 有关从应用使用 SMTC 的操作指南，请参阅 与 SystemMediaTransportControls 集成。

如果要禁用手动 SMTC 集成或面向较旧版本的 Windows，则必须使用 SystemMediaTransportControls.DisplayUpdater 更新媒体元数据。 有关手动控制 SMTC 的操作指南，请参阅 手动控制系统媒体传输控件。

属性

AppMediaId	获取或设置应用的媒体 ID。
ImageProperties	获取与当前正在播放的媒体关联的图像属性。
MusicProperties	获取与当前播放的媒体关联的音乐属性。
Thumbnail	获取或设置与当前正在播放的媒体关联的缩略图。
Type	获取或设置媒体的类型。
VideoProperties	获取与当前正在播放的媒体关联的视频属性。

方法

ClearAll()	清除所有媒体元数据。
CopyFromFileAsync(MediaPlaybackType, StorageFile)	使用指定的文件初始化媒体属性。
Update()	汇报当前正在播放的媒体的元数据。

另请参阅

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