共用方式為


SystemMediaTransportControls 類別

定義

表示 物件,可啟用與系統媒體傳輸控制項的整合,並支援媒體命令。

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
屬性

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 的新實例,並將 MediaSourceMediaPlaybackItemMediaPlaybackList 指派給玩家的 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 隨機顯示狀態時。

適用於

另請參閱