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.
Stellt Medienwiedergabe für Zeichnungen bereit.
public ref class MediaPlayer : System::Windows::Media::Animation::Animatablepublic class MediaPlayer : System.Windows.Media.Animation.Animatabletype MediaPlayer = class
inherit Animatable
interface DUCE.IResourcetype MediaPlayer = class
inherit AnimatablePublic Class MediaPlayer
Inherits Animatable- Vererbung
Beispiele
Gewusst wie: Wiedergeben von Medien mit einer VideoDrawing
Hinweise
Obwohl Sie eine instance dieser Klasse in Extensible Application Markup Language (XAML) deklarieren können, können Sie deren Medien nicht laden und wiedergeben, ohne Code zu verwenden. Um Medien nur in XAML wiederzugeben, verwenden Sie ein MediaElement. Wenn Sie eine instance in XAML deklarieren, besteht die einzige praktische Verwendung darin, eigenschaftenelementsyntax für die Player Eigenschaft zu füllen.
Wenn Sie Medien mit der Anwendung verteilen, ist es nicht möglich, eine Mediendatei als Projektressource zu verwenden. In der Projektdatei müssen Sie stattdessen den Medientyp auf Content festlegen, und CopyToOutputDirectory auf PreserveNewest oder Always.
MediaPlayer kann in zwei verschiedenen Modi verwendet werden, je nachdem, was den Player antreibt: unabhängigen Modus oder Taktmodus. Im unabhängigen Modus ist das MediaPlayer analog zu einem Bild, und das über die Methode geöffnete Medium steuert die Open Wiedergabe. Im Uhrmodus kann das MediaPlayer als Ziel für eine Animation betrachtet werden, und daher verfügt es über entsprechende Timeline Einträge in Clock der Zeitsteuerungsstruktur, die die Wiedergabe steuert. Weitere Informationen zu Medienmodi finden Sie in der Multimediaübersicht.
MediaPlayer unterscheidet sich dadurch MediaElement , dass es sich nicht um ein Steuerelement handelt, das direkt zur Benutzeroberfläche einer Anwendung hinzugefügt werden kann. Zum Anzeigen von Medien, die mit MediaPlayergeladen wurden, muss ein VideoDrawing oder DrawingContext verwendet werden.
Konstruktoren
| MediaPlayer() |
Initialisiert eine neue Instanz der MediaPlayer-Klasse. |
Eigenschaften
| Balance |
Ruft das Verhältnis zwischen der Lautstärke des linken und rechten Lautsprechers ab oder legt dieses fest. |
| BufferingProgress |
Ruft den Prozentsatz der abgeschlossenen Pufferung für das Streaming von Inhalten ab. |
| CanFreeze |
Ruft einen Wert ab, der anzeigt, ob das Objekt als nicht änderbar festgelegt werden kann. (Geerbt von Freezable) |
| CanPause |
Ruft einen Wert ab, der angibt, ob die Medien angehalten werden können. |
| Clock |
Ruft die MediaClock ab, die der wiederzugebenden MediaTimeline zugeordnet ist, oder legt diese fest. |
| DependencyObjectType |
Ruft den ab, der DependencyObjectType den CLR-Typ dieses instance umschließt. (Geerbt von DependencyObject) |
| Dispatcher |
Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist. (Geerbt von DispatcherObject) |
| DownloadProgress |
Ruft den Prozentwert des Downloadfortschritts für Inhalt auf einem Remoteserver ab. |
| HasAnimatedProperties |
Ruft einen Wert ab, der angibt, ob einer der Abhängigkeitseigenschaften dieses Objekts ein oder mehrere AnimationClock-Objekte zugeordnet sind. (Geerbt von Animatable) |
| HasAudio |
Ruft einen Wert ab, der angibt, ob die Medien über Audioausgabe verfügen. |
| HasVideo |
Ruft einen Wert ab, der angibt, ob die Medien über Videoausgabe verfügen. |
| IsBuffering |
Ruft einen Wert ab, der angibt, ob die Medien gepuffert werden. |
| IsFrozen |
Ruft einen Wert ab, der angibt, ob das Objekt derzeit geändert werden kann. (Geerbt von Freezable) |
| IsMuted |
Ruft einen Wert ab, der angibt, ob die Medien stumm geschaltet sind. |
| IsSealed |
Ruft einen Wert ab, der angibt, ob diese Instanz derzeit versiegelt (schreibgeschützt) ist. (Geerbt von DependencyObject) |
| NaturalDuration |
Ruft die interne Dauer der Medien ab. |
| NaturalVideoHeight |
Ruft die Pixelhöhe des Videos ab. |
| NaturalVideoWidth |
Ruft die Pixelbreite des Videos ab. |
| Position |
Ruft die aktuelle Position der Medien ab oder legt diese fest. |
| ScrubbingEnabled |
Ruft einen Wert ab, mit dem angegeben wird, ob Bereinigen aktiviert ist, oder legt diesen Wert fest. |
| Source |
Ruft den Medien-Uri ab. |
| SpeedRatio |
Ruft das Geschwindigkeitsverhältnis der Medienwiedergabe ab oder legt dieses fest. |
| Volume |
Ruft die Lautstärke des Mediums ab oder legt sie fest. |
Methoden
| ApplyAnimationClock(DependencyProperty, AnimationClock) |
Wendet einen AnimationClock auf die angegebene DependencyProperty an. Wenn die Eigenschaft bereits animiert wird, wird das SnapshotAndReplace-Übergabeverhalten verwendet. (Geerbt von Animatable) |
| ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) |
Wendet einen AnimationClock auf die angegebene DependencyProperty an. Wenn die Eigenschaft bereits animiert wird, wird das angegebene HandoffBehavior verwendet. (Geerbt von Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline) |
Wendet eine Animation auf die angegebene DependencyProperty an. Die Animation wird gestartet, wenn der nächste Frame gerendert wird. Wenn die angegebene Eigenschaft bereits animiert wird, wird das SnapshotAndReplace-Übergabeverhalten verwendet. (Geerbt von Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) |
Wendet eine Animation auf die angegebene DependencyProperty an. Die Animation wird gestartet, wenn der nächste Frame gerendert wird. Wenn die angegebene Eigenschaft bereits animiert wird, wird das angegebene HandoffBehavior verwendet. (Geerbt von Animatable) |
| CheckAccess() |
Bestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Geerbt von DispatcherObject) |
| ClearValue(DependencyProperty) |
Löscht den lokalen Wert einer Eigenschaft. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyProperty-Bezeichner angegeben. (Geerbt von DependencyObject) |
| ClearValue(DependencyPropertyKey) |
Löscht den lokalen Wert einer schreibgeschützten Eigenschaft. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyPropertyKey angegeben. (Geerbt von DependencyObject) |
| Clone() |
Erstellt einen änderbaren Klon dieser Animatable, indem tiefe Kopien der Werte dieses Objekts erzeugt werden. Beim Kopieren von Abhängigkeitseigenschaften dieses Objekts kopiert diese Methode Ressourcenverweise und Datenbindungen (die jedoch möglicherweise nicht mehr aufgelöst werden können), jedoch keine Animationen oder ihre aktuellen Werte. (Geerbt von Animatable) |
| CloneCore(Freezable) |
Macht diese Instanz zu einer tiefen Kopie der angegebenen MediaPlayer. Beim Kopieren von Abhängigkeitseigenschaften kopiert diese Methode Ressourcenverweise und Datenbindungen (die aber möglicherweise nicht mehr aufgelöst werden können), jedoch keine Animationen oder ihre aktuellen Werte. |
| CloneCurrentValue() |
Erstellt einen änderbaren Klon (tiefe Kopie) von Freezable mit den aktuellen Werten. (Geerbt von Freezable) |
| CloneCurrentValueCore(Freezable) |
Macht diese Instanz mithilfe aktueller Eigenschaftswerte zu einer tiefen Kopie der angegebenen MediaPlayer, die geändert werden kann. Ressourcenverweise, Datenbindungen und Animationen werden nicht kopiert, ihre aktuellen Werte werden jedoch kopiert. |
| Close() |
Schließt die zugrunde liegenden Medien. |
| CoerceValue(DependencyProperty) |
Erzwingt den Wert der angegebenen Abhängigkeitseigenschaft. Dies erfolgt durch den Aufruf einer beliebigen CoerceValueCallback-Funktion, die in den Metadaten für die Abhängigkeitseigenschaft angegeben ist, während sie beim aufrufenden DependencyObject beendet wird. (Geerbt von DependencyObject) |
| CreateInstance() |
Initialisiert eine neue Instanz der Freezable-Klasse. (Geerbt von Freezable) |
| CreateInstanceCore() |
Erstellt eine neue MediaPlayer-Instanz. |
| Equals(Object) |
Bestimmt, ob ein angegebenes DependencyObject dem aktuellen DependencyObject entspricht. (Geerbt von DependencyObject) |
| Freeze() |
Definiert das aktuelle Objekt als nicht änderbar und legt seine IsFrozen-Eigenschaft auf |
| FreezeCore(Boolean) |
Legt dieses Animatable-Objekt als nicht änderbar fest oder bestimmt, ob es als nicht änderbar festgelegt werden kann. (Geerbt von Animatable) |
| GetAnimationBaseValue(DependencyProperty) |
Gibt den nicht animierten Wert der angegebenen DependencyProperty zurück. (Geerbt von Animatable) |
| GetAsFrozen() |
Erstellt eine fixierte Kopie von Freezable mit Basiseigenschaftswerten (nicht animiert). Da die Kopie fixiert ist, werden alle fixierten Unterobjekte als Verweis kopiert. (Geerbt von Freezable) |
| GetAsFrozenCore(Freezable) |
Macht diese Instanz zu einem Klon des angegebenen MediaPlayer-Objekts. |
| GetCurrentValueAsFrozen() |
Erstellt eine fixierte Kopie von Freezable mit aktuellen Eigenschaftswerten. Da die Kopie fixiert ist, werden alle fixierten Unterobjekte als Verweis kopiert. (Geerbt von Freezable) |
| GetCurrentValueAsFrozenCore(Freezable) |
Macht diese aktuelle Instanz zu einem fixierten Klon des angegebenen Freezable-Objekts. Wenn das Objekt über animierte Abhängigkeitseigenschaften verfügt, werden die aktuellen animierten Werte kopiert. (Geerbt von Freezable) |
| GetHashCode() |
Ruft einen Hashcode für diese DependencyObject ab. (Geerbt von DependencyObject) |
| GetLocalValueEnumerator() |
Erstellt einen spezialisierten Enumerator, mit dem bestimmt wird, welche Abhängigkeitseigenschaften dieses DependencyObject über lokal festgelegte Werte verfügen. (Geerbt von DependencyObject) |
| GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
| GetValue(DependencyProperty) |
Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz eines DependencyObject zurück. (Geerbt von DependencyObject) |
| InvalidateProperty(DependencyProperty) |
Wertet den effektiven Wert für die angegebene Abhängigkeitseigenschaft erneut aus. (Geerbt von DependencyObject) |
| MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
| OnChanged() |
Wird aufgerufen, wenn das aktuelle Freezable-Objekt geändert wird. (Geerbt von Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject) |
Stellt sicher, dass entsprechende Kontextzeiger für einen gerade festgelegten DependencyObjectType-Datenmember eingerichtet werden. (Geerbt von Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) |
Dieses Member unterstützt die Windows Presentation Foundation -Infrastruktur (WPF) und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. (Geerbt von Freezable) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Überschreibt die DependencyObject-Implementierung von OnPropertyChanged(DependencyPropertyChangedEventArgs), damit in Reaktion auf eine geänderte Abhängigkeitseigenschaft des Typs Freezable auch Changed-Handler aufgerufen werden. (Geerbt von Freezable) |
| Open(Uri) |
Öffnet den angegebenen Uri für die Medienwiedergabe. |
| Pause() |
Hält die Medienwiedergabe an. |
| Play() |
Gibt Medien ab der aktuellen Position wieder. |
| ReadLocalValue(DependencyProperty) |
Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn dieser vorhanden ist. (Geerbt von DependencyObject) |
| ReadPreamble() |
Stellt sicher, dass über einen gültigen Thread auf den MediaPlayer zugegriffen wird. |
| SetCurrentValue(DependencyProperty, Object) |
Legt den Wert einer Abhängigkeitseigenschaft fest, ohne deren Wertquelle zu ändern. (Geerbt von DependencyObject) |
| SetValue(DependencyProperty, Object) |
Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch ihren Bezeichner angegeben ist. (Geerbt von DependencyObject) |
| SetValue(DependencyPropertyKey, Object) |
Legt den lokalen Wert einer schreibgeschützten Abhängigkeitseigenschaft fest, die durch den DependencyPropertyKey-Bezeichner der Abhängigkeitseigenschaft angegeben ist. (Geerbt von DependencyObject) |
| ShouldSerializeProperty(DependencyProperty) |
Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert der bereitgestellten Abhängigkeitseigenschaft serialisieren sollen. (Geerbt von DependencyObject) |
| Stop() |
Beendet die Medienwiedergabe. |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
| VerifyAccess() |
Erzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Geerbt von DispatcherObject) |
| WritePostscript() |
Löst das Changed-Ereignis für das Freezable-Objekt aus und ruft dessen OnChanged()-Methode auf. Klassen, die aus Freezable abgeleitet werden, sollten diese Methode am Ende jeder API aufrufen, die Klassenmember ändert, die nicht als Abhängigkeitseigenschaften gespeichert sind. (Geerbt von Freezable) |
| WritePreamble() |
Stellt sicher, dass der MediaPlayer nicht fixiert ist und dass über einen gültigen Threadkontext auf den MediaPlayer zugegriffen wird. |
Ereignisse
| BufferingEnded |
Tritt bei Abschluss der Pufferung ein. |
| BufferingStarted |
Tritt bei Beginn der Pufferung ein. |
| Changed |
Tritt auf, wenn Freezable oder ein darin enthaltenes Objekt geändert wird. (Geerbt von Freezable) |
| 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. |
| ScriptCommand |
Tritt ein, wenn in den Medien ein Skriptbefehl gefunden wurde. |
