Referencia de ActionScript® 3.0 para la plataforma de Adobe® Flash®
Inicio  |  Ocultar lista de paquetes y clases |  Paquetes  |  Clases  |  Novedades  |  Índice  |  Apéndices  |  ¿Por qué hay texto en inglés?
Filtros: Recuperando datos del servidor...
Recuperando datos del servidor...
org.osmf.media 

PluginInfo  - AS3 OSMF

Paqueteorg.osmf.media
Clasepublic class PluginInfo
HerenciaPluginInfo Inheritance Object

Versión del lenguaje: ActionScript 3.0
Versión de producto: OSMF 1.0
Versiones de motor de ejecución: Flash Player 10, AIR 1.5

PluginInfo is the encapsulation of the set of MediaFactoryItem objects that will be available to the application after the plugin has been successfully loaded. Every Open Source Media Framework plugin must define an instance or subclass of PluginInfo to provide the application with the information it needs to create and load the plugin's MediaElement.

From the point of view of the Open Source Media Framework, the plugin's purpose is to expose the MediaFactoryItem objects that represent the media that the plugin handles. These MediaFactoryItem objects could describe standard media types such as video, audio, or image that can be represented by the built-in Open Source Media Framework MediaElements: VideoElement, AudioElement, or ImageElement. More likely, a plugin provides some type of specialized processing, such as a custom loader or special-purpose media element with custom implementations of the traits. For example, a plugin that provides tracking might implement a TrackingCompositeElement that includes a customized loader and a customized PlayTrait implementation that start and stop tracking as well as the video.

A PluginInfo also gives the plugin an opportunity to accept or reject a specific Open Source Media Framework version through its isFrameworkVersionSupported() method.

A dynamic plugin is loaded at runtime from a SWF. A static plugin is compiled as part of the Open Source Media Framework application. An application attempting to load a dynamic plugin accesses the class that extends PluginInfo through the pluginInfo property on the root of the plugin SWF. If this class is not found, the plugin is not loaded. An application attempting to load a static plugin accesses the PluginInfo exposed by the PluginInfoResource object.

Elementos de API relacionados



Propiedades públicas
 PropiedadDefinido por
 Inheritedconstructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
Object
  frameworkVersion : String
[solo lectura] The version of the framework that this plugin was compiled against.
PluginInfo
  mediaElementCreationNotificationFunction : Function
[solo lectura] Optional function which is invoked for every MediaElement that is created from the MediaFactory to which this plugin's MediaFactoryItem objects are added.
PluginInfo
  numMediaFactoryItems : int
[solo lectura] The number of MediaFactoryItem objects that the plugin exposes to the loading application.
PluginInfo
Propiedades protegidas
 PropiedadDefinido por
  mediaFactoryItems : Vector.<MediaFactoryItem>
The MediaFactoryItem objects that this PluginInfo exposes.
PluginInfo
Métodos públicos
 MétodoDefinido por
  
PluginInfo(mediaFactoryItems:Vector.<MediaFactoryItem> = null, mediaElementCreationNotificationFunction:Function = null)
Constructor.
PluginInfo
  
Returns the MediaFactoryItem object at the specified index.
PluginInfo
 Inherited
Indica si un objeto tiene definida una propiedad especificada.
Object
  
Initialization method invoked by the media framework when this plugin is being initialized, and which provides the plugin the resource which was used to request the plugin.
PluginInfo
  
Returns true if the plugin supports the specified version of the framework, in which case the loading application loads the plugin.
PluginInfo
 Inherited
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.
Object
 Inherited
Indica si existe la propiedad especificada y si es enumerable.
Object
 Inherited
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
Object
 Inherited
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional.
Object
 Inherited
Devuelve la representación de cadena del objeto especificado.
Object
 Inherited
Devuelve el valor simple del objeto especificado.
Object
Constantes públicas
 ConstanteDefinido por
  PLUGIN_MEDIAFACTORY_NAMESPACE : String = "http://www.osmf.org/plugin/mediaFactory/1.0"
[estática] Metadata namespace URL for a MediaFactory that is passed from player to plugin.
PluginInfo
Información sobre propiedades

frameworkVersion

propiedad
frameworkVersion:String  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versión de producto: OSMF 1.0
Versiones de motor de ejecución: Flash Player 10, AIR 1.5

The version of the framework that this plugin was compiled against. The current version can be obtained from org.osmf.utils.Version.version.



Implementación
    public function get frameworkVersion():String

mediaElementCreationNotificationFunction

propiedad 
mediaElementCreationNotificationFunction:Function  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versión de producto: OSMF 1.0
Versiones de motor de ejecución: Flash Player 10, AIR 1.5

Optional function which is invoked for every MediaElement that is created from the MediaFactory to which this plugin's MediaFactoryItem objects are added. The function must take one param of type MediaElement, and return void. This callback function is useful for plugins who want to be notified when other MediaElement are created (e.g. so as to listen to or control them).



Implementación
    public function get mediaElementCreationNotificationFunction():Function

mediaFactoryItems

propiedad 
mediaFactoryItems:Vector.<MediaFactoryItem>

The MediaFactoryItem objects that this PluginInfo exposes.



Implementación
    protected function get mediaFactoryItems():Vector.<MediaFactoryItem>
    protected function set mediaFactoryItems(value:Vector.<MediaFactoryItem>):void

numMediaFactoryItems

propiedad 
numMediaFactoryItems:int  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versión de producto: OSMF 1.0
Versiones de motor de ejecución: Flash Player 10, AIR 1.5

The number of MediaFactoryItem objects that the plugin exposes to the loading application.



Implementación
    public function get numMediaFactoryItems():int
Información sobre constructores

PluginInfo

()Información sobre
public function PluginInfo(mediaFactoryItems:Vector.<MediaFactoryItem> = null, mediaElementCreationNotificationFunction:Function = null)

Versión del lenguaje: ActionScript 3.0
Versión de producto: OSMF 1.0
Versiones de motor de ejecución: Flash Player 10, AIR 1.5

Constructor.

Parámetros
mediaFactoryItems:Vector.<MediaFactoryItem> (default = null) — Vector of MediaFactoryItem objects that this plugin exposes.
 
mediaElementCreationNotificationFunction:Function (default = null) — Optional function which, if specified, is invoked for each MediaElement that is created from the MediaFactory to which this MediaFactoryItem is added. If specified, the function must take one param of type MediaElement, and return void. This callback function is useful for MediaFactoryItems which need to be notified when other MediaElements are created (e.g. so as to listen to or control them).
Información sobre métodos

getMediaFactoryItemAt

()método
public function getMediaFactoryItemAt(index:int):MediaFactoryItem

Versión del lenguaje: ActionScript 3.0
Versión de producto: OSMF 1.0
Versiones de motor de ejecución: Flash Player 10, AIR 1.5

Returns the MediaFactoryItem object at the specified index.

If the index is out of range, throws a RangeError.

Parámetros

index:int — Zero-based index position of the requested MediaFactoryItem.

Valor devuelto
MediaFactoryItem — A MediaFactoryItem object representing media to be loaded.

Elementos de API relacionados

initializePlugin

()método 
public function initializePlugin(resource:MediaResourceBase):void

Versión del lenguaje: ActionScript 3.0
Versión de producto: OSMF 1.0
Versiones de motor de ejecución: Flash Player 10, AIR 1.5

Initialization method invoked by the media framework when this plugin is being initialized, and which provides the plugin the resource which was used to request the plugin. By default does nothing, but plugins can override this method to specify their own initialization logic.

Note that an instance of PluginInfo may be instantiated before the framework has determined that that plugin is truly going to be used, so it is strongly recommended that any initialization logic be placed within an override of this method to avoid duplicate initialization.

This method is called before getMediaFactoryItemAt or get numMediaFactoryItems.

Parámetros

resource:MediaResourceBase

isFrameworkVersionSupported

()método 
public function isFrameworkVersionSupported(version:String):Boolean

Versión del lenguaje: ActionScript 3.0
Versión de producto: OSMF 1.0
Versiones de motor de ejecución: Flash Player 10, AIR 1.5

Returns true if the plugin supports the specified version of the framework, in which case the loading application loads the plugin. Returns false if the plugin does not support the specified version of the framework, in which case the loading application does not load the plugin.

Parámetros

version:String — Version string of the Open Source Media Framework version.

Valor devuelto
Boolean — Returns true if the version is supported.
Información sobre constantes

PLUGIN_MEDIAFACTORY_NAMESPACE

Constante
public static const PLUGIN_MEDIAFACTORY_NAMESPACE:String = "http://www.osmf.org/plugin/mediaFactory/1.0"

Metadata namespace URL for a MediaFactory that is passed from player to plugin.

Client code can set this on the MediaResourceBase that is passed to MediaFactory.loadPlugin, and it will be exposed to the plugin on the MediaResourceBase that is passed to PluginInfo.initializePlugin.





[ X ]¿Por qué hay texto en inglés?
Cierto contenido de la Referencia de ActionScript 3.0 se muestra en inglés

No todo el contenido de la Referencia de ActionScript 3.0 se traduce a todos los idiomas. Si un elemento del lenguaje no se traduce, aparecerá en inglés. Por ejemplo, la clase ga.controls.HelpBox no está traducida en ningún idioma. Por lo tanto, en la versión en español de la referencia, la clase ga.controls.HelpBox aparecerá en inglés.