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 整合
• 系統媒體傳輸控制項的手動控制項
• 系統媒體傳輸控制項範例