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

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)	Применяет AnimationClock к заданному DependencyProperty. Если свойство уже анимировано, используется эстафетное поведение SnapshotAndReplace. (Унаследовано от Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Применяет AnimationClock к заданному DependencyProperty. Если свойство уже является анимированным, используется указанное поведение HandoffBehavior. (Унаследовано от Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Применяет анимацию к указанному DependencyProperty. Анимация начинается при отрисовке следующего кадра. Если указанное свойство уже анимировано, используется поведение перемещения SnapshotAndReplace. (Унаследовано от Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Применяет анимацию к указанному DependencyProperty. Анимация начинается при отрисовке следующего кадра. Если указанное свойство уже является анимированным, используется указанное поведение HandoffBehavior. (Унаследовано от 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)	Обеспечивает создание соответствующих указателей контекста для элемента данных типа DependencyObjectType, который был только что задан. (Унаследовано от Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Этот элемент поддерживает инфраструктуру Windows Presentation Foundation (WPF) и не предназначен для использования непосредственно из кода. (Унаследовано от 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	Происходит, когда в мультимедиа встречается команда скрипта.

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

• Drawing
• VideoDrawing
• DrawingContext