SystemMediaTransportControls Classe

  • Référence

Définition

Espace de noms:
Windows.Media
Modifier

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.

Contrôles de transtport du média système

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

S’applique à

Voir aussi