| Package | org.osmf.media |
| Classe | public class MediaFactory |
| Héritage | MediaFactory  EventDispatcher Object |
| Sous-classes | DefaultMediaFactory |
| Version du langage: | ActionScript 3.0 |
| Version du produit: | OSMF 1.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
L’opération usine utilise un MediaResourceBase comme entrée et produit un MediaElement comme sortie.
Le MediaFactory gère une liste d’objets MediaFactoryItem dont chacun encapsule qui encapsule toutes les informations nécessaires pour créer un certain MediaElement. Le MediaFactory s’appuie sur la méthode canHandleResourceFunction de chaque MediaFactoryItem pour rechercher un objet MediaFactoryItem qui peut gérer le MediaResourceBase spécifié.
L’interface usine expose également des méthodes d’interrogation des objets MediaFactoryItem spécifiques et de chargement des modules externes (qui comprennent les objets MediaFactoryItem).
Eléments de l’API associés
Masquer les propriétés publiques héritées
Afficher les propriétés publiques héritées| Propriété | Défini par | ||
|---|---|---|---|
 | constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| numItems : int [lecture seule]
Le nombre de MediaFactoryItems gérés par l’usine. | MediaFactory | ||
| Méthode | Défini par | ||
|---|---|---|---|
Constructeur. | MediaFactory | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement. | EventDispatcher | |
Ajoute le MediaFactoryItem spécifié à l’usine. | MediaFactory | ||
Renvoie un MediaElement qui peut être créé en fonction du MediaResourceBase indiqué. | MediaFactory | ||
|
Distribue un événement dans le flux d’événements. | EventDispatcher | |
Obtient le MediaFactoryItem qui se trouve à l’index spécifié. | MediaFactory | ||
Renvoie le MediaFactoryItem avec l’ID spécifié ou null si le MediaFactoryItem spécifié n’existe pas dans cette usine. | MediaFactory | ||
|
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | |
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | |
Chargez un module externe identifié par la ressource spécifiée. | MediaFactory | ||
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | |
Supprime le MediaFactoryItem spécifié de l’usine. | MediaFactory | ||
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
|
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | |
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
|
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié. | EventDispatcher | |
| Méthode | Défini par | ||
|---|---|---|---|
Renvoie le MediaFactoryItem le mieux adapté à la ressource spécifiée parmi les MediaFactoryItems de la liste. | MediaFactory | ||
| Evénement | Synthèse | Défini par | ||
|---|---|---|---|---|
| [Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active. | EventDispatcher | ||
| [Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive. | EventDispatcher | ||
| Distribué lorsque le MediaFactory a créé un MediaElement. | MediaFactory | |||
| Distribué lorsque le MediaFactory a chargé un module externe avec succès. | MediaFactory | |||
| Distribué lorsque le MediaFactory n’a pas pu charger un module externe en raison d’une erreur. | MediaFactory | |||
numItems | propriété |
MediaFactory | () | Constructeur |
public function MediaFactory()| Version du langage: | ActionScript 3.0 |
| Version du produit: | OSMF 1.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Constructeur.
addItem | () | méthode |
public function addItem(item:MediaFactoryItem):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | OSMF 1.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Ajoute le MediaFactoryItem spécifié à l’usine. Une fois le MediaFactoryItem ajouté, pour n’importe quel MediaResourceBase que ce MediaFactoryItem peut gérer, l’usine peut créer l’élément multimédia correspondant. Si un MediaFactoryItem avec le même ID existe déjà dans cette usine, le nouvel objet MediaFactoryItem le remplace.
Paramètres
item:MediaFactoryItem — Le MediaFactoryItem à ajouter.
|
Valeur émise
ArgumentError — Si l’argument est null ou si l’argument a un champ ID null.
|
createMediaElement | () | méthode |
public function createMediaElement(resource:MediaResourceBase):MediaElement| Version du langage: | ActionScript 3.0 |
| Version du produit: | OSMF 1.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Renvoie un MediaElement qui peut être créé en fonction du MediaResourceBase indiqué.
Renvoie la valeur null si l’usine est incapable de trouver un objet MediaFactoryItem pouvant créer un tel MediaElement dans cette usine.
Paramètres
resource:MediaResourceBase — Le MediaResourceBase pour lequel un MediaElement correspondant doit être créé.
|
MediaElement — Le MediaElement qui a été créé ou null si aucun MediaElement n’a pu être créé à partir de la ressource.
|
getItemAt | () | méthode |
public function getItemAt(index:int):MediaFactoryItem| Version du langage: | ActionScript 3.0 |
| Version du produit: | OSMF 1.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Obtient le MediaFactoryItem qui se trouve à l’index spécifié.
Paramètres
index:int — Index de la liste à partir duquel extraire le MediaFactoryItem.
|
MediaFactoryItem — Le MediaFactoryItem qui se trouve à cet index ou null si aucun élément n’est retrouvé.
|
getItemById | () | méthode |
public function getItemById(id:String):MediaFactoryItem| Version du langage: | ActionScript 3.0 |
| Version du produit: | OSMF 1.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Renvoie le MediaFactoryItem avec l’ID spécifié ou null si le MediaFactoryItem spécifié n’existe pas dans cette usine.
Paramètres
id:String — ID du MediaFactoryItem à extraire.
|
MediaFactoryItem — Le MediaFactoryItem avec l’ID spécifié ou null si le MediaFactoryItem spécifié n’existe pas dans cette usine.
|
loadPlugin | () | méthode |
public function loadPlugin(resource:MediaResourceBase):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | OSMF 1.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Chargez un module externe identifié par la ressource spécifiée. Le MediaFactory ne rechargera pas le module externe s’il a déjà été chargé. Lors d’un chargement réussi, les MediaFactoryItems contenus dans la propriété PluginInfo du module externe seront ajoutés à ce MediaFactory et un événement MediaFactoryEvent.PLUGIN_LOAD sera distribué. Autrement, si le chargement échoue, un événement MediaFactoryEvent.PLUGIN_LOAD_ERROR sera distribué.
Paramètres
resource:MediaResourceBase — MediaResourceBase représentant le module externe. Pour les modules externes (dynamiques) à distance, utilisez un URLResource qui pointe vers le fichier SWF distant à charger. Pour des modules externes (statiques) en local, utilisez un PluginInfoResource.
|
Valeur émise
ArgumentError — Si la ressource est null ou si la ressource n’est ni un URLResource ni un PluginInfoResource.
|
removeItem | () | méthode |
public function removeItem(item:MediaFactoryItem):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | OSMF 1.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Supprime le MediaFactoryItem spécifié de l’usine. S’il un tel MediaFactoryItem n’existe pas dans cette usine, cela n’a aucun effet.
Paramètres
item:MediaFactoryItem — Le MediaFactoryItem à supprimer.
|
Valeur émise
ArgumentError — Si l’argument est null ou si l’argument a un champ ID null.
|
resolveItems | () | méthode |
protected function resolveItems(resource:MediaResourceBase, items:Vector.<MediaFactoryItem>):MediaFactoryItem
Renvoie le MediaFactoryItem le mieux adapté à la ressource spécifiée parmi les MediaFactoryItems de la liste. Cette méthode est appelée lorsque createMediaElement est appelé avec une ressource que plus d’un MediaFactoryItem peut gérer. Les sous-classes peuvent effectuer une annulation pour sélectionner la plus appropriée. Le comportement par défaut permet de sélectionner le premier élément qui n’est pas "natif" de la structure, d’après la théorie spécifiant que les modules externes doivent être prioritaires par rapport aux principaux types de support. Cette décision est basée sur la présence ou l’absence d’une valeur ID qui commence par org.osmf.
Paramètres
resource:MediaResourceBase | |
items:Vector.<MediaFactoryItem> |
MediaFactoryItem |
mediaElementCreate | Evénement |
org.osmf.events.MediaFactoryEventpropriété MediaFactoryEvent.type =
org.osmf.events.MediaFactoryEvent.MEDIA_ELEMENT_CREATE| Version du langage: | ActionScript 3.0 |
| Version du produit: | OSMF 1.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Distribué lorsque le MediaFactory a créé un MediaElement.
La constante MediaFactoryEvent.MEDIA_ELEMENT_CREATE définit la valeur de la propriété type de l’objet d’événement d’un événement mediaElementCreate.pluginLoad | Evénement |
org.osmf.events.MediaFactoryEventpropriété MediaFactoryEvent.type =
org.osmf.events.MediaFactoryEvent.PLUGIN_LOAD| Version du langage: | ActionScript 3.0 |
| Version du produit: | OSMF 1.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Distribué lorsque le MediaFactory a chargé un module externe avec succès.
La constante MediaFactoryEvent.PLUGIN_LOAD définit la valeur de la propriété type de l’objet d’événement d’un événement pluginLoad.pluginLoadError | Evénement |
org.osmf.events.MediaFactoryEventpropriété MediaFactoryEvent.type =
org.osmf.events.MediaFactoryEvent.PLUGIN_LOAD_ERROR| Version du langage: | ActionScript 3.0 |
| Version du produit: | OSMF 1.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Distribué lorsque le MediaFactory n’a pas pu charger un module externe en raison d’une erreur.
La constante MediaFactoryEvent.PLUGIN_LOAD_ERROR définit la valeur de la propriété type de l’objet d’événement d’un événement 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, 09:30 AM Z