MediaPlayer Klasse
Definition
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.
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
- 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.
- 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. |