SystemMediaTransportControlsDisplayUpdater 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 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:

Freigeben über