Freigeben über


SystemMediaTransportControls Klasse

Definition

Stellt ein -Objekt dar, das die Integration in die Steuerelemente für den Systemmedientransport und die Unterstützung für Medienbefehle ermöglicht.

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
Vererbung
Object Platform::Object IInspectable SystemMediaTransportControls
Attribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

SystemMediaTransportControls ersetzt die MediaControl-Klasse . In Windows 8.1 und höher sollten Sie dieses Steuerelement anstelle von MediaControl verwenden, um mit den Systemtransportsteuerelementen zu interagieren. Mithilfe der Steuerelemente für den Systemtransport können Entwickler von Medienanwendungen in die integrierte Systembenutzeroberfläche integrieren, um Medienmetadaten wie Künstler, Albumtitel oder Kapiteltitel anzuzeigen. Mit dem Systemtransport-Steuerelement kann ein Benutzer auch die Wiedergabe einer Medien-App über die integrierte Systembenutzeroberfläche steuern, z. B. die Wiedergabe anhalten und in einer Wiedergabeliste vorwärts und rückwärts überspringen.

System Media Transtport-Steuerelemente

Ab Windows 10 Version 1607 werden UWP-Apps, die die MediaPlayer-Klasse oder die AudioGraph-Klasse zum Wiedergeben von Medien verwenden, standardmäßig automatisch in smTC integriert. Instanziieren Sie einfach eine neue instance von MediaPlayer, und weisen Sie der Source-Eigenschaft des Players ein MediaSource-, MediaPlaybackItem- oder MediaPlaybackList-Element zu. Der Benutzer sieht den App-Namen im SMTC und kann ihre Wiedergabelisten mithilfe der SMTC-Steuerelemente wiedergeben, anhalten und durch ihre Wiedergabelisten navigieren. Rufen Sie eine instance des SMTC ab, indem Sie auf die SystemMediaTransportControls-Eigenschaft des MediaPlayer-Objekts zugreifen. Anleitungen zur Verwendung von SMTC in Ihrer App finden Sie unter Integrieren in SystemMediaTransportControls.

In einigen Szenarien können Sie die automatische Integration in smtc deaktivieren. In diesem Fall sollten Sie den CommandManager des MediaPlayer-Objekts deaktivieren, indem Sie die IsEnabled-Eigenschaft auf false festlegen. Rufen Sie GetForCurrentView auf, um eine instance der SystemMediaTransportControls für die aktuelle Ansicht abzurufen. Sie müssen auch eine instance auf diese Weise erhalten, wenn Sie eine ältere Version von Windows als Ziel verwenden. Anleitungen zum manuellen Steuern des SMTC finden Sie unter Manuelle Steuerung der Steuerelemente für den Systemmedientransport.

Eigenschaften

AutoRepeatMode

Ruft einen Wert ab, der den aktuellen Modus der automatischen Wiederholung von SystemMediaTransportControls darstellt, oder legt diesen fest.

DisplayUpdater

Ruft den Anzeigeupdater für systemMediaTransportControls ab, der das Aktualisieren der Informationen zum aktuell wiedergegebenen Song ermöglicht.

IsChannelDownEnabled

Ruft einen Wert ab, der angibt, ob die Schaltfläche "Kanal unten" unterstützt wird, oder legt diesen fest.

IsChannelUpEnabled

Ruft einen Wert ab, der angibt, ob die Schaltfläche "Kanal nach oben" unterstützt wird, oder legt diesen fest.

IsEnabled

Aktiviert und deaktiviert die Steuerelemente für den Systemmedientransport für die App.

IsFastForwardEnabled

Ruft einen Wert ab, der angibt, ob die Schnellvorlaufschaltfläche unterstützt wird, oder legt diesen fest.

IsNextEnabled

Ruft einen Wert ab, der angibt, ob die nächste Schaltfläche unterstützt wird, oder legt diesen fest.

IsPauseEnabled

Ruft einen Wert ab, der angibt, ob die Pausenschaltfläche unterstützt wird, oder legt diesen fest. TRUE , wenn die Pausenschaltfläche unterstützt wird; Andernfalls false.

IsPlayEnabled

Ruft einen Wert ab, der angibt, ob die Wiedergabeschaltfläche unterstützt wird, oder legt diesen fest.

IsPreviousEnabled

Ruft einen Wert ab, der angibt, ob die vorherige Schaltfläche unterstützt wird, oder legt diesen fest.

IsRecordEnabled

Ruft einen Wert ab, der angibt, ob die Datensatzschaltfläche unterstützt wird, oder legt diesen fest. TRUE , wenn die Datensatzschaltfläche unterstützt wird; Andernfalls false.

IsRewindEnabled

Ruft einen Wert ab, der angibt, ob die Zurückspulenschaltfläche unterstützt wird, oder legt diesen fest.

IsStopEnabled

Ruft einen Wert ab, der angibt, ob die Stoppschaltfläche unterstützt wird, oder legt diesen fest.

PlaybackRate

Ruft die Wiedergaberate von SystemMediaTransportControls ab oder legt diese fest.

PlaybackStatus

Ruft die Wiedergabe status der Medien ab oder legt diese fest.

ShuffleEnabled

Ruft einen Wert ab, der den aktuellen Shufflezustand von SystemMediaTransportControls darstellt, oder legt einen Wert fest.

SoundLevel

Ruft den Soundpegel der Medien für die Aufnahme- und Renderdatenströme ab.

Methoden

GetForCurrentView()

Die Systemmedientransportsteuerelemente für die aktuelle Ansicht.

UpdateTimelineProperties(SystemMediaTransportControlsTimelineProperties)

Updates die Eigenschaften systemMediaTransportControls Zeitleiste mit den Werten im bereitgestellten Objekt.

Ereignisse

AutoRepeatModeChangeRequested

Tritt auf, wenn der Benutzer den Automatisch wiederholenden SystemMediaTransportControls-Modus ändert.

ButtonPressed

Tritt auf, wenn eine Schaltfläche auf systemMediaTransportControls gedrückt wird.

PlaybackPositionChangeRequested

Tritt auf, wenn der Benutzer die Wiedergabeposition von SystemMediaTransportControls ändert.

PlaybackRateChangeRequested

Tritt auf, wenn der Benutzer die SystemMediaTransportControls-Wiedergaberate ändert.

PropertyChanged

Tritt auf, wenn sich eine Eigenschaft für SystemMediaTransportControls geändert hat.

ShuffleEnabledChangeRequested

Tritt auf, wenn der Benutzer den Shufflezustand systemMediaTransportControls ändert.

Gilt für:

Weitere Informationen