MediaPlayer Класс

Определение

Пространство имен:: System.Windows.Media

Сборка:: PresentationCore.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Предоставляет воспроизведение мультимедиа для рисунков.

public ref class MediaPlayer : System::Windows::Media::Animation::Animatable

public class MediaPlayer : System.Windows.Media.Animation.Animatable

type MediaPlayer = class
    inherit Animatable
    interface DUCE.IResource

type MediaPlayer = class
    inherit Animatable

Public Class MediaPlayer
Inherits Animatable

Наследование: Object

DispatcherObject

DependencyObject

Freezable

Animatable
MediaPlayer

Примеры

Практическое руководство. Воспроизведение мультимедиа с помощью VideoDrawing

Хотя экземпляр этого класса можно объявить в языке разметки расширяемых приложений (XAML), вы не можете загружать и воспроизводить его носитель без использования кода. Для воспроизведения мультимедиа только в XAML используйте .MediaElement Кроме того, если вы объявляете экземпляр в XAML, единственным практическим использованием является заполнение синтаксиса элемента свойства для Player свойства.

При распространении мультимедиа с приложением нельзя использовать файл мультимедиа в качестве ресурса проекта. В файле проекта необходимо вместо этого задать тип Content носителя и задать CopyToOutputDirectory для PreserveNewest него значение или Always.

MediaPlayer можно использовать в двух разных режимах в зависимости от того, что управляет проигрывателем: независимый режим или режим часов. В независимом режиме MediaPlayer он аналогиен изображению и мультимедиа, открываемого Open с помощью воспроизведения методов. В режиме MediaPlayer часов можно рассматривать как целевой объект для анимации, поэтому он будет иметь соответствующие Timeline и Clock записи в дереве времени, которое управляет воспроизведением. Дополнительные сведения о режимах мультимедиа см. в разделе "Обзор мультимедиа".

MediaPlayer отличается от MediaElement элемента управления, который можно добавить непосредственно в пользовательский интерфейс приложения. Чтобы отобразить носитель, загруженный с помощью MediaPlayer, VideoDrawing необходимо использовать или DrawingContext использовать его.

Конструкторы

Имя	Описание
MediaPlayer()	Инициализирует новый экземпляр класса MediaPlayer.

Свойства

Имя	Описание
Balance	Получает или задает баланс между томами слева и справа от динамиков.
BufferingProgress	Возвращает процент буферизации, завершенного для потокового содержимого.
CanFreeze	Возвращает значение, указывающее, можно ли изменить объект. (Унаследовано от Freezable)
CanPause	Возвращает значение, указывающее, можно ли приостановить носитель.
Clock	Возвращает или задает связанный MediaClock с воспроизводимой ролью MediaTimeline .
DependencyObjectType	Возвращает объект DependencyObjectType , который упаковывает тип СРЕДЫ CLR этого экземпляра. (Унаследовано от DependencyObject)
Dispatcher	Dispatcher Возвращает это DispatcherObject значение, с которым связано. (Унаследовано от DispatcherObject)
DownloadProgress	Возвращает процент хода загрузки содержимого, расположенного на удаленном сервере.
HasAnimatedProperties	Возвращает значение, указывающее, связан ли один или несколько AnimationClock объектов с любым из свойств зависимостей этого объекта. (Унаследовано от Animatable)
HasAudio	Возвращает значение, указывающее, имеет ли носитель выходные данные звука.
HasVideo	Возвращает значение, указывающее, имеет ли носитель выходные данные видео.
IsBuffering	Возвращает значение, указывающее, является ли носитель буферизацией.
IsFrozen	Возвращает значение, указывающее, является ли объект изменяемым в настоящее время. (Унаследовано от Freezable)
IsMuted	Возвращает значение, указывающее, отключен ли носитель.
IsSealed	Возвращает значение, указывающее, запечатан ли этот экземпляр (только для чтения). (Унаследовано от DependencyObject)
NaturalDuration	Возвращает естественную длительность носителя.
NaturalVideoHeight	Возвращает высоту пикселя видео.
NaturalVideoWidth	Возвращает ширину пикселя видео.
Position	Возвращает или задает текущее положение носителя.
ScrubbingEnabled	Возвращает или задает значение, указывающее, включена ли очистка.
Source	Возвращает носитель Uri.
SpeedRatio	Получает или задает соотношение скорости воспроизведения мультимедиа.
Volume	Возвращает или задает том носителя.

Методы

Имя	Описание
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Применяется к указанному объекту AnimationClock DependencyProperty. Если свойство уже анимировано, используется указанный HandoffBehavior параметр. (Унаследовано от Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock)	Применяется к указанному объекту AnimationClock DependencyProperty. Если свойство уже анимировано, SnapshotAndReplace используется поведение передачи. (Унаследовано от Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Применяет анимацию к указанному DependencyProperty. Анимация запускается при отрисовки следующего кадра. Если указанное свойство уже анимировано, используется указанный HandoffBehavior параметр. (Унаследовано от Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Применяет анимацию к указанному DependencyProperty. Анимация запускается при отрисовки следующего кадра. Если указанное свойство уже анимировано, SnapshotAndReplace используется поведение передачи. (Унаследовано от Animatable)
CheckAccess()	Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject. (Унаследовано от DispatcherObject)
ClearValue(DependencyProperty)	Очищает локальное значение свойства. Свойство для очистки указывается идентификатором DependencyProperty . (Унаследовано от DependencyObject)
ClearValue(DependencyPropertyKey)	Очищает локальное значение свойства только для чтения. Свойство, которое необходимо очистить, задается параметром DependencyPropertyKey. (Унаследовано от DependencyObject)
Clone()	Создает модификаторный клон этого Animatableобъекта, делая глубокие копии значений этого объекта. При копировании свойств зависимостей этого объекта этот метод копирует ссылки на ресурсы и привязки данных (но они больше не могут разрешаться), но не анимации или их текущие значения. (Унаследовано от Animatable)
CloneCore(Freezable)	Делает этот экземпляр глубокой копией указанного MediaPlayer. При копировании свойств зависимостей этот метод копирует ссылки на ресурсы и привязки данных (но они больше не могут разрешаться), но не анимации или их текущие значения.
CloneCurrentValue()	Создает модификируемую клон (глубокую копию) текущего Freezable значения. (Унаследовано от Freezable)
CloneCurrentValueCore(Freezable)	Делает этот экземпляр изменяемым глубоким копированием указанного MediaPlayer с использованием текущих значений свойств. Ссылки на ресурсы, привязки данных и анимации не копируются, но их текущие значения.
Close()	Закрывает базовый носитель.
CoerceValue(DependencyProperty)	Принуждает значение указанного свойства зависимостей. Это достигается путем вызова любой CoerceValueCallback функции, указанной в метаданных свойств для свойства зависимостей, так как он существует при вызове DependencyObject. (Унаследовано от DependencyObject)
CreateInstance()	Инициализирует новый экземпляр класса Freezable. (Унаследовано от Freezable)
CreateInstanceCore()	Создает новый экземпляр MediaPlayer.
Equals(Object)	Определяет, эквивалентен ли предоставленный DependencyObject объект текущему DependencyObject. (Унаследовано от DependencyObject)
Freeze()	Делает текущий объект неизменяемым и задает для свойства значение IsFrozen`true`. (Унаследовано от Freezable)
FreezeCore(Boolean)	Делает этот Animatable объект неизменяемым или определяет, может ли он быть изменен. (Унаследовано от Animatable)
GetAnimationBaseValue(DependencyProperty)	Возвращает неанимированное значение указанного DependencyProperty. (Унаследовано от Animatable)
GetAsFrozen()	Создает замороженную копию базовых Freezable(не анимированных) значений свойств. Так как копия заморожена, все замороженные вложенные объекты копируются по ссылке. (Унаследовано от Freezable)
GetAsFrozenCore(Freezable)	Делает этот экземпляр клоном указанного MediaPlayer объекта.
GetCurrentValueAsFrozen()	Создает замороженную копию с использованием текущих значений Freezable свойств. Так как копия заморожена, все замороженные вложенные объекты копируются по ссылке. (Унаследовано от Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Делает текущий экземпляр замороженным клоном указанного Freezable. Если объект имеет анимированные свойства зависимостей, их текущие анимированные значения копируются. (Унаследовано от Freezable)
GetHashCode()	Получает хэш-код для этого DependencyObject. (Унаследовано от DependencyObject)
GetLocalValueEnumerator()	Создает специализированный перечислитель для определения того, какие свойства зависимостей имеют локальные значения для этого DependencyObject. (Унаследовано от DependencyObject)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
GetValue(DependencyProperty)	Возвращает текущее эффективное значение свойства зависимостей для этого экземпляра DependencyObject. (Унаследовано от DependencyObject)
InvalidateProperty(DependencyProperty)	Повторно вычисляет эффективное значение для указанного свойства зависимостей. (Унаследовано от DependencyObject)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
OnChanged()	Вызывается при изменении текущего Freezable объекта. (Унаследовано от Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Этот член поддерживает инфраструктуру Windows Presentation Foundation (WPF) и не предназначен для использования непосредственно из кода. (Унаследовано от Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Убедитесь, что для элемента данных, который только что был установлен, установлены DependencyObjectType соответствующие указатели контекста. (Унаследовано от Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Переопределяет DependencyObject реализацию OnPropertyChanged(DependencyPropertyChangedEventArgs) для вызова всех Changed обработчиков в ответ на изменение свойства зависимостей типа Freezable. (Унаследовано от Freezable)
Open(Uri)	Открывает заданное Uri значение для воспроизведения мультимедиа.
Pause()	Приостанавливает воспроизведение мультимедиа.
Play()	Воспроизводит носитель из текущего Position.
ReadLocalValue(DependencyProperty)	Возвращает локальное значение свойства зависимостей, если оно существует. (Унаследовано от DependencyObject)
ReadPreamble()	Гарантирует доступ к MediaPlayer из допустимого потока.
SetCurrentValue(DependencyProperty, Object)	Задает значение свойства зависимостей, не изменяя его источник значений. (Унаследовано от DependencyObject)
SetValue(DependencyProperty, Object)	Задает локальное значение свойства зависимостей, указанное его идентификатором свойства зависимостей. (Унаследовано от DependencyObject)
SetValue(DependencyPropertyKey, Object)	Задает локальное значение свойства зависимостей только для чтения, указанное DependencyPropertyKey идентификатором свойства зависимости. (Унаследовано от DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Возвращает значение, указывающее, должны ли процессы сериализации сериализовать значение для указанного свойства зависимостей. (Унаследовано от DependencyObject)
Stop()	Останавливает воспроизведение мультимедиа.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
VerifyAccess()	Принудительно применяет, что вызывающий поток имеет доступ к этому DispatcherObject. (Унаследовано от DispatcherObject)
WritePostscript()	Changed Вызывает событие для Freezable метода и вызывает его OnChanged() метод. Классы, производные от Freezable этого метода, должны вызываться в конце любого API, который изменяет элементы класса, которые не хранятся в качестве свойств зависимостей. (Унаследовано от Freezable)
WritePreamble()	Проверяет, что MediaPlayer не заморожен и к нему осуществляется доступ из допустимого контекста потоков.

События

Имя	Описание
BufferingEnded	Происходит при завершении буферизации.
BufferingStarted	Происходит при запуске буферизации.
Changed	Происходит при Freezable изменении объекта или объекта, содержащего его. (Унаследовано от Freezable)
MediaEnded	Происходит, когда носитель завершил воспроизведение.
MediaFailed	Возникает при обнаружении ошибки.
MediaOpened	Происходит при открытии носителя.
ScriptCommand	Происходит при обнаружении команды скрипта в носителе.

Применяется к

См. также раздел

Кері байланыс

Бет пайдалы болды ма?