SystemMediaTransportControls Clase

Definición

Espacio de nombres:

Windows.Media

Representa un objeto que permite la integración con los controles de transporte multimedia del sistema y la compatibilidad con los comandos multimedia.

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

Herencia

Object Platform::Object IInspectable SystemMediaTransportControls

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

SystemMediaTransportControls reemplaza a la clase MediaControl . En Windows 8.1 y versiones posteriores, debe usar este control en lugar de MediaControl para interactuar con los controles de transporte del sistema. Los controles de transporte del sistema permiten a los desarrolladores de aplicaciones multimedia integrarse con la interfaz de usuario del sistema integrada para mostrar metadatos multimedia como el artista, el título del álbum o el título del capítulo. El control de transporte del sistema también permite a un usuario controlar la reproducción de una aplicación multimedia mediante la interfaz de usuario del sistema integrada, como pausar la reproducción y omitir hacia delante y hacia atrás en una lista de reproducción.

A partir de Windows 10, versión 1607, las aplicaciones para UWP que usan la clase MediaPlayer o la clase AudioGraph para reproducir elementos multimedia se integran automáticamente con SMTC de forma predeterminada. Basta con crear una instancia nueva de MediaPlayer y asignar un objeto MediaSource, MediaPlaybackItem o MediaPlaybackList a la propiedad Source del reproductor y el usuario verá el nombre de la aplicación en el SMTC y podrá reproducir, pausar y desplazarse por las listas de reproducción mediante los controles SMTC. Obtenga una instancia de SMTC accediendo a la propiedad SystemMediaTransportControls del objeto MediaPlayer. Para obtener instrucciones paso a paso sobre el uso de SMTC desde la aplicación, consulte Integración con SystemMediaTransportControls.

En algunos escenarios, puede deshabilitar la integración automática con SMTC. En este caso, debes deshabilitar el CommandManager del objeto MediaPlayer estableciendo la propiedad IsEnabled en false. Llame a GetForCurrentView para obtener una instancia de SystemMediaTransportControls para la vista actual. También deberá obtener una instancia de esta manera si tiene como destino una versión anterior de Windows. Para obtener instrucciones paso a paso sobre cómo controlar manualmente el SMTC, consulte Control manual de los controles de transporte multimedia del sistema.

Propiedades

AutoRepeatMode	Obtiene o establece un valor que representa el modo de repetición automática actual de SystemMediaTransportControls.
DisplayUpdater	Obtiene el actualizador de pantalla de SystemMediaTransportControls que habilita la actualización de la información mostrada sobre la canción que se está reproduciendo actualmente.
IsChannelDownEnabled	Obtiene o establece un valor que especifica si se admite el botón hacia abajo del canal.
IsChannelUpEnabled	Obtiene o establece un valor que especifica si se admite el botón hacia arriba del canal.
IsEnabled	Habilita y deshabilita los controles de transporte multimedia del sistema para la aplicación.
IsFastForwardEnabled	Obtiene o establece un valor que especifica si se admite el botón de avance rápido.
IsNextEnabled	Obtiene o establece un valor que especifica si se admite el botón siguiente.
IsPauseEnabled	Obtiene o establece un valor que especifica si se admite el botón pausar. true si se admite el botón de pausa; de lo contrario, false.
IsPlayEnabled	Obtiene o establece un valor que especifica si se admite el botón reproducir.
IsPreviousEnabled	Obtiene o establece un valor que especifica si se admite el botón anterior.
IsRecordEnabled	Obtiene o establece un valor que especifica si se admite el botón de registro. true si se admite el botón de registro; de lo contrario, false.
IsRewindEnabled	Obtiene o establece un valor que especifica si se admite el botón de rebobinado.
IsStopEnabled	Obtiene o establece un valor que especifica si se admite el botón detener.
PlaybackRate	Obtiene o establece la velocidad de reproducción de SystemMediaTransportControls.
PlaybackStatus	Obtiene o establece el estado de reproducción del medio.
ShuffleEnabled	Obtiene o establece un valor que representa el estado aleatorio actual de SystemMediaTransportControls.
SoundLevel	Obtiene el nivel de sonido del medio para las secuencias de captura y representación.

Métodos

GetForCurrentView()	Controles de transporte multimedia del sistema para la vista actual.
UpdateTimelineProperties(SystemMediaTransportControlsTimelineProperties)	Novedades las propiedades de escala de tiempo SystemMediaTransportControls con los valores del objeto proporcionado.

Eventos

AutoRepeatModeChangeRequested	Se produce cuando el usuario modifica el modo de repetición automática SystemMediaTransportControls .
ButtonPressed	Se produce cuando se presiona un botón en SystemMediaTransportControls.
PlaybackPositionChangeRequested	Se produce cuando el usuario modifica la posición de reproducción de SystemMediaTransportControls.
PlaybackRateChangeRequested	Se produce cuando el usuario modifica la velocidad de reproducción SystemMediaTransportControls .
PropertyChanged	Se produce cuando ha cambiado una propiedad en SystemMediaTransportControls .
ShuffleEnabledChangeRequested	Se produce cuando el usuario modifica el estado aleatorio SystemMediaTransportControls .

Consulte también

• Integración con SystemMediaTransportControls
• Control manual de los controles de transporte de contenido multimedia del sistema
• Ejemplo de controles de transporte multimedia del sistema