MediaPlayer Klasse

Definition

Namespace:

Windows.Media.Playback

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

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)]
/// [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)]
[Windows.Foundation.Metadata.Activatable(196608, "Windows.Foundation.UniversalApiContract")]
public sealed class MediaPlayer : System.IDisposable

function MediaPlayer()

Public NotInheritable Class MediaPlayer
Implements IDisposable

Vererbung

Object Platform::Object IInspectable MediaPlayer

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ActivatableAttribute

Implementiert

IClosable IDisposable

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.

• Beispiel für adaptives Streaming
• Hintergrundaudio-Beispiel
• Beispiel für den Systemmedientransport
• 360-Grad-Videowiedergabebeispiel
• Beispiel für die Hintergrundmedienwiedergabe
• Beispiel für die Videowiedergabesynchronisierung

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.