SystemMediaTransportControls Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
- 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](windows.media/images/smtc.png?view=winrt-26100)
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 . |