MediaPlayer Klasse

Definition

Bietet Zugriff auf Medienwiedergabefunktionen wie Wiedergabe, Anhalten, Fast-Forward, Zurückspulen und Lautstärke.

public ref class MediaPlayer sealed
public ref class MediaPlayer sealed : IClosable
/// [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 MediaPlayer final
/// [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)]
/// [Windows.Foundation.Metadata.Activatable(196608, "Windows.Foundation.UniversalApiContract")]
class MediaPlayer final : IClosable
[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 MediaPlayer
[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)]
[Windows.Foundation.Metadata.Activatable(196608, "Windows.Foundation.UniversalApiContract")]
public sealed class MediaPlayer : System.IDisposable
function MediaPlayer()
Public NotInheritable Class MediaPlayer
Public NotInheritable Class MediaPlayer
Implements IDisposable
Vererbung
Object Platform::Object IInspectable MediaPlayer
Attribute
Implementiert

Windows-Anforderungen

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

Hinweise

Der Abschnitt Medienwiedergabe der Dokumentation enthält Anleitungen, die detaillierte Anleitungen zum Hinzufügen von Medienwiedergabefeatures zu Ihrer App enthalten. In der folgenden Tabelle sind einige der verfügbaren Artikel aufgeführt.

Thema BESCHREIBUNG
Wiedergeben von Audio- und Videoinhalten mit „MediaPlayer“ Zeigt Ihnen, wie Sie die neuen Features und Verbesserungen des Medienwiedergabesystems für UWP-Apps nutzen.
Medienelemente, Wiedergabelisten und Titel Zeigt, wie Sie die MediaSource-Klasse verwenden, die eine gängige Möglichkeit zum Verweisen und Wiedergeben von Medien aus verschiedenen Quellen wie lokalen oder Remotedateien bietet, und ein gemeinsames Modell für den Zugriff auf Mediendaten verfügbar macht, unabhängig vom zugrunde liegenden Medienformat.
Integration in die Steuerelemente für den Systemmedientransport Hier erfahren Sie, wie Sie Ihre App in die System Media Transport Controls (SMTC) integrieren.
Vom System unterstützte, zeitbasierte Metadaten-Marker Beschreibt, wie mehrere Formate von zeitlimitierten Metadaten genutzt werden, die in Mediendateien oder Datenströme eingebettet sein können.
Erstellen, Planen und Verwalten von Medienunterbrechungen Hier erfahren Sie, wie Sie Medienunterbrechungen für Ihre Medienwiedergabe-App erstellen, planen und verwalten.
Wiedergeben von Medien im Hintergrund Zeigt, wie Sie Ihre App so konfigurieren, dass Medien weiterhin wiedergegeben werden, wenn Ihre App vom Vordergrund in den Hintergrund wechselt.
Adaptives Streaming Beschreibt, wie Sie einer Universelle Windows-Plattform-App (UWP) die Wiedergabe adaptiver Streaming-Multimediainhalte hinzufügen.
Medienumwandlung Zeigt, wie Sie Medien aus einer universellen Windows-App auf Remotegeräte umwandeln.
PlayReady DRM Beschreibt, wie Sie Ihrer Universelle Windows-Plattform-App (UWP) durch PlayReady geschützte Medieninhalte hinzufügen.

SDK-Beispiele für die Medienwiedergabe

Die folgenden SDK-Beispiele veranschaulichen die Funktionen zur Medienwiedergabe, die für UWP-Apps unter Windows 10 verfügbar sind. Verwenden Sie diese Beispiele, um die APIs zur Medienwiedergabe im Kontext zu sehen, oder als Ausgangspunkt für Ihre eigene App.

Versionsverlauf

Windows-Version SDK-Version Mehrwert
1511 10586 AddAudioEffect
1511 10586 RemoveAllEffects
1607 14393 AddVideoEffect
1607 14393 AudioBalance
1607 14393 AudioDevice
1607 14393 BreakManager
1607 14393 CommandManager
1607 14393 GetAsCastingSource
1607 14393 GetSurface
1607 14393 IsMutedChanged
1607 14393 PlaybackSession
1607 14393 RealTimePlayback
1607 14393 SetSurfaceSize
1607 14393 SourceChanged
1607 14393 StepBackwardOneFrame
1607 14393 StepForwardOneFrame
1607 14393 StereoscopicVideoRenderMode
1607 14393 TimelineController
1607 14393 TimelineControllerPositionOffset
1703 15063 CopyFrameToStereoscopicVideoSurfaces
1703 15063 CopyFrameToVideoSurface(IDirect3DSurface)
1703 15063 CopyFrameToVideoSurface(IDirect3DSurface,Rect)
1703 15063 IsVideoFrameServerEnabled
1703 15063 VideoFrameAvailable
1709 16299 RenderSubtitlesToSurface(IDirect3DSurface)
1709 16299 RenderSubtitlesToSurface(IDirect3DSurface,Rect)
1709 16299 SubtitleFrameChanged
1803 17134 AudioStateMonitor

Konstruktoren

MediaPlayer()

Initialisiert eine neue instance des MediaPlayer-Objekts.

Eigenschaften

AudioBalance

Ruft ein Verhältnis der Lautstärke zwischen Stereolautsprechern ab oder legt dieses fest.

AudioCategory

Ruft den Audiotyp ab, der derzeit wiedergegeben wird, oder legt diesen fest.

AudioDevice

Ruft das DeviceInformation-Objekt ab, das das Audiogerät darstellt, das vom MediaPlayer zum Rendern von Audio verwendet wird, oder legt es fest.

AudioDeviceType

Ruft einen Wert ab, der die primäre Verwendung des Geräts beschreibt, das zur Wiedergabe von Audio verwendet wird, oder legt diesen fest.

AudioStateMonitor

Ruft ein AudioStateMonitor-Objekt ab, mit dem eine UWP-App bestimmen kann, ob einer der Audiodatenströme der App derzeit stummgeschaltet wird oder ob die Lautstärke vom System reduziert wird.

AutoPlay

Ruft einen booleschen Wert ab, der angibt, ob die Wiedergabe nach dem Laden des Mediums automatisch gestartet wird, oder legt diese fest.

BreakManager

Ruft den MediaBreakManager ab, der dem MediaPlayer zugeordnet ist, der Informationen zu und Steuerung von Medienunterbrechungen für den Player bereitstellt.

BufferingProgress

Ruft die Menge der Pufferung ab, die für den Medieninhalt abgeschlossen ist, ausgedrückt als Prozentsatz.

Hinweis

MediaPlayer.BufferingProgress kann nach Windows 10 Version 1607 geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen die MediaPlayer.PlaybackSession-Eigenschaft , um ein MediaPlaybackSession-Objekt abzurufen, und verwenden Sie dann die MediaPlaybackSession.BufferingProgress-Eigenschaft .

CanPause

Ruft einen booleschen Wert ab, der angibt, ob die Medien angehalten werden können.

Hinweis

MediaPlayer.CanPause kann nach Windows 10 Version 1607 geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen die MediaPlayer.PlaybackSession-Eigenschaft , um ein MediaPlaybackSession-Objekt abzurufen, und verwenden Sie dann die MediaPlaybackSession.CanPause-Eigenschaft .

CanSeek

Ruft einen booleschen Wert ab, der angibt, ob das Medium die Suche an einer bestimmten Position unterstützt.

Hinweis

MediaPlayer.CanSeek kann nach Windows 10 Version 1607 geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen die MediaPlayer.PlaybackSession-Eigenschaft , um ein MediaPlaybackSession-Objekt abzurufen, und verwenden Sie dann die MediaPlaybackSession.CanSeek-Eigenschaft .

CommandManager

Ruft den MediaPlaybackCommandManager ab, der dem MediaPlayer zugeordnet ist, der das Verhalten von und empfängt Ereignisse von den Systemmedientransportsteuerelementen.

CurrentState

Ruft den aktuellen Zustand der Medienwiedergabe ab.

Hinweis

MediaPlayer.CurrentState kann nach Windows 10 Version 1607 geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen die MediaPlayer.PlaybackSession-Eigenschaft , um ein MediaPlaybackSession-Objekt abzurufen, und verwenden Sie dann die MediaPlaybackSession.PlaybackState-Eigenschaft .

IsLoopingEnabled

Ruft einen booleschen Wert ab, der angibt, ob das Medium in einer wiederholten Schleife wiedergegeben wird, oder legt diesen fest.

IsMuted

Ruft einen booleschen Wert ab, der angibt, ob die Audiowiedergabe stummgeschaltet ist, oder legt diese fest.

IsProtected

Ruft einen booleschen Wert ab, der angibt, ob der Inhalt durch ein digitales Rechteverwaltungssystem geschützt ist.

Hinweis

MediaPlayer.IsProtected kann nach Windows 10 Version 1607 geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen die MediaPlayer.PlaybackSession-Eigenschaft , um ein MediaPlaybackSession-Objekt abzurufen, und verwenden Sie dann die IsProtected-Eigenschaft .

IsVideoFrameServerEnabled

Ruft einen Wert ab, der angibt, ob der Videoframeservermodus für den MediaPlayer-instance aktiviert ist.

NaturalDuration

Rufen Sie die tatsächliche Dauer der Medien ab, ohne die PlaybackRate anzuwenden.

Hinweis

MediaPlayer.NaturalDuration kann nach Windows 10 Version 1607 geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen die MediaPlayer.PlaybackSession-Eigenschaft , um ein MediaPlaybackSession-Objekt abzurufen, und verwenden Sie dann die MediaPlaybackSession.NaturalDuration-Eigenschaft .

PlaybackMediaMarkers

Ruft die Auflistung von Zeitleiste Markern für die Medien ab.

Hinweis

MediaPlayer.PlaybackMediaMarkers können nach Windows 10 Version 1607 geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen MediaPlaybackItem.TimedMetadataTracks , um Daten oder Texthinweise zu verwalten. Weitere Informationen finden Sie unter Medienwiedergabe mit MediaSource.

PlaybackRate

Ruft die Wiedergaberate ab, ausgedrückt als Verhältnis, oder legt sie fest.

Hinweis

MediaPlayer.PlaybackRate kann nach Windows 10 Version 1607 geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen die MediaPlayer.PlaybackSession-Eigenschaft , um ein MediaPlaybackSession-Objekt abzurufen, und verwenden Sie dann die MediaPlaybackSession.PlaybackRate-Eigenschaft .

PlaybackSession

Ruft die dem MediaPlayer zugeordnete MediaPlaybackSession ab, die Informationen zum Status der aktuellen Wiedergabesitzung bereitstellt und Ereignisse zum Reagieren auf Änderungen im Wiedergabesitzungszustand bereitstellt.

Position

Ruft die Wiedergabeposition innerhalb des Mediums ab oder legt diese fest.

Hinweis

MediaPlayer.Position kann nach Windows 10 Version 1607 geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen die MediaPlayer.PlaybackSession-Eigenschaft , um ein MediaPlaybackSession-Objekt abzurufen, und verwenden Sie dann die MediaPlaybackSession.Position-Eigenschaft .

ProtectionManager

Ruft den Inhaltsschutz-Manager für die Medien ab oder legt diese fest.

RealTimePlayback

Ruft einen Wert ab, der den MediaPlayer für Echtzeitszenarien wie Livestreamingvideos konfiguriert, oder legt diesen fest.

Source

Legt die Wiedergabequelle des Media Players fest.

StereoscopicVideoRenderMode

Ruft einen Wert ab, der den aktuellen stereoskopischen Rendermodus angibt, oder legt einen Wert fest.

SystemMediaTransportControls

Ruft einen instance der SystemMediaTransportControls-Klasse ab, um die Benutzersteuerung der Wiedergabe des MediaPlayer zu ermöglichen und der App das Anzeigen von Informationen über den aktuell wiedergegebenen Inhalt auf der Systemoberfläche zu ermöglichen.

TimelineController

Ruft den MediaTimelineController ab, der dem MediaPlayer zugeordnet ist, oder legt diese fest. Verwenden Sie diese Eigenschaft, um mehrere MediaPlayer-Instanzen mit einem einzelnen Zeitleiste-Steuerelement zu bearbeiten.

TimelineControllerPositionOffset

Ruft den Offset ab, der auf die Position des MediaTimelineController angewendet wird, der dem MediaPlayer zugeordnet ist, oder legt diesen fest.

Volume

Ruft die Audiolautstärke für die Medienwiedergabe ab oder legt sie fest.

Methoden

AddAudioEffect(String, Boolean, IPropertySet)

Fügt dem Wiedergabestream des MediaPlayers einen Audioeffekt hinzu.

AddVideoEffect(String, Boolean, IPropertySet)

Wendet einen Videoeffekt auf die Medienwiedergabe an.

Close()

Schließt den MediaPlayer und entsorgt die zugeordneten Ressourcen.

CopyFrameToStereoscopicVideoSurfaces(IDirect3DSurface, IDirect3DSurface)

Kopiert den derzeit vom MediaPlayer angezeigten Videorahmen in die beiden bereitgestellten IDirect3DSurface-Objekte , die den Inhalt des linken und rechten Auges eines stereoskopischen Videorahmens darstellen.

CopyFrameToVideoSurface(IDirect3DSurface)

Kopiert den aktuellen Videoframe aus dem MediaPlayer in das bereitgestellte IDirect3DSurface.

CopyFrameToVideoSurface(IDirect3DSurface, Rect)

Kopiert den aktuellen Videoframe aus dem MediaPlayer in das angegebene Zielrechteck innerhalb des bereitgestellten IDirect3DSurface.

Dispose()

Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen.

GetAsCastingSource()

Ruft eine CastingSource ab, die den MediaPlayer darstellt, sodass seine Medien auf andere Geräte umgewandelt werden können.

GetSurface(Compositor)

Ruft ein MediaPlayerSurface-Objekt für den MediaPlayer ab, mit dem Sie den Inhalt des Players mit einem Compositor rendern können, ohne sich auf das XAML-Framework zu verlassen.

Pause()

Hält die Medienwiedergabe an.

Play()

Startet die Medienwiedergabe.

RemoveAllEffects()

Entfernt alle Effekte aus dem Wiedergabestream des MediaPlayer.

RenderSubtitlesToSurface(IDirect3DSurface)

Fordert das System an, den aktuellen Untertiteltext in der bereitgestellten IDirect3DSurface zu rendern.

RenderSubtitlesToSurface(IDirect3DSurface, Rect)

Anforderungen an das System, den aktuellen Untertiteltext im angegebenen Zielrechteck innerhalb der bereitgestellten IDirect3DSurface zu rendern.

SetFileSource(IStorageFile)

Legen Sie die Medienquelle auf eine Datei fest.

Hinweis

MediaPlayer.SetFileSource kann geändert oder nicht mehr verfügbar sein, nachdem Windows 10. Verwenden Sie stattdessen MediaPlayer.Source .

SetMediaSource(IMediaSource)

Legt die Medienquelle für die Wiedergabe fest.

Hinweis

MediaPlayer.SetMediaSource kann geändert oder nicht mehr verfügbar sein, nachdem Windows 10. Verwenden Sie stattdessen MediaPlayer.Source .

SetStreamSource(IRandomAccessStream)

Legt die Medienquelle auf einen Stream fest.

Hinweis

MediaPlayer.SetMediaSource kann geändert oder nicht mehr verfügbar sein, nachdem Windows 10. Verwenden Sie stattdessen MediaPlayer.Source .

SetSurfaceSize(Size)

Legt die Größe der von GetSurface zurückgegebenen Kompositionsoberfläche fest.

SetUriSource(Uri)

Legt den Pfad zu den Medien fest.

Hinweis

MediaPlayer.SetUriSource kann geändert oder nicht mehr verfügbar sein, nachdem Windows 10. Verwenden Sie stattdessen MediaPlayer.Source .

StepBackwardOneFrame()

Bewirkt, dass sich die Wiedergabeposition des MediaPlayer um 0,042 Sekunden zurück bewegt, was einem Frame mit 24 fps entspricht, unabhängig von der tatsächlichen Bildfrequenz des wiedergegebenen Inhalts.

StepForwardOneFrame()

Bewirkt, dass sich der MediaPlayer in den aktuellen Medien um einen Frame vorwärts bewegt.

Ereignisse

BufferingEnded

Tritt bei Abschluss der Pufferung ein.

Hinweis

MediaPlayer.BufferingEnded kann nach Windows 10 Version 1607 geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen die MediaPlayer.PlaybackSession-Eigenschaft , um ein MediaPlaybackSession-Objekt abzurufen, und verwenden Sie dann das MediaPlaybackSession.BufferingEnded-Ereignis .

BufferingStarted

Tritt bei Beginn der Pufferung ein.

Hinweis

MediaPlayer.BufferingStarted kann nach Windows 10 Version 1607 geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen die MediaPlayer.PlaybackSession-Eigenschaft , um ein MediaPlaybackSession-Objekt abzurufen, und verwenden Sie dann das MediaPlaybackSession.BufferingStarted-Ereignis .

CurrentStateChanged

Tritt auf, wenn sich der Zustand des Medienplayers geändert hat.

Hinweis

MediaPlayer.CurrentStateChanged kann nach Windows 10 Version 1607 geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen die MediaPlayer.PlaybackSession-Eigenschaft , um ein MediaPlaybackSession-Objekt abzurufen, und verwenden Sie dann das MediaPlaybackSession.PlaybackStateChanged-Ereignis .

IsMutedChanged

Tritt auf, wenn sich die aktuelle stumme status des MediaPlayer ändert.

MediaEnded

Tritt auf, wenn die Wiedergabe des Mediums beendet ist.

MediaFailed

Tritt bei einem Fehler ein.

MediaOpened

Tritt auf, wenn das Medium geöffnet wird.

MediaPlayerRateChanged

Tritt auf, wenn sich die Medienwiedergaberate geändert hat.

Hinweis

MediaPlayer.MediaPlayerRateChanged kann nach Windows 10 Version 1607 geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen die MediaPlayer.PlaybackSession-Eigenschaft , um ein MediaPlaybackSession-Objekt abzurufen und dann das MediaPlaybackSession.PlaybackRateChanged-Ereignis zu verwenden.

PlaybackMediaMarkerReached

Tritt auf, wenn während der Wiedergabe ein Medienmarker erreicht wurde.

Hinweis

MediaPlayer.PlaybackMediaMarkerReached kann nach Windows 10 Version 1607 geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen MediaPlaybackItem.TimedMetadataTracks , um Daten oder Texthinweise zu verwalten. Weitere Informationen finden Sie unter Medienwiedergabe mit MediaSource.

SeekCompleted

Tritt auf, wenn ein Suchvorgang abgeschlossen ist.

Hinweis

MediaPlayer.SeekCompleted kann nach Windows 10 Version 1607 geändert oder nicht mehr verfügbar sein. Verwenden Sie stattdessen die MediaPlayer.PlaybackSession-Eigenschaft , um ein MediaPlaybackSession-Objekt abzurufen, und verwenden Sie dann das MediaPlaybackSession.SeekCompleted-Ereignis .

SourceChanged

Tritt auf, wenn sich die Medienquelle für den MediaPlayer ändert.

SubtitleFrameChanged

Tritt auf, wenn sich der aktuelle Untertitelinhalt geändert hat, während sich der MediaPlayer im Frameservermodus befindet.

VideoFrameAvailable

Tritt auf, wenn IsVideoFrameServerEnabled auf TRUE festgelegt ist und ein neuer Videoframe zur Verarbeitung verfügbar ist.

VolumeChanged

Tritt auf, wenn sich die Lautstärke der Audiodaten geändert hat.

Gilt für: