| Пакет | org.osmf.media |
| Класс | public class MediaFactory |
| Наследование | MediaFactory  EventDispatcher Object |
| Подклассы | DefaultMediaFactory |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Операция фабрики принимает MediaResourceBase в качестве входного значения и создает MediaElement как выходное значение.
MediaFactory поддерживает список объектов MediaFactoryItem, каждый из которых инкапсулирует всю информацию, необходимую для создания определенного MediaElement. MediaFactory использует метод canHandleResourceFunction каждого MediaFactoryItem для поиска объекта MediaFactoryItem, который может обработать указанный MediaResourceBase.
Интерфейс фабрики также предоставляет методы для создания запросов для определенных объектов MediaFactoryItem и для загрузки внешних модулей (в которых хранятся объекты MediaFactoryItem).
Связанные элементы API
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| numItems : int [только для чтения]
Количество MediaFactoryItems, управляемых фабрикой. | MediaFactory | ||
| Метод | Определено | ||
|---|---|---|---|
Конструктор. | MediaFactory | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | |
Добавляет указанный MediaFactoryItem к фабрике. | MediaFactory | ||
Возвращает MediaElement, который может быть создан на основе указанного MediaResourceBase. | MediaFactory | ||
|
Посылает событие в поток событий. | EventDispatcher | |
Получает MediaFactoryItem с заданной позицией индекса. | MediaFactory | ||
Возвращает MediaFactoryItem с указанным идентификатором или null, если указанный MediaFactoryItem не существует в этой фабрике. | MediaFactory | ||
|
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
Загрузка внешнего модуля, определенного указанным ресурсом. | MediaFactory | ||
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
Удаляет указанный MediaFactoryItem из фабрики. | MediaFactory | ||
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
| Метод | Определено | ||
|---|---|---|---|
Возвращает наиболее соответствующий MediaFactoryItem для указанного ресурса из MediaFactoryItems в указанном списке. | MediaFactory | ||
| Событие | Сводка | Определено | ||
|---|---|---|---|---|
| [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным. | EventDispatcher | ||
| [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным. | EventDispatcher | ||
| Отправляется, когда MediaFactory создает MediaElement. | MediaFactory | |||
| Отправляется, когда MediaFactory удается успешно загрузить внешний модуль. | MediaFactory | |||
| Отправляется, когда MediaFactory не удается загрузить внешний модуль вследствие ошибки. | MediaFactory | |||
numItems | свойство |
MediaFactory | () | Конструктор |
public function MediaFactory()| Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Конструктор.
addItem | () | метод |
public function addItem(item:MediaFactoryItem):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Добавляет указанный MediaFactoryItem к фабрике. После добавления MediaFactoryItem в фабрике можно создать мультимедийные элементы, соответствующие любому объекту MediaResourceBase, который может обработать данный MediaFactoryItem. Если в этой фабрике уже существует MediaFactoryItem с аналогичным идентификатором, то он будет заменен новым объектом MediaFactoryItem.
Параметры
item:MediaFactoryItem — Добавляемый MediaFactoryItem.
|
Выдает
ArgumentError — Если аргумент является null или если аргумент имеет поле идентификатора null.
|
createMediaElement | () | метод |
public function createMediaElement(resource:MediaResourceBase):MediaElement| Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Возвращает MediaElement, который может быть создан на основе указанного MediaResourceBase.
Возвращает null, если фабрике не удается найти объект MediaFactoryItem, с помощью которого можно создать такой элемент MediaElement в этой фабрике.
Параметры
resource:MediaResourceBase — MediaResourceBase, для которого должен быть создан соответствующий MediaElement.
|
MediaElement — Созданный MediaElement или null, если в ресурсе невозможно создать такой MediaElement.
|
getItemAt | () | метод |
public function getItemAt(index:int):MediaFactoryItem| Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Получает MediaFactoryItem с заданной позицией индекса.
Параметры
index:int — Индекс в списке, из которого извлекается MediaFactoryItem.
|
MediaFactoryItem — MediaFactoryItem в этом индексе или null при его отсутствии.
|
getItemById | () | метод |
public function getItemById(id:String):MediaFactoryItem| Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Возвращает MediaFactoryItem с указанным идентификатором или null, если указанный MediaFactoryItem не существует в этой фабрике.
Параметры
id:String — Идентификатор MediaFactoryItem для получения.
|
MediaFactoryItem — MediaFactoryItem с указанным идентификатором или null, если указанный MediaFactoryItem не существует в этой фабрике.
|
loadPlugin | () | метод |
public function loadPlugin(resource:MediaResourceBase):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Загрузка внешнего модуля, определенного указанным ресурсом. MediaFactory не будет перезагружать внешний модуль, если он уже загружен. После успешной загрузки элементы MediaFactoryItem в свойстве PluginInfo этого внешнего модуля будут добавлены к этой MediaFactory и будет отправлено событие MediaFactoryEvent.PLUGIN_LOAD. Если не удается выполнить загрузку, отправляется событие MediaFactoryEvent.PLUGIN_LOAD_ERROR.
Параметры
resource:MediaResourceBase — MediaResourceBase, представляющий внешний модуль. Для удаленных (динамических) внешних модулей используйте URLResource с указанием на удаленный файл SWF для загрузки. Для локальных (статических) внешних модулей используйте PluginInfoResource.
|
Выдает
ArgumentError — Если ресурс - null или не является URLResource или PluginInfoResource.
|
removeItem | () | метод |
public function removeItem(item:MediaFactoryItem):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Удаляет указанный MediaFactoryItem из фабрики. Если в этой фабрике не существует MediaFactoryItem, действия не выполняются.
Параметры
item:MediaFactoryItem — Удаляемый MediaFactoryItem.
|
Выдает
ArgumentError — Если аргумент является null или если аргумент имеет поле идентификатора null.
|
resolveItems | () | метод |
protected function resolveItems(resource:MediaResourceBase, items:Vector.<MediaFactoryItem>):MediaFactoryItem
Возвращает наиболее соответствующий MediaFactoryItem для указанного ресурса из MediaFactoryItems в указанном списке. Этот метод вызывается при вызове createMediaElement с ресурсом, который можно обработать с использованием более одного элемента MediaFactoryItem. Подклассы могут переопределять метод для выбора наиболее подходящего метода. Поведением по умолчанию является выбор первого элемента, который не является "собственным" для инфраструктуры, согласно теоретическому предположению, что внешние модули должны иметь приоритет над основными мультимедийными типами. Это решение принимается на основе наличия или отсутствия значения идентификатора, которое начинается с "org.osmf".
Параметры
resource:MediaResourceBase | |
items:Vector.<MediaFactoryItem> |
MediaFactoryItem |
mediaElementCreate | Событие |
org.osmf.events.MediaFactoryEventсвойство MediaFactoryEvent.type =
org.osmf.events.MediaFactoryEvent.MEDIA_ELEMENT_CREATE| Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Отправляется, когда MediaFactory создает MediaElement.
Константа MediaFactoryEvent.MEDIA_ELEMENT_CREATE определяет значение свойства type объекта события mediaElementCreate.pluginLoad | Событие |
org.osmf.events.MediaFactoryEventсвойство MediaFactoryEvent.type =
org.osmf.events.MediaFactoryEvent.PLUGIN_LOAD| Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Отправляется, когда MediaFactory удается успешно загрузить внешний модуль.
Константа MediaFactoryEvent.PLUGIN_LOAD определяет значение свойства type объекта события pluginLoad.pluginLoadError | Событие |
org.osmf.events.MediaFactoryEventсвойство MediaFactoryEvent.type =
org.osmf.events.MediaFactoryEvent.PLUGIN_LOAD_ERROR| Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Отправляется, когда MediaFactory не удается загрузить внешний модуль вследствие ошибки.
Константа MediaFactoryEvent.PLUGIN_LOAD_ERROR определяет значение свойства type объекта события pluginLoadError.
package org.osmf.media
{
import flash.display.Sprite;
import org.osmf.events.MediaFactoryEvent;
public class MediaFactoryExample extends Sprite
{
public function MediaFactoryExample()
{
// Construct a media factory, and listen to its plug-in related events:
var factory:MediaFactory = new MediaFactory();
factory.addEventListener(MediaFactoryEvent.PLUGIN_LOAD, onPluginLoaded);
factory.addEventListener(MediaFactoryEvent.PLUGIN_LOAD_ERROR, onPluginLoadError);
// Instruct the factory to load the plug-in at the given url:
factory.loadPlugin(new URLResource("http://myinvalidurl.com/foo.swf"));
}
private function onPluginLoaded(event:MediaFactoryEvent):void
{
// Use the factory to create a media-element related to the plugin:
var factory:MediaFactory = event.target as MediaFactory;
factory.createMediaElement(new URLResource("http://myinvalidurl.com/content"));
}
private function onPluginLoadError(event:MediaFactoryEvent):void
{
// Handle plug-in loading failure:
trace("Plugin failed to load.");
}
}
}
Tue Jun 12 2018, 11:34 AM Z