Compartir a través de


SystemMediaTransportControls Clase

Definición

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

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.

Controles de transport de medios del sistema

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 .

Se aplica a

Consulte también