| Пакет | org.osmf.media |
| Класс | public class MediaElement |
| Наследование | MediaElement  EventDispatcher Object |
| Подклассы | BeaconElement, CompositeElement, HTMLElement, LoadableElementBase, ProxyElement |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
на уровне программных средств элемент мультимедийного содержимого инкапсулирует набор мультимедийных характеристик и пространство состояний. Характеристики мультимедийного содержимого представляют возможности мультимедийного элемента и являются динамичными по характеру. Элемент мультимедийного содержимого может поддерживать поиск в один момент времени и не поддерживать в другой. Например, это может произойти, если элемент мультимедийного содержимого является видеопоследовательностью, содержащей рекламные вставки без возможности их пропуска.
Элемент мультимедийного содержимого функционирует на основе мультимедийного ресурса. Например, если элемент мультимедийного содержимого представляет видеопроигрыватель, то мультимедийный ресурс может инкапсулировать URL-адрес к видеопотоку. Если элемент мультимедийного содержимого представляет сложную мультимедийную компоновку, то URL-адрес ресурса мультимедийного содержимого может быть документом, содержащим ссылки на множественные ресурсы, используемые в мультимедийной компоновке.
Связанные элементы API
MediaResourceBase
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| container : IMediaContainer [только для чтения]
Контейнер мультимедийного содержимого, который использует этот элемент. | MediaElement | ||
| metadataNamespaceURLs : Vector.<String> [только для чтения]
Вектор, содержащий URL-адреса пространств имен для всех объектов Metadata, которые хранятся в этом MediaElement. | MediaElement | ||
| resource : MediaResourceBase
Ресурс мультимедийного содержимого, в котором действует этот элемент. | MediaElement | ||
| traitTypes : Vector.<String> [только для чтения]
Вектор значений MediaTraitType, представляющих типы характеристик этого элемента мультимедийного содержимого. | MediaElement | ||
| Метод | Определено | ||
|---|---|---|---|
Конструктор. | MediaElement | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | |
Добавляет объект Metadata к этому MediaElement в указанном URL-адресе пространства имен. | MediaElement | ||
|
Посылает событие в поток событий. | EventDispatcher | |
Возвращает объект Metadata, сохраненный в MediaElement с указанным URL-адресом пространства имен. | MediaElement | ||
Возвращает характеристику мультимедийного содержимого указанного типа. | MediaElement | ||
|
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
Определяет, имеет ли этот мультимедийный элемент характеристику мультимедийного содержимого указанного типа. | MediaElement | ||
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
Удаляет объект Metadata, сохраненный в MediaElement с указанным URL-адресом пространства имен. | MediaElement | ||
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
| Метод | Определено | ||
|---|---|---|---|
Добавляет новую характеристику мультимедийного содержимого к этому мультимедийному элементу. | MediaElement | ||
Удаляет характеристику мультимедийного содержимого из этого мультимедийного элемента. | MediaElement | ||
Устанавливает характеристики для этого элемента мультимедийного содержимого. | MediaElement | ||
| Событие | Сводка | Определено | ||
|---|---|---|---|---|
| [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным. | EventDispatcher | ||
| Отправляется после изменения свойства контейнера элемента. | MediaElement | |||
| [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным. | EventDispatcher | ||
| Отправляется при возникновении ошибки, влияющей на функционирование элемента мультимедийного содержимого. | MediaElement | |||
| Отправляется, когда доступна информация, влияющая на операцию элемента мультимедиа. | MediaElement | |||
| Отправляется при добавлении объекта Metadata к этому элементу мультимедийного содержимого. | MediaElement | |||
| Отправляется при удалении объекта Metadata из этого элемента мультимедийного содержимого. | MediaElement | |||
| Отправляется при добавлении характеристики к этому элементу мультимедийного содержимого. | MediaElement | |||
| Отправляется при удалении характеристики из этого элемента мультимедийного содержимого. | MediaElement | |||
container | свойство |
container:IMediaContainer [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Контейнер мультимедийного содержимого, который использует этот элемент.
Реализация
public function get container():IMediaContainermetadataNamespaceURLs | свойство |
resource | свойство |
resource:MediaResourceBase| Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Ресурс мультимедийного содержимого, в котором действует этот элемент.
Реализация
public function get resource():MediaResourceBase public function set resource(value:MediaResourceBase):voidtraitTypes | свойство |
traitTypes:Vector.<String> [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Вектор значений MediaTraitType, представляющих типы характеристик этого элемента мультимедийного содержимого.
Реализация
public function get traitTypes():Vector.<String>MediaElement | () | Конструктор |
public function MediaElement()| Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Конструктор.
addMetadata | () | метод |
public function addMetadata(namespaceURL:String, metadata:Metadata):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Добавляет объект Metadata к этому MediaElement в указанном URL-адресе пространства имен.
Параметры
namespaceURL:String — URL-адрес пространства имен, используемый для хранения метаданных.
| |
metadata:Metadata — Добавляемые метаданные.
|
Выдает
ArgumentError — если namespaceURL или метаданные - null.
|
addTrait | () | метод |
protected function addTrait(type:String, instance:org.osmf.traits:MediaTraitBase):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Добавляет новую характеристику мультимедийного содержимого к этому мультимедийному элементу. В случае успешного выполнения отправляет MediaElementEvent.
Параметры
type:String — MediaTraitType для добавляемой мультимедийной характеристики.
| |
instance:org.osmf.traits:MediaTraitBase — Добавляемая характеристика мультимедийного содержимого.
|
Выдает
ArgumentError — Если любой из параметров является null, не совпадают указанный тип и тип характеристики мультимедийного содержимого или если уже добавлен другой экземпляр указанного класса характеристики.
|
getMetadata | () | метод |
public function getMetadata(namespaceURL:String):Metadata| Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Возвращает объект Metadata, сохраненный в MediaElement с указанным URL-адресом пространства имен.
Параметры
namespaceURL:String — URL-адрес пространства имен объекта Metadata для получения.
|
Metadata |
Выдает
ArgumentError — Если namespaceURL - null.
|
getTrait | () | метод |
public function getTrait(type:String):org.osmf.traits:MediaTraitBase| Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Возвращает характеристику мультимедийного содержимого указанного типа.
Параметры
type:String — MediaTraitType для возвращаемой мультимедийной характеристики.
|
org.osmf.traits:MediaTraitBase — Полученная характеристика или null, если такая характеристика не существует в этом элементе мультимедийного содержимого.
|
Выдает
ArgumentError — Если параметр имеет значение null.
|
hasTrait | () | метод |
public function hasTrait(type:String):Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Определяет, имеет ли этот мультимедийный элемент характеристику мультимедийного содержимого указанного типа.
Параметры
type:String — MediaTraitType для проверяемой мультимедийной характеристики.
|
Boolean — true, если мультимедийный элемент имеет характеристику мультимедийного содержимого указанного класса, и false в противном случае.
|
Выдает
ArgumentError — Если параметр имеет значение null.
|
removeMetadata | () | метод |
public function removeMetadata(namespaceURL:String):Metadata| Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Удаляет объект Metadata, сохраненный в MediaElement с указанным URL-адресом пространства имен.
Параметры
namespaceURL:String — URL-адрес пространства имен метаданных, которые будут удалены.
|
Metadata |
Выдает
ArgumentError — Если namespaceURL - null.
|
removeTrait | () | метод |
protected function removeTrait(type:String):org.osmf.traits:MediaTraitBase| Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Удаляет характеристику мультимедийного содержимого из этого мультимедийного элемента. В случае успешного выполнения отправляет MediaElementEvent.
Параметры
type:String — MediaTraitType для удаляемой мультимедийной характеристики.
|
org.osmf.traits:MediaTraitBase — Удаленная характеристика или null, если характеристики не удалены.
|
Выдает
ArgumentError — Если параметр имеет значение null.
|
setupTraits | () | метод |
protected function setupTraits():void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Устанавливает характеристики для этого элемента мультимедийного содержимого. Происходит во время обработки. Подклассы должны переопределить этот метод и вызвать addTrait для каждой из собственных характеристик.
containerChange | Событие |
org.osmf.events.ContainerChangeEventсвойство ContainerChangeEvent.type =
org.osmf.events.ContainerChangeEvent.CONTAINER_CHANGE| Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Отправляется после изменения свойства контейнера элемента.
Константа ContainerChangeEvent.CONTAINER_CHANGE определяет значение свойства type объекта события containerChange.mediaError | Событие |
org.osmf.events.MediaErrorEventсвойство MediaErrorEvent.type =
org.osmf.events.MediaErrorEvent.MEDIA_ERROR| Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Отправляется при возникновении ошибки, влияющей на функционирование элемента мультимедийного содержимого.
Константа MediaErrorEvent.MEDIA_ERROR определяет значение свойства type объекта события mediaError.mediaInfo | Событие |
org.osmf.events.MediaErrorEventсвойство MediaErrorEvent.type =
org.osmf.events.MediaErrorEvent.MEDIA_INFO| Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 2.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Отправляется, когда доступна информация, влияющая на операцию элемента мультимедиа. События MEDIA_INFO не являются критическими.
metadataAdd | Событие |
org.osmf.events.MediaElementEventсвойство MediaElementEvent.type =
org.osmf.events.MediaElementEvent.METADATA_ADD| Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Отправляется при добавлении объекта Metadata к этому элементу мультимедийного содержимого.
Константа MediaElementEvent.METADATA_ADD определяет значение свойства type объекта события metadataAdd.metadataRemove | Событие |
org.osmf.events.MediaElementEventсвойство MediaElementEvent.type =
org.osmf.events.MediaElementEvent.METADATA_REMOVE| Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Отправляется при удалении объекта Metadata из этого элемента мультимедийного содержимого.
Константа MediaElementEvent.METADATA_REMOVE определяет значение свойства type объекта события metadataRemove.traitAdd | Событие |
org.osmf.events.MediaElementEventсвойство MediaElementEvent.type =
org.osmf.events.MediaElementEvent.TRAIT_ADD| Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Отправляется при добавлении характеристики к этому элементу мультимедийного содержимого.
Константа MediaElementEvent.TRAIT_ADD определяет значение свойства type объекта события traitAdd.traitRemove | Событие |
org.osmf.events.MediaElementEventсвойство MediaElementEvent.type =
org.osmf.events.MediaElementEvent.TRAIT_REMOVE| Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Отправляется при удалении характеристики из этого элемента мультимедийного содержимого.
Константа MediaElementEvent.TRAIT_REMOVE определяет значение свойства type объекта события traitRemove.Tue Jun 12 2018, 11:34 AM Z