SystemMediaTransportControls Classe

Definição

Namespace:

Windows.Media

Representa um objeto que permite a integração com os controles de transporte de mídia do sistema e o suporte para comandos de mídia.

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

Herança

Object Platform::Object IInspectable SystemMediaTransportControls

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

O SystemMediaTransportControls substitui a classe MediaControl . Em Windows 8.1 e posteriores, você deve usar esse controle em vez de MediaControl para interagir com os controles de transporte do sistema. Os controles de transporte do sistema permitem que os desenvolvedores de aplicativos de mídia se integrem à interface do usuário interna do sistema para exibir metadados de mídia, como artista, título do álbum ou título do capítulo. O controle de transporte do sistema também permite que um usuário controle a reprodução de um aplicativo de mídia usando a interface do usuário interna do sistema, como pausar a reprodução e pular para frente e para trás em uma playlist.

A partir do Windows 10, versão 1607, os aplicativos UWP que usam a classe MediaPlayer ou a classe AudioGraph para reproduzir mídia são integrados automaticamente ao SMTC por padrão. Basta instanciar uma nova instância do MediaPlayer e atribuir um MediaSource, MediaPlaybackItem ou MediaPlaybackList à propriedade Source do player e o usuário verá o nome do aplicativo no SMTC e poderá reproduzir, pausar e percorrer suas listas de reprodução usando os controles SMTC. Obtenha uma instância do SMTC acessando a propriedade SystemMediaTransportControls do objeto MediaPlayer. Para obter diretrizes sobre como usar o SMTC do seu aplicativo, consulte Integrar com o SystemMediaTransportControls.

Para alguns cenários, talvez você queira desabilitar a integração automática com o SMTC. Nesse caso, você deve desabilitar o CommandManager do objeto MediaPlayer definindo a propriedade IsEnabled como false. Chame GetForCurrentView para obter uma instância do SystemMediaTransportControls para exibição atual. Você também precisará obter uma instância dessa maneira se estiver direcionando uma versão mais antiga do Windows. Para obter diretrizes sobre como controlar manualmente o SMTC, consulte Controle manual dos Controles de Transporte de Mídia do Sistema.

Propriedades

AutoRepeatMode	Obtém ou define um valor que representa o modo de repetição automática atual do SystemMediaTransportControls.
DisplayUpdater	Obtém o atualizador de exibição para SystemMediaTransportControls , que permite atualizar as informações exibidas sobre a música que está sendo reproduzida no momento.
IsChannelDownEnabled	Obtém ou define um valor que especifica se há suporte para o botão de desativação do canal.
IsChannelUpEnabled	Obtém ou define um valor que especifica se o botão de canal para cima tem suporte.
IsEnabled	Habilita e desabilita os controles de transporte de mídia do sistema para o aplicativo.
IsFastForwardEnabled	Obtém ou define um valor que especifica se há suporte para o botão avançar rapidamente.
IsNextEnabled	Obtém ou define um valor que especifica se há suporte para o próximo botão.
IsPauseEnabled	Obtém ou define um valor que especifica se há suporte para o botão pausar. true se houver suporte para o botão pausar; caso contrário, false.
IsPlayEnabled	Obtém ou define um valor que especifica se há suporte para o botão reproduzir.
IsPreviousEnabled	Obtém ou define um valor que especifica se há suporte para o botão anterior.
IsRecordEnabled	Obtém ou define um valor que especifica se há suporte para o botão de registro. true se o botão de registro tiver suporte; caso contrário, false.
IsRewindEnabled	Obtém ou define um valor que especifica se há suporte para o botão retroceder.
IsStopEnabled	Obtém ou define um valor que especifica se há suporte para o botão parar.
PlaybackRate	Obtém ou define a taxa de reprodução do SystemMediaTransportControls.
PlaybackStatus	Obtém ou define o status de reprodução da mídia.
ShuffleEnabled	Obtém ou define um valor que representa o estado de embaralhamento atual do SystemMediaTransportControls.
SoundLevel	Obtém o nível de som da mídia para os fluxos de captura e renderização.

Métodos

GetForCurrentView()	Os controles de transporte de mídia do sistema para a exibição atual.
UpdateTimelineProperties(SystemMediaTransportControlsTimelineProperties)	Atualizações as propriedades linha do tempo SystemMediaTransportControls com os valores no objeto fornecido.

Eventos

AutoRepeatModeChangeRequested	Ocorre quando o usuário modifica o modo de repetição automática SystemMediaTransportControls .
ButtonPressed	Ocorre quando um botão é pressionado no SystemMediaTransportControls.
PlaybackPositionChangeRequested	Ocorre quando o usuário modifica a posição de reprodução do SystemMediaTransportControls.
PlaybackRateChangeRequested	Ocorre quando o usuário modifica a taxa de reprodução SystemMediaTransportControls .
PropertyChanged	Ocorre quando uma propriedade no SystemMediaTransportControls foi alterada.
ShuffleEnabledChangeRequested	Ocorre quando o usuário modifica o estado de embaralhamento SystemMediaTransportControls .

Confira também

• Integrar com o SystemMediaTransportControls
• Controle manual dos controles de transporte de mídia do sistema
• Exemplo de controles de transporte de mídia do sistema