MediaPlayer Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Fornece reprodução multimédia para desenhos.
public ref class MediaPlayer : System::Windows::Media::Animation::Animatablepublic class MediaPlayer : System.Windows.Media.Animation.Animatabletype MediaPlayer = class
inherit Animatable
interface DUCE.IResourcetype MediaPlayer = class
inherit AnimatablePublic Class MediaPlayer
Inherits Animatable- Herança
Exemplos
Como: Reproduzir Media usando um VideoDesenho
Observações
Embora possas declarar uma instância desta classe em Extensible Application Markup Language (XAML), não podes carregar e reproduzir os seus media sem usar código. Para reproduzir media apenas em XAML, use um MediaElementarquivo . Além disso, se declarar uma instância em XAML, a única utilidade prática é preencher a sintaxe dos elementos de propriedade dessa Player propriedade.
Ao distribuir media com a sua aplicação, não pode usar um ficheiro multimédia como recurso de projeto. No seu ficheiro de projeto, deve antes definir o tipo de media para Content e definir CopyToOutputDirectory para PreserveNewest ou Always.
MediaPlayer pode ser usado em dois modos diferentes, dependendo do que motiva o jogador: modo independente ou modo relógio. No modo independente, o MediaPlayer é análogo a uma imagem e o meio aberto através do Open método conduz a reprodução. No modo Relógio, o MediaPlayer pode ser visto como um alvo para uma animação, e assim terá entradas correspondentes TimelineClock na árvore de Temporização que controla a reprodução. Para mais informações sobre modos multimédia, consulte a Visão Geral Multimédia.
MediaPlayer é diferente de a MediaElement porque não é um controlo que possa ser adicionado diretamente à interface de utilizador (UI) de uma aplicação. Para mostrar media carregada usando MediaPlayer, a VideoDrawing ou DrawingContext deve ser usada.
Construtores
| Name | Description |
|---|---|
| MediaPlayer() |
Inicializa uma nova instância da MediaPlayer classe. |
Propriedades
| Name | Description |
|---|---|
| Balance |
Obtém ou define o equilíbrio entre os volumes das colunas esquerda e direita. |
| BufferingProgress |
Obtém a percentagem de buffering concluída para conteúdos em streaming. |
| CanFreeze |
Obtém um valor que indica se o objeto pode ser tornado inmodificável. (Herdado de Freezable) |
| CanPause |
Recebe um valor que indica se o media pode ser pausado. |
| Clock |
Obtém ou define o MediaClock associado ao MediaTimeline a ser jogado. |
| DependencyObjectType |
Obtém o DependencyObjectType que envolve o tipo CLR desta instância. (Herdado de DependencyObject) |
| Dispatcher |
Percebe o Dispatcher que isto DispatcherObject está associado. (Herdado de DispatcherObject) |
| DownloadProgress |
Obtém a percentagem de progresso de download para conteúdos localizados num servidor remoto. |
| HasAnimatedProperties |
Obtém um valor que indica se um ou mais AnimationClock objetos estão associados a alguma das propriedades de dependência deste objeto. (Herdado de Animatable) |
| HasAudio |
Recebe um valor que indica se o media tem saída de áudio. |
| HasVideo |
Recebe um valor que indica se o media tem saída de vídeo. |
| IsBuffering |
Obtém um valor que indica se o media está a fazer buffering. |
| IsFrozen |
Recebe um valor que indica se o objeto é atualmente modificável. (Herdado de Freezable) |
| IsMuted |
Obtém um valor que indica se o media está silenciado. |
| IsSealed |
Recebe um valor que indica se esta instância está atualmente selada (apenas leitura). (Herdado de DependencyObject) |
| NaturalDuration |
Obtém a duração natural do meio. |
| NaturalVideoHeight |
Obtém a altura dos píxeis do vídeo. |
| NaturalVideoWidth |
Obtém a largura dos píxeis do vídeo. |
| Position |
Obtém ou definem a posição atual dos media. |
| ScrubbingEnabled |
Obtém ou define um valor que indica se o scrubbing está ativado. |
| Source |
Percebe os media Uri. |
| SpeedRatio |
Obtém ou define a razão de velocidade a que a média é reproduzida. |
| Volume |
Obtém ou ajusta o volume dos media. |
Métodos
| Name | Description |
|---|---|
| ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) |
Aplica-se a AnimationClock um ao especificado DependencyProperty. Se a propriedade já estiver animada, utiliza-se a especificada HandoffBehavior . (Herdado de Animatable) |
| ApplyAnimationClock(DependencyProperty, AnimationClock) |
Aplica-se a AnimationClock um ao especificado DependencyProperty. Se a propriedade já estiver animada, utiliza-se o SnapshotAndReplace comportamento de handoff. (Herdado de Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) |
Aplica uma animação ao especificado DependencyProperty. A animação é iniciada quando o frame seguinte é renderizado. Se a propriedade especificada já estiver animada, é usada a especificada HandoffBehavior . (Herdado de Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline) |
Aplica uma animação ao especificado DependencyProperty. A animação é iniciada quando o frame seguinte é renderizado. Se a propriedade especificada já estiver animada, utiliza-se o SnapshotAndReplace comportamento de handoff. (Herdado de Animatable) |
| CheckAccess() |
Determina se o thread que chama tem acesso a este DispatcherObject. (Herdado de DispatcherObject) |
| ClearValue(DependencyProperty) |
Limpa o valor local de uma propriedade. A propriedade a ser limpa é especificada por um DependencyProperty identificador. (Herdado de DependencyObject) |
| ClearValue(DependencyPropertyKey) |
Limpa o valor local de uma propriedade de apenas leitura. O imóvel a ser limpo é especificado por um DependencyPropertyKey. (Herdado de DependencyObject) |
| Clone() |
Cria um clone modificável deste Animatable, fazendo cópias profundas dos valores deste objeto. Ao copiar as propriedades de dependência deste objeto, este método copia referências de recursos e ligações de dados (mas podem deixar de ser resolvidas), mas não as animações nem os seus valores atuais. (Herdado de Animatable) |
| CloneCore(Freezable) |
Faz desta instância uma cópia profunda do especificado MediaPlayer. Ao copiar propriedades de dependência, este método copia referências de recursos e ligações de dados (mas podem deixar de se resolver), mas não as animações nem os seus valores atuais. |
| CloneCurrentValue() |
Cria um clone modificável (cópia profunda) do Freezable usando os seus valores atuais. (Herdado de Freezable) |
| CloneCurrentValueCore(Freezable) |
Faz desta instância uma cópia profunda modificável do especificado MediaPlayer usando valores atuais da propriedade. Referências de recursos, ligações de dados e animações não são copiadas, mas os seus valores atuais são. |
| Close() |
Fecha os meios de comunicação subjacentes. |
| CoerceValue(DependencyProperty) |
Coage o valor da propriedade de dependência especificada. Isto é conseguido invocando qualquer CoerceValueCallback função especificada nos metadados da propriedade para a propriedade de dependência tal como existe na chamada DependencyObject. (Herdado de DependencyObject) |
| CreateInstance() |
Inicializa uma nova instância da Freezable classe. (Herdado de Freezable) |
| CreateInstanceCore() |
Cria uma nova MediaPlayer instância. |
| Equals(Object) |
Determina se um fornecido DependencyObject é equivalente à corrente DependencyObject. (Herdado de DependencyObject) |
| Freeze() |
Torna o objeto atual immodificável e define a sua IsFrozen propriedade como |
| FreezeCore(Boolean) |
Torna este Animatable objeto immodificável ou determina se pode ser tornado inmodificável. (Herdado de Animatable) |
| GetAnimationBaseValue(DependencyProperty) |
Devolve o valor não animado do especificado DependencyProperty. (Herdado de Animatable) |
| GetAsFrozen() |
Cria uma cópia congelada do Freezable, usando valores base (não animados) da propriedade. Como a cópia está congelada, quaisquer subobjetos congelados são copiados por referência. (Herdado de Freezable) |
| GetAsFrozenCore(Freezable) |
Faz desta instância um clone do objeto especificado MediaPlayer . |
| GetCurrentValueAsFrozen() |
Cria uma cópia congelada do Freezable usando os valores atuais das propriedades. Como a cópia está congelada, quaisquer subobjetos congelados são copiados por referência. (Herdado de Freezable) |
| GetCurrentValueAsFrozenCore(Freezable) |
Torna a instância atual um clone congelado do especificado Freezable. Se o objeto tiver propriedades de dependência animadas, os seus valores animados atuais são copiados. (Herdado de Freezable) |
| GetHashCode() |
Obtém um código de hash para isto DependencyObject. (Herdado de DependencyObject) |
| GetLocalValueEnumerator() |
Cria um enumerador especializado para determinar quais as propriedades de dependência que têm valores localmente definidos neste DependencyObject. (Herdado de DependencyObject) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| GetValue(DependencyProperty) |
Devolve o valor efetivo atual de uma propriedade de dependência nesta instância de um DependencyObject. (Herdado de DependencyObject) |
| InvalidateProperty(DependencyProperty) |
Reavalia o valor efetivo da propriedade de dependência especificada. (Herdado de DependencyObject) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| OnChanged() |
Chamada quando o objeto atual Freezable é modificado. (Herdado de Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) |
Este membro suporta a infraestrutura Windows Presentation Foundation (WPF) e não foi concebido para ser usado diretamente a partir do seu código. (Herdado de Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject) |
Assegura que os apontadores de contexto apropriados são estabelecidos para um DependencyObjectType membro de dados que acabou de ser definido. (Herdado de Freezable) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Sobrepõe a DependencyObject implementação de OnPropertyChanged(DependencyPropertyChangedEventArgs) para também invocar quaisquer Changed manipuladores em resposta a uma alteração da propriedade de dependência do tipo Freezable. (Herdado de Freezable) |
| Open(Uri) |
Abre o dado Uri para reprodução multimédia. |
| Pause() |
Pausa a reprodução de multimédia. |
| Play() |
Reproduz media do atual Position. |
| ReadLocalValue(DependencyProperty) |
Devolve o valor local de uma propriedade de dependência, se esta existir. (Herdado de DependencyObject) |
| ReadPreamble() |
Garante que o MediaPlayer está a ser acedido a partir de um thread válido. |
| SetCurrentValue(DependencyProperty, Object) |
Define o valor de uma propriedade de dependência sem alterar a sua fonte de valor. (Herdado de DependencyObject) |
| SetValue(DependencyProperty, Object) |
Define o valor local de uma propriedade de dependência, especificado pelo seu identificador de propriedade de dependência. (Herdado de DependencyObject) |
| SetValue(DependencyPropertyKey, Object) |
Define o valor local de uma propriedade de dependência somente de leitura, especificado pelo DependencyPropertyKey identificador da propriedade de dependência. (Herdado de DependencyObject) |
| ShouldSerializeProperty(DependencyProperty) |
Devolve um valor que indica se os processos de serialização devem serializar o valor da propriedade de dependência fornecida. (Herdado de DependencyObject) |
| Stop() |
Para a reprodução de media. |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
| VerifyAccess() |
Faz cumprir que o thread que chama tem acesso a este DispatcherObject. (Herdado de DispatcherObject) |
| WritePostscript() |
Eleva o Changed evento para o Freezable e invoca o seu OnChanged() método. As classes que derivam de Freezable devem chamar este método no final de qualquer API que modifique membros de classe que não estejam armazenados como propriedades de dependência. (Herdado de Freezable) |
| WritePreamble() |
Verifica que o MediaPlayer não está congelado e que está a ser acedido a partir de um contexto de threading válido. |
evento
| Name | Description |
|---|---|
| BufferingEnded |
Ocorre quando o buffering terminou. |
| BufferingStarted |
Ocorre quando o buffering já começou. |
| Changed |
Ocorre quando o Freezable ou um objeto que contém é modificado. (Herdado de Freezable) |
| MediaEnded |
Ocorre quando o suporte termina a reprodução. |
| MediaFailed |
Ocorre quando um erro é encontrado. |
| MediaOpened |
Ocorre quando o suporte é aberto. |
| ScriptCommand |
Ocorre quando um comando de script é encontrado dentro do meio. |
