| Пакет | org.osmf.media |
| Класс | public class PluginInfo |
| Наследование | PluginInfo  Object |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
В инфраструктуре Open Source Media Framework целью внешнего модуля является отображение объектов MediaFactoryItem, представляющих мультимедийное содержимое, обрабатываемое внешним модулем. С помощью этих объектов MediaFactoryItem можно описывать стандартные типы мультимедийного содержимого, такие как видеоролики, аудиозаписи или изображения, которые могут быть представлены встроенными элементами MediaElement инфраструктуры Open Source Media Framework: VideoElement, AudioElement или ImageElement. Более вероятно, что внешний модуль обеспечивает некую специализированную обработку, например пользовательский загрузчик или специализированный элемент мультимедийного содержимого с пользовательской реализацией характеристик. Например, внешний модуль, который обеспечивает трекинг, мог бы реализовать TrackingCompositeElement с включенным в него пользовательским загрузчиком и пользовательской реализацией PlayTrait, с помощью которых запускается и останавливается трекинг и видеоролик.
Посредством PluginInfo внешний модуль может принять или отклонить определенную версию инфраструктуры Open Source Media Framework с помощью метода isFrameworkVersionSupported().
Динамический внешний модуль загружается во время выполнения из SWF. Компиляция статического внешнего модуля является компонентом приложения инфраструктуры Open Source Media Framework. При попытке загрузки динамического внешнего модуля приложение выполняет доступ к классу, который расширяет PluginInfo с помощью свойства pluginInfo в корневом каталоге файла SWF внешнего модуля. Если этот класс не найден, то внешний модуль не загружен. При попытке загрузки статического внешнего модуля приложение выполняет доступ к PluginInfo, представленному объектом PluginInfoResource.
Связанные элементы API
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| frameworkVersion : String [только для чтения]
Версия инфраструктуры, с учетом которой выполнялась компиляция этого внешнего модуля. | PluginInfo | ||
| mediaElementCreationNotificationFunction : Function [только для чтения]
Дополнительная функция, которая вызывается для каждого MediaElement, созданного в MediaFactory, в которую добавлены объекты MediaFactoryItem этого внешнего модуля. | PluginInfo | ||
| numMediaFactoryItems : int [только для чтения]
Количество объектов MediaFactoryItem, которые внешний модуль предоставляет приложению загрузки. | PluginInfo | ||
| Свойство | Определено | ||
|---|---|---|---|
| mediaFactoryItems : Vector.<MediaFactoryItem>
Объекты MediaFactoryItem, которые предоставляет этот PluginInfo. | PluginInfo | ||
| Метод | Определено | ||
|---|---|---|---|
PluginInfo(mediaFactoryItems:Vector.<MediaFactoryItem> = null, mediaElementCreationNotificationFunction:Function = null)
Конструктор. | PluginInfo | ||
Возвращает объект MediaFactoryItem в указанной позиции индекса. | PluginInfo | ||
|
Показывает, определено ли заданное свойство для объекта. | Object | |
Метод инициализации, который вызывается инфраструктурой мультимедийного содержимого при инициализации этого внешнего модуля и предоставляет внешнему модулю ресурс, который использовался для запроса внешнего модуля. | PluginInfo | ||
Возвращает true, если внешний модуль поддерживает указанную версию инфраструктуры. В этом случае загружаемое приложение загружает внешний модуль. | PluginInfo | ||
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
|
Возвращает элементарное значение заданного объекта. | Object | |
| Константа | Определено | ||
|---|---|---|---|
| PLUGIN_MEDIAFACTORY_NAMESPACE : String = "http://www.osmf.org/plugin/mediaFactory/1.0" [статические]
URL-адрес пространства имен метаданных для MediaFactory, передаваемый из проигрывателя во внешний модуль. | PluginInfo | ||
frameworkVersion | свойство |
frameworkVersion:String [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Версия инфраструктуры, с учетом которой выполнялась компиляция этого внешнего модуля. Текущую версию можно получить из org.osmf.utils.Version.version.
Реализация
public function get frameworkVersion():StringmediaElementCreationNotificationFunction | свойство |
mediaElementCreationNotificationFunction:Function [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Дополнительная функция, которая вызывается для каждого MediaElement, созданного в MediaFactory, в которую добавлены объекты MediaFactoryItem этого внешнего модуля. Функция должна принимать один параметр типа MediaElement и возвращать пустое значение. Эта функция обратного вызова используется для внешних модулей, для которых необходимо извещение в случае создания других элементов MediaElement (т. е. при их прослушивании или управлении).
Реализация
public function get mediaElementCreationNotificationFunction():FunctionmediaFactoryItems | свойство |
mediaFactoryItems:Vector.<MediaFactoryItem>Объекты MediaFactoryItem, которые предоставляет этот PluginInfo.
Реализация
protected function get mediaFactoryItems():Vector.<MediaFactoryItem> protected function set mediaFactoryItems(value:Vector.<MediaFactoryItem>):voidnumMediaFactoryItems | свойство |
numMediaFactoryItems:int [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Количество объектов MediaFactoryItem, которые внешний модуль предоставляет приложению загрузки.
Реализация
public function get numMediaFactoryItems():intPluginInfo | () | Конструктор |
public function PluginInfo(mediaFactoryItems:Vector.<MediaFactoryItem> = null, mediaElementCreationNotificationFunction:Function = null)| Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Конструктор.
ПараметрыmediaFactoryItems:Vector.<MediaFactoryItem> (default = null) | |
mediaElementCreationNotificationFunction:Function (default = null) |
getMediaFactoryItemAt | () | метод |
public function getMediaFactoryItemAt(index:int):MediaFactoryItem| Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Возвращает объект MediaFactoryItem в указанной позиции индекса.
Если индекс находится вне диапазона, создает RangeError.
Параметры
index:int — Отсчитываемая от нуля позиция индекса запрошенного MediaFactoryItem.
|
MediaFactoryItem — Объект MediaFactoryItem, представляющий мультимедийное содержимое для загрузки.
|
Связанные элементы API
initializePlugin | () | метод |
public function initializePlugin(resource:MediaResourceBase):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Метод инициализации, который вызывается инфраструктурой мультимедийного содержимого при инициализации этого внешнего модуля и предоставляет внешнему модулю ресурс, который использовался для запроса внешнего модуля. По умолчанию не выполняет действий, но внешние модули могут переопределить этот метод для указания собственной логики инициализации.
Следует учесть, что возможно создание экземпляра PluginInfo до того, как инфраструктура определит, что этот внешний модуль будет действительно использоваться, поэтому настоятельно рекомендуется включить логику инициализации в переопределение метода, чтобы избежать дублирования инициализации.
Этот метод вызывается перед getMediaFactoryItemAt или getnumMediaFactoryItems.
Параметры
resource:MediaResourceBase |
isFrameworkVersionSupported | () | метод |
public function isFrameworkVersionSupported(version:String):Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | OSMF 1.0 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Возвращает true, если внешний модуль поддерживает указанную версию инфраструктуры. В этом случае загружаемое приложение загружает внешний модуль. Возвращает false, если внешний модуль не поддерживает указанную версию инфраструктуры. В этом случае загружаемое приложение не загружает внешний модуль.
Параметры
version:String — Строка версии Open Source Media Framework.
|
Boolean — Возвращает true, если версия поддерживается.
|
PLUGIN_MEDIAFACTORY_NAMESPACE | Константа |
public static const PLUGIN_MEDIAFACTORY_NAMESPACE:String = "http://www.osmf.org/plugin/mediaFactory/1.0"URL-адрес пространства имен метаданных для MediaFactory, передаваемый из проигрывателя во внешний модуль.
Клиентский код может установить его в MediaResourceBase, который передается в MediaFactory.loadPlugin, и он будет доступен для внешнего модуля в MediaResourceBase, передаваемом в PluginInfo.initializePlugin.
Tue Jun 12 2018, 11:34 AM Z