Partager via


MediaPlayer Classe

Définition

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
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
Héritage
Object Platform::Object IInspectable MediaPlayer
Attributs
Implémente

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.

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é.

S’applique à