共用方式為

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 app 會根據預設，自動與 SMTC 整合。 透過自動整合，您可以使用 MediaPlaybackItem 類別來更新媒體中繼資料，例如媒體專案的標題。 呼叫 GetDisplayProperties 以取得 MediaItemDisplayProperties 類別的實例。 使用您想要針對 SMTC 中專案顯示的值來更新物件，然後呼叫 ApplyDisplayProperties 以認可變更。 如需如何從您的應用程式使用 SMTC 的指引，請參閱 與 SystemMediaTransportControls 整合。

如果您要停用手動 SMTC 整合，或以舊版 Windows 為目標，則必須使用 SystemMediaTransportControls.DisplayUpdater 來更新媒體中繼資料。 如需手動控制 SMTC 的作法指引，請參閱 手動控制系統媒體傳輸控制項。

屬性

AppMediaId

取得或設定應用程式的媒體識別碼。
ImageProperties

取得與目前播放媒體相關聯的影像屬性。
MusicProperties

取得與目前播放媒體相關聯的音樂屬性。
Thumbnail

取得或設定與目前播放媒體相關聯的縮圖影像。
Type

取得或設定媒體的類型。
VideoProperties

取得與目前播放媒體相關聯的視訊屬性。

方法

ClearAll()

清除所有媒體中繼資料。
CopyFromFileAsync(MediaPlaybackType, StorageFile)

使用指定的檔案初始化媒體屬性。
Update()

更新目前播放媒體的中繼資料。

適用於

另請參閱