SystemMediaTransportControls Classe

Definição

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

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.

Controles de Transtransporte de Mídia do Sistema

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 .

Aplica-se a

Confira também