MediaPlayer Classe

Définition

Espace de noms:

Windows.Media.Playback

Fournit un accès aux fonctionnalités de lecture multimédia telles que la lecture, la pause, l’avance rapide, le rembobinage et le volume.

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

Héritage

Object Platform::Object IInspectable MediaPlayer

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ActivatableAttribute

Implémente

IClosable IDisposable

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

La section Lecture multimédia de la documentation contient des articles pratiques qui fournissent des conseils détaillés pour l’ajout de fonctionnalités de lecture multimédia à votre application. Le tableau suivant répertorie certains articles disponibles.

Rubrique	Description
Lire du contenu audio et vidéo avec MediaPlayer	Montre comment tirer parti des nouvelles fonctionnalités et améliorations apportées au système de lecture multimédia pour les applications UWP.
Éléments, playlists et pistes multimédias	Montre comment utiliser la classe MediaSource , qui fournit un moyen courant de référencer et de lire des médias à partir de différentes sources telles que des fichiers locaux ou distants, et expose un modèle commun d’accès aux données multimédias, quel que soit le format multimédia sous-jacent.
Intégration avec les contrôles de transport de média système	Vous montre comment intégrer votre application aux contrôles de transport de média système (SMTC).
Indicateurs de métadonnées synchronisées pris en charge par le système	Décrit comment tirer parti de plusieurs formats de métadonnées chronotées qui peuvent être incorporées dans des fichiers multimédias ou des flux.
Créer, planifier et gérer des coupures de médias	Vous montre comment créer, planifier et gérer des interruptions de média dans votre application de lecture multimédia.
Lire du contenu multimédia en arrière-plan	Montre comment configurer votre application afin que le contenu multimédia continue à être lu lorsque votre application passe du premier plan à l’arrière-plan.
Diffusion en continu adaptative	Décrit comment ajouter la lecture de contenu multimédia en streaming adaptatif à des applications plateforme Windows universelle (UWP).
Diffusion multimédia	Montre comment diffuser du contenu multimédia sur des appareils distants à partir d’une application Windows universelle.
Gestion des droits numériques PlayReady	Décrit comment ajouter du contenu multimédia protégé PlayReady à votre application plateforme Windows universelle (UWP).

Exemple de SDK de lecture de contenus multimédias

Les exemples suivants de SDK décrivent les fonctionnalités de lecture multimédia disponibles sur les applications UWP dans Windows 10. Utilisez ces exemples pour afficher les API de lecture de contenus multimédias utilisées en contexte ou en tant que point de départ pour votre propre application.

• Exemple de diffusion en continu adaptative
• Exemple de contenu audio en arrière-plan
• Exemple de transport de média système
• Exemple de lecture vidéo à 360 degrés
• Exemple de lecture de média en arrière-plan
• Exemple de synchronisation de lecture vidéo

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
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

Constructeurs

MediaPlayer()

Initialise une nouvelle instance de l’objet MediaPlayer.

Propriétés

AudioBalance	Obtient ou définit un rapport de volume entre les haut-parleurs stéréo.
AudioCategory	Obtient ou définit le type d’audio en cours de lecture.
AudioDevice	Obtient ou définit l’objet DeviceInformation représentant l’appareil audio utilisé par MediaPlayer pour restituer l’audio.
AudioDeviceType	Obtient ou définit une valeur qui décrit l’utilisation principale de l’appareil utilisé pour lire l’audio.
AudioStateMonitor	Obtient un objet AudioStateMonitor qui permet à une application UWP de déterminer si l’un des flux audio de l’application est actuellement mis en sourdine ou si son volume est réduit par le système.
AutoPlay	Obtient ou définit une valeur booléenne indiquant si la lecture démarre automatiquement après le chargement du média.
BreakManager	Obtient le MediaBreakManager associé à MediaPlayer, qui fournit des informations et un contrôle sur les interruptions multimédias pour le lecteur.
BufferingProgress	Obtient la quantité de mise en mémoire tampon effectuée pour le contenu multimédia, exprimée sous forme de pourcentage. Notes MediaPlayer.BufferingProgress peut être modifié ou indisponible après Windows 10, version 1607. Au lieu de cela, utilisez la propriété MediaPlayer.PlaybackSession pour obtenir un objet MediaPlaybackSession , puis utilisez la propriété MediaPlaybackSession.BufferingProgress .
CanPause	Obtient une valeur booléenne indiquant si le média peut être suspendu. Notes MediaPlayer.CanPause peut être modifié ou indisponible après Windows 10, version 1607. Utilisez plutôt la propriété MediaPlayer.PlaybackSession pour obtenir un objet MediaPlaybackSession , puis utilisez la propriété MediaPlaybackSession.CanPause .
CanSeek	Obtient une valeur booléenne indiquant si le média prend en charge la recherche à une position spécifique. Notes MediaPlayer.CanSeek peut être modifié ou indisponible après Windows 10, version 1607. Utilisez plutôt la propriété MediaPlayer.PlaybackSession pour obtenir un objet MediaPlaybackSession , puis la propriété MediaPlaybackSession.CanSeek .
CommandManager	Obtient le MediaPlaybackCommandManager associé au MediaPlayer, qui spécifie le comportement des événements et reçoit les événements des contrôles de transport multimédia système.
CurrentState	Obtient l’état actuel de la lecture multimédia. Notes MediaPlayer.CurrentState peut être modifié ou indisponible après Windows 10, version 1607. Utilisez plutôt la propriété MediaPlayer.PlaybackSession pour obtenir un objet MediaPlaybackSession , puis utilisez la propriété MediaPlaybackSession.PlaybackState .
IsLoopingEnabled	Obtient ou définit une valeur booléenne indiquant si le média sera lu dans une boucle répétée.
IsMuted	Obtient ou définit une valeur booléenne indiquant si l’audio est désactivé.
IsProtected	Obtient une valeur booléenne indiquant si le contenu est protégé par un système de gestion des droits numériques. Notes MediaPlayer.IsProtected peut être modifié ou indisponible après Windows 10, version 1607. Au lieu de cela, utilisez la propriété MediaPlayer.PlaybackSession pour obtenir un objet MediaPlaybackSession , puis utilisez la propriété IsProtected .
IsVideoFrameServerEnabled	Obtient une valeur indiquant si le mode serveur d’images vidéo est activé pour le instance MediaPlayer.
NaturalDuration	Obtenez la durée réelle du média sans appliquer le taux de lecture. Notes MediaPlayer.NaturalDuration peut être modifié ou indisponible après Windows 10, version 1607. Utilisez plutôt la propriété MediaPlayer.PlaybackSession pour obtenir un objet MediaPlaybackSession , puis la propriété MediaPlaybackSession.NaturalDuration .
PlaybackMediaMarkers	Obtient la collection de marqueurs chronologie pour le média. Notes MediaPlayer.PlaybackMediaMarkers peut être modifié ou indisponible après Windows 10, version 1607. Utilisez plutôt MediaPlaybackItem.TimedMetadataTracks pour gérer les signaux de données ou de texte. Pour plus d’informations, consultez Lecture multimédia avec MediaSource.
PlaybackRate	Obtient ou définit le taux de lecture, exprimé sous forme de ratio. Notes MediaPlayer.PlaybackRate peut être modifié ou indisponible après Windows 10, version 1607. Utilisez plutôt la propriété MediaPlayer.PlaybackSession pour obtenir un objet MediaPlaybackSession , puis la propriété MediaPlaybackSession.PlaybackRate .
PlaybackSession	Obtient la MediaPlaybackSession associée à MediaPlayer, qui fournit des informations sur l’état de la session de lecture actuelle et fournit des événements permettant de répondre aux modifications apportées à l’état de la session de lecture.
Position	Obtient ou définit la position de lecture dans le média. Notes MediaPlayer.Position peut être modifié ou indisponible après Windows 10, version 1607. Au lieu de cela, utilisez la propriété MediaPlayer.PlaybackSession pour obtenir un objet MediaPlaybackSession , puis utilisez la propriété MediaPlaybackSession.Position .
ProtectionManager	Obtient ou définit le gestionnaire de protection de contenu pour le média.
RealTimePlayback	Obtient ou définit une valeur qui configure MediaPlayer pour des scénarios en temps réel tels que la diffusion vidéo en direct.
Source	Définit la source de lecture du lecteur multimédia.
StereoscopicVideoRenderMode	Obtient ou définit une valeur indiquant le mode de rendu stéréoscopique actuel.
SystemMediaTransportControls	Obtient une instance de la classe SystemMediaTransportControls pour permettre à l’utilisateur de contrôler la lecture de MediaPlayer et pour permettre à l’application d’afficher des informations sur le contenu en cours de lecture dans l’interface utilisateur système.
TimelineController	Obtient ou définit le MediaTimelineController associé à MediaPlayer. Utilisez cette propriété pour manipuler plusieurs instances MediaPlayer avec un seul contrôle chronologie.
TimelineControllerPositionOffset	Obtient ou définit le décalage appliqué à la position du MediaTimelineController associé à MediaPlayer.
Volume	Obtient ou définit le volume audio pour la lecture multimédia.

Méthodes

AddAudioEffect(String, Boolean, IPropertySet)	Ajoute un effet audio au flux de lecture du MediaPlayer.
AddVideoEffect(String, Boolean, IPropertySet)	Applique un effet vidéo à la lecture multimédia.
Close()	Ferme le MediaPlayer et supprime les ressources associées.
CopyFrameToStereoscopicVideoSurfaces(IDirect3DSurface, IDirect3DSurface)	Copie le cadre vidéo actuellement affiché par MediaPlayer vers les deux objets IDirect3DSurface fournis qui représentent le contenu de l’œil gauche et de l’œil droit d’une image vidéo stéréoscopique.
CopyFrameToVideoSurface(IDirect3DSurface)	Copie l’image vidéo actuelle du MediaPlayer vers le IDirect3DSurface fourni.
CopyFrameToVideoSurface(IDirect3DSurface, Rect)	Copie l’image vidéo actuelle du MediaPlayer vers le rectangle cible spécifié dans le IDirect3DSurface fourni.
Dispose()	Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées.
GetAsCastingSource()	Obtient un CastingSource représentant le MediaPlayer, qui permet à son média d’être casté sur d’autres appareils.
GetSurface(Compositor)	Obtient un objet MediaPlayerSurface pour MediaPlayer, qui vous permet de restituer le contenu du lecteur à l’aide d’un Compositor sans dépendre de l’infrastructure XAML.
Pause()	Suspend la lecture multimédia.
Play()	Démarre la lecture multimédia.
RemoveAllEffects()	Supprime tous les effets du flux de lecture du MediaPlayer.
RenderSubtitlesToSurface(IDirect3DSurface)	Demande au système de restituer le texte de sous-titre actuel dans le IDirect3DSurface fourni.
RenderSubtitlesToSurface(IDirect3DSurface, Rect)	Demande au système de restituer le texte de sous-titre actuel dans le rectangle cible spécifié dans le IDirect3DSurface fourni.
SetFileSource(IStorageFile)	Définissez la source du média sur un fichier. Notes MediaPlayer.SetFileSource peut être modifié ou indisponible après Windows 10. Utilisez MediaPlayer.Source à la place.
SetMediaSource(IMediaSource)	Définit la source multimédia pour la lecture. Notes MediaPlayer.SetMediaSource peut être modifié ou indisponible après Windows 10. Utilisez MediaPlayer.Source à la place.
SetStreamSource(IRandomAccessStream)	Définit la source multimédia sur un flux. Notes MediaPlayer.SetMediaSource peut être modifié ou indisponible après Windows 10. Utilisez MediaPlayer.Source à la place.
SetSurfaceSize(Size)	Définit la taille de la surface de composition retournée par GetSurface.
SetUriSource(Uri)	Définit le chemin d’accès au média. Notes MediaPlayer.SetUriSource peut être modifié ou indisponible après Windows 10. Utilisez MediaPlayer.Source à la place.
StepBackwardOneFrame()	Fait reculer la position de lecture de MediaPlayer de 0,042 secondes, ce qui correspond à une image à 24 images par seconde, quelle que soit la fréquence d’images réelle du contenu lu.
StepForwardOneFrame()	Entraîne la progression d’une image de MediaPlayer dans le média actuel.

Événements

BufferingEnded	Se produit lorsque la mise en mémoire tampon est terminée. Notes MediaPlayer.BufferingEnded peut être modifié ou indisponible après Windows 10, version 1607. Au lieu de cela, utilisez la propriété MediaPlayer.PlaybackSession pour obtenir un objet MediaPlaybackSession , puis utilisez l’événement MediaPlaybackSession.BufferingEnded .
BufferingStarted	Se produit lorsque la mise en mémoire tampon a démarré. Notes MediaPlayer.BufferingStarted peut être modifié ou indisponible après Windows 10, version 1607. Utilisez plutôt la propriété MediaPlayer.PlaybackSession pour obtenir un objet MediaPlaybackSession , puis utilisez l’événement MediaPlaybackSession.BufferingStarted .
CurrentStateChanged	Se produit lorsque l’état du lecteur multimédia a changé. Notes MediaPlayer.CurrentStateChanged peut être modifié ou indisponible après Windows 10, version 1607. Utilisez plutôt la propriété MediaPlayer.PlaybackSession pour obtenir un objet MediaPlaybackSession , puis utilisez l’événement MediaPlaybackSession.PlaybackStateChanged .
IsMutedChanged	Se produit lorsque le status en sourdine actuel de MediaPlayer change.
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.
MediaPlayerRateChanged	Se produit lorsque le taux de lecture multimédia a changé. Notes MediaPlayer.MediaPlayerRateChanged peut être modifié ou indisponible après Windows 10, version 1607. Utilisez plutôt la propriété MediaPlayer.PlaybackSession pour obtenir un objet MediaPlaybackSession , puis utilisez l’événement MediaPlaybackSession.PlaybackRateChanged .
PlaybackMediaMarkerReached	Se produit lorsqu’un marqueur multimédia a été atteint pendant la lecture. Notes MediaPlayer.PlaybackMediaMarkerReached peut être modifié ou indisponible après Windows 10, version 1607. Utilisez plutôt MediaPlaybackItem.TimedMetadataTracks pour gérer les signaux de données ou de texte. Pour plus d’informations, consultez Lecture multimédia avec MediaSource.
SeekCompleted	Se produit lorsqu’une opération de recherche est terminée. Notes MediaPlayer.SeekCompleted peut être modifié ou indisponible après Windows 10, version 1607. Utilisez plutôt la propriété MediaPlayer.PlaybackSession pour obtenir un objet MediaPlaybackSession , puis utilisez l’événement MediaPlaybackSession.SeekCompleted .
SourceChanged	Se produit lorsque la source du média pour MediaPlayer change.
SubtitleFrameChanged	Se produit lorsque le contenu du sous-titre actuel a changé alors que MediaPlayer est en mode serveur frame.
VideoFrameAvailable	Se produit lorsque IsVideoFrameServerEnabled a la valeur true et qu’une nouvelle image vidéo est disponible pour traitement.
VolumeChanged	Se produit lorsque le volume de l’audio a changé.