MediaPlayer Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет воспроизведение мультимедиа для рисунков.
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- Наследование
Примеры
Практическое руководство. Воспроизведение мультимедиа с помощью 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 значение |
| 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 |
Происходит, когда в мультимедиа встречается команда скрипта. |
