SystemMediaTransportControls Klasse

Referenz

Definition

Namespace:: Windows.Media

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

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: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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.

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: