MediaFactory

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

MediaFactory stellt eine Factoryklasse für Medienelemente dar.

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).

Beispiele anzeigen

Verwandte API-Elemente

MediaFactoryItem
MediaResourceBase
MediaElement

Öffentliche Eigenschaften

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

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		MediaFactory() 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
		addItem(item:MediaFactoryItem):void Fügt der Factory das angegebene MediaFactoryItem hinzu.	MediaFactory
		createMediaElement(resource:MediaResourceBase):MediaElement Gibt ein MediaElement zurück, das anhand der angegebenen MediaResourceBase erstellt werden kann.	MediaFactory
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		getItemAt(index:int):MediaFactoryItem Ruft das MediaFactoryItem an der festgelegten Indexposition ab.	MediaFactory
		getItemById(id:String):MediaFactoryItem Gibt das MediaFactoryItem mit der angegebenen ID oder null zurück, wenn das angegebene MediaFactoryItem in dieser Factory nicht existiert.	MediaFactory
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	EventDispatcher
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		loadPlugin(resource:MediaResourceBase):void Lädt ein von der angegebenen Ressource identifiziertes Plugin.	MediaFactory
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	EventDispatcher
		removeItem(item:MediaFactoryItem):void Entfernt das angegebene MediaFactoryItem aus der Factory.	MediaFactory
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object
		willTrigger(type:String):Boolean Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.	EventDispatcher

Geschützte Methoden

	Methode		Definiert von
		resolveItems(resource:MediaResourceBase, items:Vector.<MediaFactoryItem>):MediaFactoryItem Gibt aus der angegebenen Liste von MediaFactoryItems das für die angegebene Ressource passendste MediaFactoryItem zurück.	MediaFactory

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

Vererbte Ereignisse ausblenden

Vererbte Ereignisse anzeigen

	Übersicht	Definiert von
activate	[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.	EventDispatcher
deactivate	[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.	EventDispatcher
mediaElementCreate	Wird ausgelöst, wenn die MediaFactory ein MediaElement erstellt hat.	MediaFactory
pluginLoad	Wird ausgelöst, wenn die MediaFactory ein Plugin geladen hat.	MediaFactory
pluginLoadError	Wird ausgelöst, wenn die MediaFactory ein Plugin wegen eines Fehlers nicht geladen hat.	MediaFactory

Eigenschaftendetails

numItems

Eigenschaft

numItems:int [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

OSMF 1.0

Laufzeitversionen:

Flash Player 10, AIR 1.5

Die Anzahl der von der Factory verwalteten MediaFactoryItems.

Implementierung
public function get numItems():int

Konstruktordetails

()

Konstruktor

public function MediaFactory()

Sprachversion:

ActionScript 3.0

Produktversion:

OSMF 1.0

Laufzeitversionen:

Flash Player 10, AIR 1.5

Konstruktor.

Methodendetails

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.

Rückgabewerte

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.

Rückgabewerte

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.

Rückgabewerte

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>`

Rückgabewerte

MediaFactoryItem

Ereignisdetails

mediaElementCreate

Ereignis

Ereignisobjekttyp: org.osmf.events.MediaFactoryEvent
Eigenschaft 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

Ereignisobjekttyp: org.osmf.events.MediaFactoryEvent
Eigenschaft 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

Ereignisobjekttyp: org.osmf.events.MediaFactoryEvent
Eigenschaft 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.

Beispiele Verwendung dieses Beispiels

MediaFactoryExample.as

Dieses Beispiel zeigt, wie MediaFactory für das Laden eines Plug-Ins verwendet werden kann. Beachten Sie, dass im Beispiel eine Modell-Plug-In-URL verwendet wird.

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.");    
        }    
    }
}

Rechtliche Hinweise | Onlinedatenschutzerklärung

MediaFactory - AS3 OSMF

Klassen x

numItems

MediaFactory

addItem

createMediaElement

getItemAt

getItemById

loadPlugin

removeItem

resolveItems

mediaElementCreate

pluginLoad

pluginLoadError