SystemMediaTransportControls Classe

Définition

Espace de noms:

Windows.Media

Représente un objet qui permet l’intégration avec les contrôles de transport de média système et la prise en charge des commandes multimédias.

public ref class SystemMediaTransportControls sealed

/// [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.MTA)]
class SystemMediaTransportControls final

[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.MTA)]
public sealed class SystemMediaTransportControls

Public NotInheritable Class SystemMediaTransportControls

Héritage

Object Platform::Object IInspectable SystemMediaTransportControls

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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

SystemMediaTransportControls remplace la classe MediaControl . Dans Windows 8.1 et versions ultérieures, vous devez utiliser ce contrôle au lieu de MediaControl pour interagir avec les contrôles de transport système. Les contrôles de transport système permettent aux développeurs d’applications multimédias d’intégrer à l’interface utilisateur système intégrée d’afficher des métadonnées multimédias telles que l’artiste, le titre de l’album ou le titre de chapitre. Le contrôle de transport système permet également à un utilisateur de contrôler la lecture d’une application multimédia à l’aide de l’interface utilisateur système intégrée, par exemple la suspension de la lecture et le saut vers l’avant et l’arrière dans une playlist.

À compter de Windows 10, version 1607, les applications UWP qui utilisent la classe MediaPlayer ou la classe AudioGraph pour lire du contenu multimédia sont automatiquement intégrées au SMTC par défaut. Instanciez simplement une nouvelle instance de MediaPlayer et affectez un MediaSource, MediaPlaybackItem ou MediaPlaybackList à la propriété Source du lecteur. L’utilisateur verra le nom de votre application dans le SMTC et pourra lire, suspendre et parcourir vos listes de lecture à l’aide des contrôles SMTC. Obtenez une instance du SMTC en accédant à la propriété SystemMediaTransportControls de l’objet MediaPlayer. Pour obtenir des conseils pratiques sur l’utilisation du SMTC à partir de votre application, consultez Intégrer à SystemMediaTransportControls.

Pour certains scénarios, vous souhaiterez peut-être désactiver l’intégration automatique avec le SMTC. Dans ce cas, vous devez désactiver commandManager de l’objet MediaPlayer en définissant la propriété IsEnabled sur false. Appelez GetForCurrentView pour obtenir une instance de SystemMediaTransportControls pour l’affichage actuel. Vous devez également obtenir une instance de cette façon si vous ciblez une version antérieure de Windows. Pour obtenir des conseils pratiques sur le contrôle manuel du SMTC, consultez Contrôle manuel des contrôles de transport de média système.

Propriétés

AutoRepeatMode	Obtient ou définit une valeur représentant le mode de répétition automatique actuel de SystemMediaTransportControls.
DisplayUpdater	Obtient la mise à jour d’affichage pour SystemMediaTransportControls qui permet de mettre à jour les informations affichées sur la chanson en cours de lecture.
IsChannelDownEnabled	Obtient ou définit une valeur qui spécifie si le bouton canal vers le bas est pris en charge.
IsChannelUpEnabled	Obtient ou définit une valeur qui spécifie si le bouton canal vers le haut est pris en charge.
IsEnabled	Active et désactive les contrôles de transport de média système pour l’application.
IsFastForwardEnabled	Obtient ou définit une valeur qui spécifie si le bouton avance rapide est pris en charge.
IsNextEnabled	Obtient ou définit une valeur qui spécifie si le bouton suivant est pris en charge.
IsPauseEnabled	Obtient ou définit une valeur qui spécifie si le bouton Pause est pris en charge. true si le bouton Suspendre est pris en charge ; sinon, false.
IsPlayEnabled	Obtient ou définit une valeur qui spécifie si le bouton de lecture est pris en charge.
IsPreviousEnabled	Obtient ou définit une valeur qui spécifie si le bouton précédent est pris en charge.
IsRecordEnabled	Obtient ou définit une valeur qui spécifie si le bouton d’enregistrement est pris en charge. true si le bouton d’enregistrement est pris en charge ; sinon, false.
IsRewindEnabled	Obtient ou définit une valeur qui spécifie si le bouton de rembobinage est pris en charge.
IsStopEnabled	Obtient ou définit une valeur qui spécifie si le bouton d’arrêt est pris en charge.
PlaybackRate	Obtient ou définit la vitesse de lecture de SystemMediaTransportControls.
PlaybackStatus	Obtient ou définit la status de lecture du média.
ShuffleEnabled	Obtient ou définit une valeur représentant l’état aléatoire actuel de SystemMediaTransportControls.
SoundLevel	Obtient le niveau sonore du média pour les flux de capture et de rendu.

Méthodes

GetForCurrentView()	Les contrôles de transport de média système pour l’affichage actuel.
UpdateTimelineProperties(SystemMediaTransportControlsTimelineProperties)	Mises à jour les propriétés de chronologie SystemMediaTransportControls avec les valeurs de l’objet fourni.

Événements

AutoRepeatModeChangeRequested	Se produit lorsque l’utilisateur modifie le mode de répétition automatique SystemMediaTransportControls .
ButtonPressed	Se produit lorsqu’un bouton est appuyé sur systemMediaTransportControls.
PlaybackPositionChangeRequested	Se produit lorsque l’utilisateur modifie la position de lecture de SystemMediaTransportControls.
PlaybackRateChangeRequested	Se produit lorsque l’utilisateur modifie le taux de lecture de SystemMediaTransportControls .
PropertyChanged	Se produit lorsqu’une propriété sur le SystemMediaTransportControls a changé.
ShuffleEnabledChangeRequested	Se produit lorsque l’utilisateur modifie l’état aléatoire de SystemMediaTransportControls .

Voir aussi

• Intégrer à SystemMediaTransportControls
• Contrôle manuel des contrôles de transport de média système
• Exemple de contrôles de transport de média système