SystemMediaTransportControlsDisplayUpdater Klasse

  • Referenz

Definition

Namespace:
Windows.Media
Bearbeiten

Stellt Funktionen zum Aktualisieren der Musikinformationen bereit, die in SystemMediaTransportControls angezeigt werden.

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

Ab Windows 10, Version 1607, sind UWP-Apps, die die MediaPlayer-Klasse für die Medienwiedergabe verwenden, automatisch in SMTC integriert. Bei der automatischen Integration aktualisieren Sie die Medienmetadaten, z. B. den Titel eines Medienelements, mithilfe der MediaPlaybackItem-Klasse . Rufen Sie GetDisplayProperties auf, um eine instance der MediaItemDisplayProperties-Klasse abzurufen. Aktualisieren Sie das Objekt mit den Werten, die für das Element im SMTC angezeigt werden sollen, und rufen Sie dann ApplyDisplayProperties auf, um die Änderungen zu committen. Anleitungen zur Verwendung von SMTC in Ihrer App finden Sie unter Integrieren in SystemMediaTransportControls.

Wenn Sie die manuelle SMTC-Integration deaktivieren oder eine ältere Version von Windows als Ziel verwenden, müssen Sie systemMediaTransportControls.DisplayUpdater verwenden, um die Medienmetadaten zu aktualisieren. Anleitungen zum manuellen Steuern des SMTC finden Sie unter Manuelle Steuerung der Steuerelemente für den Systemmedientransport.

Eigenschaften

AppMediaId

Ruft die Medien-ID der App ab oder legt sie fest.
ImageProperties

Ruft die Bildeigenschaften ab, die den aktuell wiedergegebenen Medien zugeordnet sind.
MusicProperties

Ruft die Musikeigenschaften ab, die den aktuell wiedergegebenen Medien zugeordnet sind.
Thumbnail

Ruft Miniaturansichten ab, die den aktuell wiedergegebenen Medien zugeordnet sind, oder legt dieses fest.
Type

Ruft den Medientyp ab oder legt den Typ fest.
VideoProperties

Ruft die Videoeigenschaften ab, die den aktuell wiedergegebenen Medien zugeordnet sind.

Methoden

ClearAll()

Löscht alle Medienmetadaten.
CopyFromFileAsync(MediaPlaybackType, StorageFile)

Initialisieren Sie die Medieneigenschaften mithilfe der angegebenen Datei.
Update()

Updates die Metadaten für die derzeit wiedergegebenen Medien.

Gilt für:

Weitere Informationen