| Paket | org.osmf.media |
| Klasse | public class MediaFactory |
| Vererbung | MediaFactory  EventDispatcher Object |
| Unterklassen | DefaultMediaFactory |
| Sprachversion: | ActionScript 3.0 |
| Produktversion: | OSMF 1.0 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Der Factoryvorgang nimmt eine MediaResourceBase als Eingabe und erstellt ein MediaElement als Ausgabe.
Die MediaFactory enthält eine Liste von MediaFactoryItem-Objekten, die jeweils alle für das Erstellen eines spezifischen MediaElement erforderlichen Informationen kapseln. Die MediaFactory sucht mithilfe der canHandleResourceFunction-Methode der einzelnen MediaFactoryItems jeweils ein MediaFactoryItem-Objekt, das die angegebene MediaResourceBase verarbeiten kann.
Die Factoryschnittstelle stellt auch Methoden zum Abfragen bestimmter MediaFactoryItem-Objekte bereit sowie zum Laden von Plugins (die MediaFactoryItem-Objekte enthalten).
Verwandte API-Elemente
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| Eigenschaft | Definiert von | ||
|---|---|---|---|
 | constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| numItems : int [schreibgeschützt]
Die Anzahl der von der Factory verwalteten MediaFactoryItems. | MediaFactory | ||
| Methode | Definiert von | ||
|---|---|---|---|
Konstruktor. | MediaFactory | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. | EventDispatcher | |
Fügt der Factory das angegebene MediaFactoryItem hinzu. | MediaFactory | ||
Gibt ein MediaElement zurück, das anhand der angegebenen MediaResourceBase erstellt werden kann. | MediaFactory | ||
|
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | |
Ruft das MediaFactoryItem an der festgelegten Indexposition ab. | MediaFactory | ||
Gibt das MediaFactoryItem mit der angegebenen ID oder null zurück, wenn das angegebene MediaFactoryItem in dieser Factory nicht existiert. | MediaFactory | ||
|
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | |
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
Lädt ein von der angegebenen Ressource identifiziertes Plugin. | MediaFactory | ||
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
|
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | |
Entfernt das angegebene MediaFactoryItem aus der Factory. | MediaFactory | ||
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
|
Gibt das angegebene Objekt als String zurück. | Object | |
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
|
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher | |
| Methode | Definiert von | ||
|---|---|---|---|
Gibt aus der angegebenen Liste von MediaFactoryItems das für die angegebene Ressource passendste MediaFactoryItem zurück. | MediaFactory | ||
| Ereignis | Übersicht | Definiert von | ||
|---|---|---|---|---|
| [broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird. | EventDispatcher | ||
| [broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird. | EventDispatcher | ||
| Wird ausgelöst, wenn die MediaFactory ein MediaElement erstellt hat. | MediaFactory | |||
| Wird ausgelöst, wenn die MediaFactory ein Plugin geladen hat. | MediaFactory | |||
| Wird ausgelöst, wenn die MediaFactory ein Plugin wegen eines Fehlers nicht geladen hat. | MediaFactory | |||
numItems | Eigenschaft |
MediaFactory | () | Konstruktor |
public function MediaFactory()| Sprachversion: | ActionScript 3.0 |
| Produktversion: | OSMF 1.0 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Konstruktor.
addItem | () | Methode |
public function addItem(item:MediaFactoryItem):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | OSMF 1.0 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Fügt der Factory das angegebene MediaFactoryItem hinzu. Nachdem das MediaFactoryItem hinzugefügt wurde, kann die Factory für jede MediaResourceBase, die von diesem MediaFactoryItem verarbeitet werden kann, das entsprechende Medienelement erstellen. Wenn in dieser Factory bereits ein MediaFactoryItem mit derselben ID existiert, wird es vom neuen MediaFactoryItem-Objekt ersetzt.
Parameter
item:MediaFactoryItem — Das hinzuzufügende MediaFactoryItem.
|
Auslöser
ArgumentError — Wenn das Argument null ist oder wenn das Argument ein ID-Feld null aufweist.
|
createMediaElement | () | Methode |
public function createMediaElement(resource:MediaResourceBase):MediaElement| Sprachversion: | ActionScript 3.0 |
| Produktversion: | OSMF 1.0 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt ein MediaElement zurück, das anhand der angegebenen MediaResourceBase erstellt werden kann.
Gibt null zurück, wenn die Factory kein MediaFactoryItem-Objekt findet, das ein derartiges MediaElement in dieser Factory erstellen kann.
Parameter
resource:MediaResourceBase — Die MediaResourceBase, für die ein entsprechendes MediaElement erstellt werden soll.
|
MediaElement — Das MediaElement, das erstellt wurde, oder null, wenn kein derartiges MediaElement aus der Ressource erstellt werden konnte.
|
getItemAt | () | Methode |
public function getItemAt(index:int):MediaFactoryItem| Sprachversion: | ActionScript 3.0 |
| Produktversion: | OSMF 1.0 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Ruft das MediaFactoryItem an der festgelegten Indexposition ab.
Parameter
index:int — Die Indexposition in der Liste, aus der das MediaFactoryItem abgerufen werden soll.
|
MediaFactoryItem — Das MediaFactoryItem an dieser Indexposition oder null, wenn keines vorhanden ist.
|
getItemById | () | Methode |
public function getItemById(id:String):MediaFactoryItem| Sprachversion: | ActionScript 3.0 |
| Produktversion: | OSMF 1.0 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt das MediaFactoryItem mit der angegebenen ID oder null zurück, wenn das angegebene MediaFactoryItem in dieser Factory nicht existiert.
Parameter
id:String — ID des abzurufenden MediaFactoryItem.
|
MediaFactoryItem — Das MediaFactoryItem mit der angegebenen ID oder null, wenn das angegebene MediaFactoryItem in dieser Factory nicht existiert.
|
loadPlugin | () | Methode |
public function loadPlugin(resource:MediaResourceBase):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | OSMF 1.0 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Lädt ein von der angegebenen Ressource identifiziertes Plugin. Die MediaFactory lädt das Plugin nicht erneut, wenn es bereits geladen wurde. Nach dem Laden werden die MediaFactoryItems aus der PluginInfo-Eigenschaft des Plugins zu dieser MediaFactory hinzugefügt und es wird ein MediaFactoryEvent.PLUGIN_LOAD-Ereignis ausgelöst. Andernfalls wird bei einem Ladefehler ein MediaFactoryEvent.PLUGIN_LOAD_ERROR-Ereignis ausgelöst.
Parameter
resource:MediaResourceBase — Die MediaResourceBase, die das Plugin darstellt. Für (dynamische) Remote-Plugins verwenden Sie eine URLResource, die auf die zu ladende SWF-Remotedatei verweist. Für lokale (statische) Plugins verwenden Sie eine PluginInfoResource.
|
Auslöser
ArgumentError — Wenn die Ressource null ist oder weder eine URLResource noch eine PluginInfoResource ist.
|
removeItem | () | Methode |
public function removeItem(item:MediaFactoryItem):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | OSMF 1.0 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Entfernt das angegebene MediaFactoryItem aus der Factory. Wenn in dieser Factory kein derartiges MediaFactoryItem existiert, hat dies keine Auswirkungen.
Parameter
item:MediaFactoryItem — Das zu entfernende MediaFactoryItem.
|
Auslöser
ArgumentError — Wenn das Argument null ist oder wenn das Argument ein ID-Feld null aufweist.
|
resolveItems | () | Methode |
protected function resolveItems(resource:MediaResourceBase, items:Vector.<MediaFactoryItem>):MediaFactoryItem
Gibt aus der angegebenen Liste von MediaFactoryItems das für die angegebene Ressource passendste MediaFactoryItem zurück. Diese Methode wird aufgerufen, wenn createMediaElement mit einer Ressource aufgerufen wird, die von mehr als einem MediaFactoryItem verarbeitet werden kann. Für die passendste Auswahl ist eine Überschreibung durch Unterklassen möglich. Standardmäßig wird das erste Objekt ausgewählt, das kein natives Objekt des Frameworks ist. Dies folgt der Voraussetzung, dass Plugins vor Medienkerntypen Vorrang haben. Diese Entscheidung basiert auf dem Vorhandensein oder Fehlen eines ID-Werts, der mit „org.osmf“ beginnt.
Parameter
resource:MediaResourceBase | |
items:Vector.<MediaFactoryItem> |
MediaFactoryItem |
mediaElementCreate | Ereignis |
org.osmf.events.MediaFactoryEventEigenschaft MediaFactoryEvent.type =
org.osmf.events.MediaFactoryEvent.MEDIA_ELEMENT_CREATE| Sprachversion: | ActionScript 3.0 |
| Produktversion: | OSMF 1.0 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Wird ausgelöst, wenn die MediaFactory ein MediaElement erstellt hat.
Die MediaFactoryEvent.MEDIA_ELEMENT_CREATE-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein mediaElementCreate-Ereignis.pluginLoad | Ereignis |
org.osmf.events.MediaFactoryEventEigenschaft MediaFactoryEvent.type =
org.osmf.events.MediaFactoryEvent.PLUGIN_LOAD| Sprachversion: | ActionScript 3.0 |
| Produktversion: | OSMF 1.0 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Wird ausgelöst, wenn die MediaFactory ein Plugin geladen hat.
Die MediaFactoryEvent.PLUGIN_LOAD-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein pluginLoad-Ereignis.pluginLoadError | Ereignis |
org.osmf.events.MediaFactoryEventEigenschaft MediaFactoryEvent.type =
org.osmf.events.MediaFactoryEvent.PLUGIN_LOAD_ERROR| Sprachversion: | ActionScript 3.0 |
| Produktversion: | OSMF 1.0 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Wird ausgelöst, wenn die MediaFactory ein Plugin wegen eines Fehlers nicht geladen hat.
Die MediaFactoryEvent.PLUGIN_LOAD_ERROR-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein pluginLoadError-Ereignis.
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, 10:04 AM Z