MediaElement

Пакет	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

MediaElement представляет унифицированный объект мультимедийного содержимого. Он может состоять из простого мультимедийного элемента, такого как видеоролик или звук. Различные экземпляры (или подклассы) могут представлять различные типы мультимедийного содержимого. MediaElement может также представлять собой комплексный мультимедийный объект, состоящий из нескольких элементов, например видеороликов, рекламных заголовков, наложений SWF, оформления фона страницы и т. п.

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

Элемент мультимедийного содержимого функционирует на основе мультимедийного ресурса. Например, если элемент мультимедийного содержимого представляет видеопроигрыватель, то мультимедийный ресурс может инкапсулировать URL-адрес к видеопотоку. Если элемент мультимедийного содержимого представляет сложную мультимедийную компоновку, то URL-адрес ресурса мультимедийного содержимого может быть документом, содержащим ссылки на множественные ресурсы, используемые в мультимедийной компоновке.

Связанные элементы API

MediaTraitBase
MediaResourceBase

Общедоступные свойства

Скрыть унаследованные общедоступные свойства

Показать унаследованные общедоступные свойства

	Свойство		Определено
		constructor : Object Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.	Object
		container : IMediaContainer [только для чтения] Контейнер мультимедийного содержимого, который использует этот элемент.	MediaElement
		metadataNamespaceURLs : Vector.<String> [только для чтения] Вектор, содержащий URL-адреса пространств имен для всех объектов Metadata, которые хранятся в этом MediaElement.	MediaElement
		resource : MediaResourceBase Ресурс мультимедийного содержимого, в котором действует этот элемент.	MediaElement
		traitTypes : Vector.<String> [только для чтения] Вектор значений MediaTraitType, представляющих типы характеристик этого элемента мультимедийного содержимого.	MediaElement

Общедоступные методы

Скрыть унаследованные общедоступные методы

Показать унаследованные общедоступные методы

	Метод		Определено
		MediaElement() Конструктор.	MediaElement
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.	EventDispatcher
		addMetadata(namespaceURL:String, metadata:Metadata):void Добавляет объект Metadata к этому MediaElement в указанном URL-адресе пространства имен.	MediaElement
		dispatchEvent(event:Event):Boolean Посылает событие в поток событий.	EventDispatcher
		getMetadata(namespaceURL:String):Metadata Возвращает объект Metadata, сохраненный в MediaElement с указанным URL-адресом пространства имен.	MediaElement
		getTrait(type:String):org.osmf.traits:MediaTraitBase Возвращает характеристику мультимедийного содержимого указанного типа.	MediaElement
		hasEventListener(type:String):Boolean Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.	EventDispatcher
		hasOwnProperty(name:String):Boolean Показывает, определено ли заданное свойство для объекта.	Object
		hasTrait(type:String):Boolean Определяет, имеет ли этот мультимедийный элемент характеристику мультимедийного содержимого указанного типа.	MediaElement
		isPrototypeOf(theClass:Object):Boolean Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.	Object
		propertyIsEnumerable(name:String):Boolean Показывает наличие заданного свойства и его перечисляемость.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Удаляет прослушиватель из объекта EventDispatcher.	EventDispatcher
		removeMetadata(namespaceURL:String):Metadata Удаляет объект Metadata, сохраненный в MediaElement с указанным URL-адресом пространства имен.	MediaElement
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Задает доступность динамического свойства для операций цикла.	Object
		toLocaleString():String Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.	Object
		toString():String Возвращает строковое представление заданного объекта.	Object
		valueOf():Object Возвращает элементарное значение заданного объекта.	Object
		willTrigger(type:String):Boolean Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.	EventDispatcher

Защищенные методы

	Метод		Определено
		addTrait(type:String, instance:org.osmf.traits:MediaTraitBase):void Добавляет новую характеристику мультимедийного содержимого к этому мультимедийному элементу.	MediaElement
		removeTrait(type:String):org.osmf.traits:MediaTraitBase Удаляет характеристику мультимедийного содержимого из этого мультимедийного элемента.	MediaElement
		setupTraits():void Устанавливает характеристики для этого элемента мультимедийного содержимого.	MediaElement

События

Дополнительные сведения о событиях

Скрыть унаследованные события

Показать унаследованные события

	Сводка	Определено
activate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.	EventDispatcher
containerChange	Отправляется после изменения свойства контейнера элемента.	MediaElement
deactivate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.	EventDispatcher
mediaError	Отправляется при возникновении ошибки, влияющей на функционирование элемента мультимедийного содержимого.	MediaElement
mediaInfo	Отправляется, когда доступна информация, влияющая на операцию элемента мультимедиа.	MediaElement
metadataAdd	Отправляется при добавлении объекта Metadata к этому элементу мультимедийного содержимого.	MediaElement
metadataRemove	Отправляется при удалении объекта Metadata из этого элемента мультимедийного содержимого.	MediaElement
traitAdd	Отправляется при добавлении характеристики к этому элементу мультимедийного содержимого.	MediaElement
traitRemove	Отправляется при удалении характеристики из этого элемента мультимедийного содержимого.	MediaElement

Сведения о свойстве

container

свойство

container:IMediaContainer [только для чтения]

Язык версии:

ActionScript 3.0

Версия продукта:

OSMF 1.0

Версии среды выполнения:

Flash Player 10, AIR 1.5

Контейнер мультимедийного содержимого, который использует этот элемент.

Реализация
public function get container():IMediaContainer

metadataNamespaceURLs

свойство

metadataNamespaceURLs:Vector.<String> [только для чтения]

Вектор, содержащий URL-адреса пространств имен для всех объектов Metadata, которые хранятся в этом MediaElement.

Реализация
public function get metadataNamespaceURLs():Vector.<String>

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):void

traitTypes

свойство

traitTypes:Vector.<String> [только для чтения]

Язык версии:

ActionScript 3.0

Версия продукта:

OSMF 1.0

Версии среды выполнения:

Flash Player 10, AIR 1.5

Вектор значений MediaTraitType, представляющих типы характеристик этого элемента мультимедийного содержимого.

Реализация
public function get traitTypes():Vector.<String>

Сведения о конструкторе

()

Конструктор

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.

Юридическая информация | Политика конфиденциальности онлайн

MediaElement - AS3 OSMF

Классы x

container

metadataNamespaceURLs

resource

traitTypes

MediaElement

addMetadata

addTrait

getMetadata

getTrait

hasTrait

removeMetadata

removeTrait

setupTraits

containerChange

mediaError

mediaInfo

metadataAdd

metadataRemove

traitAdd

traitRemove