ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
org.osmf.media 

MediaFactory  - AS3 OSMF

Paketorg.osmf.media
Klassepublic class MediaFactory
VererbungMediaFactory Inheritance EventDispatcher Inheritance 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



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : 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
 MethodeDefiniert von
  
Konstruktor.
MediaFactory
 Inherited
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
 Inherited
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
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
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
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
EventDispatcher
  
Entfernt das angegebene MediaFactoryItem aus der Factory.
MediaFactory
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
Ü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
 MethodeDefiniert von
  
Gibt aus der angegebenen Liste von MediaFactoryItems das für die angegebene Ressource passendste MediaFactoryItem zurück.
MediaFactory
Ereignisse
 Ereignis Übersicht Definiert von
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
 Inherited[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
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

MediaFactory

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




[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.