Media Player Класс

Определение

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

Примеры

Комментарии

Несмотря на то, что экземпляр этого класса можно объявить в XAML (XAML), вы не сможете загружать и воспроизводить его мультимедиа без использования кода. Although you can declare an instance of this class in Extensible Application Markup Language (XAML), you cannot load and play its media without using code. Для воспроизведения мультимедиа только в XAML используйте MediaElement . To play media in XAML only, use a MediaElement. Кроме того, при объявлении экземпляра в XAML единственным практичным применением является заполнение синтаксиса элемента свойства для Player Свойства. Also, if you declare an instance in XAML, the only practical use is to fill property element syntax for the Player property.

При распространении мультимедиа вместе с приложением файл мультимедиа нельзя использовать как ресурс проекта. When distributing media with your application, you cannot use a media file as a project resource. Вместо этого в файле проекта необходимо выбрать тип мультимедиа Content и задать для CopyToOutputDirectory значение PreserveNewest или Always . In your project file, you must instead set the media type to Content and set CopyToOutputDirectory to PreserveNewest or Always .

MediaPlayer можно использовать в двух разных режимах, в зависимости от того, что влияет на проигрыватель: независимого режима или часового режима. MediaPlayer can be used in two different modes, depending on what is driving the player: independent mode or clock mode. В независимом режиме платформа MediaPlayer является аналогом изображения и носителя, открытого с помощью метода, который используется для Open воспроизведения. In independent mode, the MediaPlayer is analogous to an image and the media opened through the Open method drives playback. В режиме часов объект MediaPlayer можно рассматривать как цель для анимации, и поэтому он будет иметь соответствующие Timeline Clock записи и в дереве времени, которое управляет воспроизведением. In Clock mode, the MediaPlayer can be thought of as a target for an animation, and thus it will have corresponding Timeline and Clock entries in the Timing tree which controls playback. Дополнительные сведения о режимах мультимедиа см. в обзоре мультимедиа. For more information on media modes, see the Multimedia Overview.

MediaPlayer отличается от MediaElement в, что не является элементом управления, который можно добавить непосредственно в пользовательский интерфейс приложения. MediaPlayer is different from a MediaElement in that it is not a control that can be added directly to the user interface (UI) of an application. Чтобы отобразить носитель, загруженный с помощью MediaPlayer , VideoDrawing DrawingContext необходимо использовать или. To display media loaded using MediaPlayer, a VideoDrawing or DrawingContext must be used.

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

Инициализирует новый экземпляр класса MediaPlayer. Initializes a new instance of the MediaPlayer class.

Свойства

Получает или задает баланс громкости между левыми и правыми динамиками. Gets or sets the balance between the left and right speaker volumes.

Получает процент буферизации потокового содержимого. Gets the percentage of buffering completed for streaming content.

Возвращает значение, которое указывает, можно ли сделать объект неизменяемым. Gets a value that indicates whether the object can be made unmodifiable.

(Унаследовано от Freezable) CanPause

Возвращает значение, показывающее, можно ли приостановить воспроизведение файла мультимедиа. Gets a value indicating whether the media can be paused.

Получает или задает объект MediaClock, связанный с подлежащим воспроизведению MediaTimeline. Gets or sets the MediaClock associated with the MediaTimeline to be played.

Возвращает объект DependencyObjectType , который заключает в оболочку тип CLR данного экземпляра. Gets the DependencyObjectType that wraps the CLR type of this instance.

(Унаследовано от DependencyObject) Dispatcher

Возвращает объект Dispatcher, с которым связан этот объект DispatcherObject. Gets the Dispatcher this DispatcherObject is associated with.

(Унаследовано от DispatcherObject) DownloadProgress

Получает процентное значение, показывающее процент загрузки содержимого, расположенного на удаленном сервере. Gets the percentage of download progress for content located at a remote server.

Возвращает значение, которое указывает, сопоставлены ли один или несколько объектов AnimationClock любому из свойств зависимостей этого объекта. Gets a value that indicates whether one or more AnimationClock objects is associated with any of this object’s dependency properties.

(Унаследовано от Animatable) HasAudio

Получает значение, указывающее, содержит ли мультимедиа звуковые выходные данные. Gets a value that indicating whether the media has audio output.

Получает значение, указывающее, содержит ли мультимедиа выходные видеоданные. Gets a value that indicates whether the media has video output.

Получает значение, указывающее, выполняется ли буферизация мультимедиа. Gets a value that indicates whether the media is buffering.

Получает значение, указывающее, доступен ли объект для изменения в настоящее время. Gets a value that indicates whether the object is currently modifiable.

(Унаследовано от Freezable) IsMuted

Получает значение, указывающее, отключен ли звук мультимедиа. Gets a value that indicates whether the media is muted.

Получает значение, указывающее, является ли этот экземпляр в данный момент запечатанным (доступным только для чтения). Gets a value that indicates whether this instance is currently sealed (read-only).

(Унаследовано от DependencyObject) NaturalDuration

Получает естественную продолжительность мультимедиа. Gets the natural duration of the media.

Получает высоту видео в пикселях. Gets the pixel height of the video.

Получает ширину видео в пикселях. Gets the pixel width of the video.

Получает или задает текущую позицию мультимедиа. Gets or sets the current position of the media.

Получает или задает значение, указывающее, включена ли очистка. Gets or sets a value that indicates whether scrubbing is enabled.

Получает Uri мультимедиа. Gets the media Uri.

Получает или задает коэффициент скорости воспроизведения мультимедиа. Gets or sets the ratio of speed that media is played at.

Получает или задает громкость мультимедиа. Gets or sets the media’s volume.

Методы

Применяет AnimationClock к заданному DependencyProperty. Applies an AnimationClock to the specified DependencyProperty. Если свойство уже анимировано, используется эстафетное поведение SnapshotAndReplace. If the property is already animated, the SnapshotAndReplace handoff behavior is used.

(Унаследовано от Animatable) ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Применяет AnimationClock к заданному DependencyProperty. Applies an AnimationClock to the specified DependencyProperty. Если свойство уже является анимированным, используется указанное поведение HandoffBehavior. If the property is already animated, the specified HandoffBehavior is used.

(Унаследовано от Animatable) BeginAnimation(DependencyProperty, AnimationTimeline)

Применяет анимацию к указанному DependencyProperty. Applies an animation to the specified DependencyProperty. Анимация начинается при отрисовке следующего кадра. The animation is started when the next frame is rendered. Если указанное свойство уже анимировано, используется поведение перемещения SnapshotAndReplace. If the specified property is already animated, the SnapshotAndReplace handoff behavior is used.

(Унаследовано от Animatable) BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

Применяет анимацию к указанному DependencyProperty. Applies an animation to the specified DependencyProperty. Анимация начинается при отрисовке следующего кадра. The animation is started when the next frame is rendered. Если указанное свойство уже является анимированным, используется указанное поведение HandoffBehavior. If the specified property is already animated, the specified HandoffBehavior is used.

(Унаследовано от Animatable) CheckAccess()

Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject. Determines whether the calling thread has access to this DispatcherObject.

(Унаследовано от DispatcherObject) ClearValue(DependencyProperty)

Очищает локальное значение свойства. Clears the local value of a property. Очищаемое свойство задается идентификатором DependencyProperty. The property to be cleared is specified by a DependencyProperty identifier.

(Унаследовано от DependencyObject) ClearValue(DependencyPropertyKey)

Очищает локальное значение доступного только для чтения свойства. Clears the local value of a read-only property. Очищаемое свойство задается ключом DependencyPropertyKey. The property to be cleared is specified by a DependencyPropertyKey.

(Унаследовано от DependencyObject) Clone()

Создает изменяемый клон данного объекта Animatable, делая глубокие копии значений этого объекта. Creates a modifiable clone of this Animatable, making deep copies of this object’s values. При копировании свойств зависимостей объекта этот метод копирует указатели на ресурсы и связи с данными (которые могут уже не быть разрешимыми), но не копирует анимации и их текущие значения. When copying this object’s dependency properties, this method copies resource references and data bindings (but they might no longer resolve) but not animations or their current values.

(Унаследовано от Animatable) CloneCore(Freezable)

Делает этот экземпляр глубокой копией указанного объекта MediaPlayer. Makes this instance a deep copy of the specified MediaPlayer. При копировании свойств зависимостей этот метод копирует ссылки на ресурсы и привязки данных (которые могут уже не быть разрешимыми), но не копирует анимации и их текущие значения. When copying dependency properties, this method copies resource references and data bindings (but they might no longer resolve) but not animations or their current values.

Создает редактируемую копию (глубокую копию) объекта Freezable с использованием его текущих значений. Creates a modifiable clone (deep copy) of the Freezable using its current values.

(Унаследовано от Freezable) CloneCurrentValueCore(Freezable)

Делает этот экземпляр изменяемой глубокой копией указанной коллекции MediaPlayer с использованием текущих значений свойств. Makes this instance a modifiable deep copy of the specified MediaPlayer using current property values. Ссылки на ресурсы, привязки данных и анимации не копируются, но копируются их текущие значения. Resource references, data bindings, and animations are not copied, but their current values are.

Закрывает мультимедиа. Closes the underlying media.

Приводит значение указанного свойства зависимостей. Coerces the value of the specified dependency property. Это осуществляется путем вызова какой-либо функции CoerceValueCallback, указанной в метаданных свойства зависимостей, которое существует в вызывающем объекте DependencyObject. This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Унаследовано от DependencyObject) CreateInstance()

Инициализирует новый экземпляр класса Freezable. Initializes a new instance of the Freezable class.

(Унаследовано от Freezable) CreateInstanceCore()

Создает новый экземпляр MediaPlayer. Creates a new MediaPlayer instance.

Определяет, является ли указанный DependencyObject эквивалентом текущего DependencyObject. Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Унаследовано от DependencyObject) Freeze()

Делает текущий объект неизменяемым и присваивает его свойству IsFrozen значение true . Makes the current object unmodifiable and sets its IsFrozen property to true .

(Унаследовано от Freezable) FreezeCore(Boolean)

Делает данный объект Animatable неизменяемым или определяет, может ли он быть сделан неизменяемым. Makes this Animatable object unmodifiable or determines whether it can be made unmodifiable.

(Унаследовано от Animatable) GetAnimationBaseValue(DependencyProperty)

Возвращает не анимированное значение указанного объекта DependencyProperty. Returns the non-animated value of the specified DependencyProperty.

(Унаследовано от Animatable) GetAsFrozen()

Создает фиксированную копию объекта Freezable, используя базовые (не анимационные) значения свойств. Creates a frozen copy of the Freezable, using base (non-animated) property values. Так как копия является фиксированной, копируются только ссылки на фиксированные вложенные объекты. Because the copy is frozen, any frozen sub-objects are copied by reference.

(Унаследовано от Freezable) GetAsFrozenCore(Freezable)

Делает этот экземпляр клоном указанного объекта MediaPlayer. Makes this instance a clone of the specified MediaPlayer object.

Создает фиксированную копию объекта Freezable с использованием текущих значений свойств. Creates a frozen copy of the Freezable using current property values. Так как копия является фиксированной, копируются только ссылки на фиксированные вложенные объекты. Because the copy is frozen, any frozen sub-objects are copied by reference.

(Унаследовано от Freezable) GetCurrentValueAsFrozenCore(Freezable)

Создает текущий экземпляр замороженной копии указанного объекта Freezable. Makes the current instance a frozen clone of the specified Freezable. Если объект имеет анимированные свойства зависимостей, копируются их текущие анимированные значения. If the object has animated dependency properties, their current animated values are copied.

(Унаследовано от Freezable) GetHashCode()

Возвращает хэш-код для данного объекта DependencyObject. Gets a hash code for this DependencyObject.

(Унаследовано от DependencyObject) GetLocalValueEnumerator()

Создает специализированный перечислитель для определения свойств зависимостей, которые локально установили значения для данного DependencyObject. Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Унаследовано от DependencyObject) GetType()

Возвращает объект Type для текущего экземпляра. Gets the Type of the current instance.

(Унаследовано от Object) GetValue(DependencyProperty)

Возвращает текущее действующее значение свойства зависимостей в этом экземпляре DependencyObject. Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Унаследовано от DependencyObject) InvalidateProperty(DependencyProperty)

Повторно вычисляет действующее значение для указанного свойства зависимостей. Re-evaluates the effective value for the specified dependency property.

(Унаследовано от DependencyObject) MemberwiseClone()

Создает неполную копию текущего объекта Object. Creates a shallow copy of the current Object.

(Унаследовано от Object) OnChanged()

Вызывается при изменении текущего объекта Freezable. Called when the current Freezable object is modified.

(Унаследовано от Freezable) OnFreezablePropertyChanged(DependencyObject, DependencyObject)

Обеспечивает создание соответствующих указателей контекста для элемента данных типа DependencyObjectType, который был только что задан. Ensures that appropriate context pointers are established for a DependencyObjectType data member that has just been set.

(Унаследовано от Freezable) OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)

Этот элемент поддерживает инфраструктуру Windows Presentation Foundation (WPF) и не предназначен для непосредственного использования из кода. This member supports the Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

(Унаследовано от Freezable) OnPropertyChanged(DependencyPropertyChangedEventArgs)

Переопределяет реализацию DependencyObject для OnPropertyChanged(DependencyPropertyChangedEventArgs), чтобы также вызвать любой обработчик Changed в ответ на изменение свойства зависимостей типа Freezable. Overrides the DependencyObject implementation of OnPropertyChanged(DependencyPropertyChangedEventArgs) to also invoke any Changed handlers in response to a changing dependency property of type Freezable.

(Унаследовано от Freezable) Open(Uri)

Открывает заданныйUri для воспроизведения мультимедиа. Opens the given Uri for media playback.

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

Воспроизводит мультимедиа с текущего Position. Plays media from the current Position.

Возвращает локальное значение свойства зависимостей, если таковое существует. Returns the local value of a dependency property, if it exists.

(Унаследовано от DependencyObject) ReadPreamble()

Гарантирует, что доступ к MediaPlayer осуществляется из допустимого потока. Ensures that the MediaPlayer is being accessed from a valid thread.

Задает значение свойства зависимостей, не меняя источник значения. Sets the value of a dependency property without changing its value source.

(Унаследовано от DependencyObject) SetValue(DependencyProperty, Object)

Задает локальное значение свойства зависимостей, указанного идентификатором этого свойства. Sets the local value of a dependency property, specified by its dependency property identifier.

(Унаследовано от DependencyObject) SetValue(DependencyPropertyKey, Object)

Задает локальное значение свойства зависимости только для чтения, определяемое идентификатором DependencyPropertyKey свойства зависимостей. Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Унаследовано от DependencyObject) ShouldSerializeProperty(DependencyProperty)

Возвращает значение, которое указывает, следует ли процессам сериализации выполнять сериализацию значения для предоставленного свойства зависимостей. Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Унаследовано от DependencyObject) Stop()

Останавливает воспроизведения мультимедиа. Stops media playback.

Возвращает строку, представляющую текущий объект. Returns a string that represents the current object.

(Унаследовано от Object) VerifyAccess()

Обеспечивает наличие у вызывающего потока доступ к этому DispatcherObject. Enforces that the calling thread has access to this DispatcherObject.

(Унаследовано от DispatcherObject) WritePostscript()

Вызывает событие Changed для объекта Freezable и вызывает его метод OnChanged(). Raises the Changed event for the Freezable and invokes its OnChanged() method. Классы, производные от Freezable, должны вызывать этот метод в конце любого API, который изменяет члены класса, не сохраненные в виде свойств зависимостей. Classes that derive from Freezable should call this method at the end of any API that modifies class members that are not stored as dependency properties.

(Унаследовано от Freezable) WritePreamble()

Проверяет, что MediaPlayer не заморожен и доступ к нему осуществляется из допустимого контекста потока. Verifies that the MediaPlayer is not frozen and that it is being accessed from a valid threading context.

События

Происходит по завершении буферизации. Occurs when buffering has finished.

Происходит, когда буферизация началась. Occurs when buffering has started.

Происходит, когда изменяется класс Freezable или объект, который входит в его состав. Occurs when the Freezable or an object it contains is modified.

(Унаследовано от Freezable) MediaEnded

Происходит при завершении воспроизведения мультимедиа. Occurs when the media has finished playback.

Происходит при ошибке. Occurs when an error is encountered.

Происходит при открытии мультимедиа. Occurs when the media is opened.

Происходит, когда в мультимедиа встречается команда скрипта. Occurs when a script command has been encountered within the media.