MediaPlayer Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit la lecture du média pour les dessins.
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- Héritage
Exemples
Comment : lire un média à l'aide d'un VideoDrawing
Remarques
Bien que vous puissiez déclarer un instance de cette classe en XAML (Extensible Application Markup Language), vous ne pouvez pas charger et lire son média sans utiliser de code. Pour lire du contenu multimédia en XAML uniquement, utilisez un MediaElement. En outre, si vous déclarez une instance en XAML, la seule utilisation pratique consiste à remplir la syntaxe d’élément de propriété pour la Player propriété.
Lorsque vous distribuez un contenu multimédia avec votre application, vous ne pouvez pas utiliser de fichier multimédia comme ressource de projet. Dans votre fichier projet, vous devez plutôt définir le type de média sur Content et définir CopyToOutputDirectory sur PreserveNewest ou Always.
MediaPlayer peut être utilisé dans deux modes différents, en fonction de ce qui conduit le joueur : le mode indépendant ou le mode horloge. En mode indépendant, est MediaPlayer analogue à une image et le média ouvert via la lecture des lecteurs de méthode Open . En mode Horloge, le MediaPlayer peut être considéré comme une cible pour une animation. Par conséquent, il aura des entrées et Clock correspondantes Timeline dans l’arborescence de minutage qui contrôle la lecture. Pour plus d’informations sur les modes multimédias, consultez vue d’ensemble du multimédia.
MediaPlayer est différent d’un MediaElement en ce qu’il ne s’agit pas d’un contrôle qui peut être ajouté directement à l’interface utilisateur d’une application. Pour afficher le média chargé à l’aide de MediaPlayer, un VideoDrawing ou DrawingContext doit être utilisé.
Constructeurs
| MediaPlayer() |
Initialise une nouvelle instance de la classe MediaPlayer. |
Propriétés
| Balance |
Obtient ou définit l'équilibre entre les volumes des haut-parleurs gauche et droit. |
| BufferingProgress |
Obtient le pourcentage de la mise en mémoire tampon complété pour le contenu en continu. |
| CanFreeze |
Obtient une valeur qui indique si l’objet peut être rendu non modifiable. (Hérité de Freezable) |
| CanPause |
Obtient une valeur indiquant si le média peut être suspendu. |
| Clock |
Obtient ou définit l'MediaClock associé à la MediaTimeline à lire. |
| DependencyObjectType |
Obtient le DependencyObjectType qui encapsule le type CLR de cette instance. (Hérité de DependencyObject) |
| Dispatcher |
Obtient le Dispatcher associé à DispatcherObject. (Hérité de DispatcherObject) |
| DownloadProgress |
Obtient le pourcentage de progression du téléchargement pour le contenu localisé au niveau d'un serveur distant. |
| HasAnimatedProperties |
Obtient une valeur qui indique si un ou plusieurs objets AnimationClock sont associés à l'une ou l'autre des propriétés de dépendance de cet objet. (Hérité de Animatable) |
| HasAudio |
Obtient une valeur indiquant si le média possède une sortie audio. |
| HasVideo |
Obtient une valeur qui indique si le média possède une sortie vidéo. |
| IsBuffering |
Obtient une valeur qui indique si le média est mis en mémoire tampon. |
| IsFrozen |
Obtient une valeur qui indique si l’objet est actuellement modifiable. (Hérité de Freezable) |
| IsMuted |
Obtient une valeur qui indique si le média est muet. |
| IsSealed |
Récupère une valeur qui indique si cette instance est actuellement sealed (en lecture seule). (Hérité de DependencyObject) |
| NaturalDuration |
Obtient la durée naturelle du média. |
| NaturalVideoHeight |
Obtient la hauteur en pixels de la vidéo. |
| NaturalVideoWidth |
Obtient la largeur en pixels de la vidéo. |
| Position |
Obtient ou définit la position actuelle du média. |
| ScrubbingEnabled |
Obtient ou définit une valeur qui indique si le préchargement est activé. |
| Source |
Obtient le média Uri. |
| SpeedRatio |
Obtient ou définit le taux de variation de la vitesse à laquelle le média est lu. |
| Volume |
Obtient ou définit le volume du média. |
Méthodes
| ApplyAnimationClock(DependencyProperty, AnimationClock) |
Applique AnimationClock au DependencyProperty spécifié. Si la propriété est déjà animée, le comportement de transfert SnapshotAndReplace est utilisé. (Hérité de Animatable) |
| ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) |
Applique AnimationClock au DependencyProperty spécifié. Si la propriété spécifiée est déjà animée, le comportement HandoffBehavior spécifié est utilisé. (Hérité de Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline) |
Applique une animation au DependencyProperty spécifié. L’animation est démarrée lors de la restitution de l’image suivante. Si la propriété spécifiée est déjà animée, le comportement de transfert SnapshotAndReplace est utilisé. (Hérité de Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) |
Applique une animation au DependencyProperty spécifié. L’animation est démarrée lors de la restitution de l’image suivante. Si la propriété spécifiée est déjà animée, le comportement HandoffBehavior spécifié est utilisé. (Hérité de Animatable) |
| CheckAccess() |
Détermine si le thread appelant a accès à ce DispatcherObject. (Hérité de DispatcherObject) |
| ClearValue(DependencyProperty) |
Efface la valeur locale d’une propriété. La propriété à effacer est spécifiée par un identificateur DependencyProperty. (Hérité de DependencyObject) |
| ClearValue(DependencyPropertyKey) |
Efface la valeur locale d’une propriété en lecture seule. La propriété à effacer est spécifiée par DependencyPropertyKey. (Hérité de DependencyObject) |
| Clone() |
Crée un clone modifiable de ce Animatable, en créant des copies complètes des valeurs de cet objet. Lors de la copie de propriétés de dépendance de cet objet, cette méthode copie les références de ressource et les liaisons de données (lesquelles risquent de ne plus pouvoir se résoudre), mais non les animations ou leurs valeurs actuelles. (Hérité de Animatable) |
| CloneCore(Freezable) |
Convertit cette instance en copie complète de l’objet MediaPlayer spécifié. Pendant la copie des propriétés de dépendance, cette méthode copie les références de ressources et les liaisons de données (qui risquent toutefois de ne plus pouvoir se résoudre), mais pas les animations ni leurs valeurs actuelles. |
| CloneCurrentValue() |
Crée un clone modifiable (copie complète) de Freezable en utilisant ses valeurs actuelles. (Hérité de Freezable) |
| CloneCurrentValueCore(Freezable) |
Convertit cette instance en copie complète modifiable de l’objet MediaPlayer spécifié à l’aide des valeurs de propriété actuelles. Contrairement à leurs valeurs actuelles, les références de ressources, les liaisons de données et les animations ne sont pas copiées. |
| Close() |
Ferme le média sous-jacent. |
| CoerceValue(DependencyProperty) |
Convertit la valeur de la propriété de dépendance spécifiée. Pour cela, on appelle toute fonction CoerceValueCallback spécifiée dans les métadonnées de propriété pour la propriété de dépendance telle qu’elle existe sur le DependencyObject appelant. (Hérité de DependencyObject) |
| CreateInstance() |
Initialise une nouvelle instance de la classe Freezable. (Hérité de Freezable) |
| CreateInstanceCore() |
Crée une instance MediaPlayer. |
| Equals(Object) |
Détermine si un DependencyObject fourni est équivalent au DependencyObject réel. (Hérité de DependencyObject) |
| Freeze() |
Rend l’objet actif non modifiable et attribue à sa propriété IsFrozen la valeur |
| FreezeCore(Boolean) |
Rend cet objet Animatable non modifiable ou détermine s'il peut être rendu non modifiable. (Hérité de Animatable) |
| GetAnimationBaseValue(DependencyProperty) |
Retourne la valeur non animée de la propriété DependencyProperty spécifiée. (Hérité de Animatable) |
| GetAsFrozen() |
Crée une copie figée de Freezable, à l'aide des valeurs de propriété (non-animées) de base. Étant donné que la copie est figée, tous les sous-objets figés sont copiés par référence. (Hérité de Freezable) |
| GetAsFrozenCore(Freezable) |
Convertit cette instance en un clone de l’objet MediaPlayer spécifié. |
| GetCurrentValueAsFrozen() |
Crée une copie figée de Freezable à l'aide des valeurs de propriété actuelles. Étant donné que la copie est figée, tous les sous-objets figés sont copiés par référence. (Hérité de Freezable) |
| GetCurrentValueAsFrozenCore(Freezable) |
Convertit l’instance actuelle en un clone figé du Freezable spécifié. Si l’objet a des propriétés de dépendance animées, leurs valeurs animées actuelles sont copiées. (Hérité de Freezable) |
| GetHashCode() |
Obtient un code de hachage pour ce DependencyObject. (Hérité de DependencyObject) |
| GetLocalValueEnumerator() |
Crée un énumérateur spécialisé pour déterminer quelles propriétés de dépendance ont des valeurs définies localement sur ce DependencyObject. (Hérité de DependencyObject) |
| GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
| GetValue(DependencyProperty) |
Retourne la valeur effective actuelle d’une propriété de dépendance sur cette instance d’un DependencyObject. (Hérité de DependencyObject) |
| InvalidateProperty(DependencyProperty) |
Réévalue la valeur effective de la propriété de dépendance spécifiée. (Hérité de DependencyObject) |
| MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
| OnChanged() |
Appelé lorsque l’objet Freezable actuel est modifié. (Hérité de Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject) |
Garantit que les pointeurs de contexte appropriés sont établis pour un membre de données de type DependencyObjectType qui vient juste d'être défini. (Hérité de Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) |
Ce membre prend en charge l’infrastructure Windows Presentation Foundation (WPF) et n’est pas destiné à être utilisé directement à partir de votre code. (Hérité de Freezable) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Substitue l’implémentation DependencyObject de OnPropertyChanged(DependencyPropertyChangedEventArgs) pour appeler également tous les gestionnaires Changed en réponse à une propriété de dépendance variable de type Freezable. (Hérité de Freezable) |
| Open(Uri) |
Ouvre l'Uri donné pour la lecture multimédia. |
| Pause() |
Suspend la lecture multimédia. |
| Play() |
Lit le média à partir de la Position actuelle. |
| ReadLocalValue(DependencyProperty) |
Retourne la valeur locale d’une propriété de dépendance, si elle existe. (Hérité de DependencyObject) |
| ReadPreamble() |
Garantit que le lecteur multimédia est accessible à partir d'un thread valide. |
| SetCurrentValue(DependencyProperty, Object) |
Définit la valeur d’une propriété de dépendance sans modifier sa valeur source. (Hérité de DependencyObject) |
| SetValue(DependencyProperty, Object) |
Définit la valeur locale d’une propriété de dépendance, spécifiée par son identificateur de propriété de dépendance. (Hérité de DependencyObject) |
| SetValue(DependencyPropertyKey, Object) |
Définit la valeur locale d’une propriété de dépendance en lecture seule, spécifiée par l’identificateur DependencyPropertyKey de la propriété de dépendance. (Hérité de DependencyObject) |
| ShouldSerializeProperty(DependencyProperty) |
Retourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur de la propriété de dépendance fournie. (Hérité de DependencyObject) |
| Stop() |
Arrête la lecture multimédia. |
| ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |
| VerifyAccess() |
Garantit que le thread appelant a accès à DispatcherObject. (Hérité de DispatcherObject) |
| WritePostscript() |
Déclenche l’événement Changed pour le Freezable et appelle sa méthode OnChanged(). Les classes qui dérivent de Freezable doivent appeler cette méthode à la fin de toute API qui modifie des membres de classe qui ne sont pas stockés en tant que propriétés de dépendance. (Hérité de Freezable) |
| WritePreamble() |
Vérifie que le lecteur multimédia n'est pas figé et que son accès s'effectue à partir d'un contexte de thread valide. |
Événements
| BufferingEnded |
Se produit lorsque la mise en mémoire tampon est terminée. |
| BufferingStarted |
Se produit lorsque la mise en mémoire tampon a démarré. |
| Changed |
Se produit lorsque Freezable ou un objet qu'il contient est modifié. (Hérité de Freezable) |
| MediaEnded |
Se produit lorsque la lecture du média est terminée. |
| MediaFailed |
Se produit lorsqu'une erreur est rencontrée. |
| MediaOpened |
Se produit lorsque le média est ouvert. |
| ScriptCommand |
Se produit en cas de rencontre d'une commande de script dans la média. |
