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...
fl.rsl 

RSLPreloader  - AS3 Flash

Paketfl.rsl
Klassepublic class RSLPreloader
VererbungRSLPreloader Inheritance EventDispatcher Inheritance Object

Sprachversion: ActionScript 3.0
Produktversion: Flash CS5
Laufzeitversionen: Flash Player 10.1, AIR 2

Die RSLPreloader-Klasse verwaltet das Vorausladen von RSLs (Runtime Shared Libraries), bevor anderer Inhalt abgespielt wird. Sie verarbeitet sowohl SWF-Dateien (nicht signiert) als auch SWZ-Dateien (signiert und zwischengespeichert). RSLPreloader setzt Ereignisse ab (RSLEvent.RSL_LOAD_COMPLETE, RSLErrorEvent.RSL_LOAD_FAILED oder RSLEvent.RSL_PROGRESS), um den Status des RSL-Dateiladevorgangs anzugeben.

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  debugWaitTime : int
Stellen Sie diesen Wert auf die Zahl der Millisekunden ein, die vor dem Laden der ersten RSL-Datei gewartet wird.
RSLPreloader
  numRSLInfos : int
[schreibgeschützt] Die Anzahl der RSLInfo-Instanzen, die über addRSLInfo() hinzugefügt werden.
RSLPreloader
Öffentliche Methoden
 MethodeDefiniert von
  
RSLPreloader(mainTimeline:MovieClip = null)
Konstruktor.
RSLPreloader
 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 SWF- oder SWZ-Datei, die heruntergeladen wird, einen beschreibenden RSLInfo-Datensatz hinzu.
RSLPreloader
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
  
Ruft den RSLInfo-Datensatz ab, der an der angegebenen Indexposition über addRSLInfo() hinzugefügt wurde.
RSLPreloader
 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
  
Die loadContent-Methode wird von Bild 2 der Wrapper-SWF-Datei aufgerufen, wenn der start()-Methode ein Inhaltsklassenname übergeben wird.
RSLPreloader
 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
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
  
start(preloaderAnimClass:Class = null, contentClassName:String = null):void
Beginnt mit dem Download der RSL-Dateien.
RSLPreloader
 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
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 von RSLPreloader abgesetzt, wenn alle RSLs geladen wurden.RSLPreloader
  Wird von RSLPreloader abgesetzt, wenn der RSL-Download abgeschlossen ist und mindestens eine RSL nicht heruntergeladen werden konnte.RSLPreloader
  Wird von RSLPreloader abgesetzt, um den Fortschritt beim Herunterladen von RSL-Dateien anzuzeigen.RSLPreloader
Eigenschaftendetails

debugWaitTime

Eigenschaft
debugWaitTime:int

Sprachversion: ActionScript 3.0
Produktversion: Flash CS5
Laufzeitversionen: Flash Player 10.1, AIR 2

Stellen Sie diesen Wert auf die Zahl der Millisekunden ein, die vor dem Laden der ersten RSL-Datei gewartet wird. Dies ist eine Möglichkeit, die Endbenutzererfahrung zu simulieren und die Vorausladeschleife zu testen. Sie ist besonders hilfreich beim Testen von signierte, zwischengespeicherten RSLs (SWZ-Dateien), um eine Ladeverzögerung einzubauen, ohne den SWZ-Cache zu leeren. Deaktivieren Sie Code, der diesen Wert auf einen Wert größer als 0 setzt, vor der Bereitstellung. Rufen Sie den Code mit einer Debug-Konfigurationskonstante auf (zum Beispiel CONFIG::DEBUG). Eine andere Möglichkeit besteht darin, die Verzögerung auf einen relativ HOHEN Wert einzustellen, zum Beispiel 5000 (entspricht 5 Sekunden), als Erinnerung daran, den Debug-Code zu entfernen. Bei RSLLoader-Instanzen, die beim Authoring automatisch generiert werden, kann die Verzögerung durch die Definition einer setRSLPreloader(value:RSLPreloader):void-Methode in der ladenden SWF-Animationsdatei oder in der Hauptzeitleiste des Codes festgelegt werden.

         import fl.rsl.RSLPreloader;
         function setRSLPreloader(preloader:RSLPreloader):void {
         preloader.debugWaitTime = 10000;
         }
         

Der Standardwert ist 0.



Implementierung
    public function get debugWaitTime():int
    public function set debugWaitTime(value:int):void

numRSLInfos

Eigenschaft 
numRSLInfos:int  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Flash CS5
Laufzeitversionen: Flash Player 10.1, AIR 2

Die Anzahl der RSLInfo-Instanzen, die über addRSLInfo() hinzugefügt werden.

         for(var i:int = 0; i < myPreloader.numRSLInfos; i++) {
            trace('rsl ' + i);
            var urls:Array = myPreloader.getRSLInfoAt(i).rslURLs;
            for(var j:int = 0; j < urls.length; j++) {
               trace(' url: ' + urls[j]);
            }
         }
         



Implementierung
    public function get numRSLInfos():int

Verwandte API-Elemente

Konstruktordetails

RSLPreloader

()Konstruktor
public function RSLPreloader(mainTimeline:MovieClip = null)

Sprachversion: ActionScript 3.0
Produktversion: Flash CS5
Laufzeitversionen: Flash Player 10.1, AIR 2

Konstruktor. Gibt beim Authoring automatisch Code aus, um SWZ-Dateien vorauszuladen; wird in der Hauptzeitleistenklasse als Argument übergeben. Dies ist für vom Endanwender geschriebenen Code nicht immer sinnvoll.

Parameter
mainTimeline:MovieClip (default = null)
Methodendetails

addRSLInfo

()Methode
public function addRSLInfo(info:RSLInfo):void

Sprachversion: ActionScript 3.0
Produktversion: Flash CS5
Laufzeitversionen: Flash Player 10.1, AIR 2

Fügt der SWF- oder SWZ-Datei, die heruntergeladen wird, einen beschreibenden RSLInfo-Datensatz hinzu.

         import fl.rsl.RSLInfo;
         var info:RSLInfo = new RSLInfo();
         info.addEntry('rsl.swf');
         myPreloader.addRSLInfo(info);
         myPreloader.start();
         

Parameter

info:RSLInfo

getRSLInfoAt

()Methode 
public function getRSLInfoAt(index:int):RSLInfo

Sprachversion: ActionScript 3.0
Produktversion: Flash CS5
Laufzeitversionen: Flash Player 10.1, AIR 2

Ruft den RSLInfo-Datensatz ab, der an der angegebenen Indexposition über addRSLInfo() hinzugefügt wurde. Der Index entspricht der Reihenfolge, in der die Datensätze mit addRSLInfo() hinzugefügt wurden.

         for (var i:int = 0; i < myPreloader.numRSLInfos; i++) {
            trace('rsl ' + i);
            var urls:Array = myPreloader.getRSLInfoAt(i).rslURLs;
            for (var j:int = 0; j < urls.length; j++) {
               trace(' url: ' + urls[j]);
            }
         }
         

Parameter

index:int

Rückgabewerte
RSLInfo

Verwandte API-Elemente

loadContent

()Methode 
public function loadContent():void

Sprachversion: ActionScript 3.0
Produktversion: Flash CS5
Laufzeitversionen: Flash Player 10.1, AIR 2

Die loadContent-Methode wird von Bild 2 der Wrapper-SWF-Datei aufgerufen, wenn der start()-Methode ein Inhaltsklassenname übergeben wird. Sie wird im Allgemeinen nicht mit vom Endanwender geschriebenen Code verwendet.

Verwandte API-Elemente

start

()Methode 
public function start(preloaderAnimClass:Class = null, contentClassName:String = null):void

Sprachversion: ActionScript 3.0
Produktversion: Flash CS5
Laufzeitversionen: Flash Player 10.1, AIR 2

Beginnt mit dem Download der RSL-Dateien. Diese Funktion sollte nicht aufgerufen werden, bevor alle RSLInfo-Datensätze mit addRSLInfo() hinzugefügt wurden. Es können zwei optionale Argumente verwendet werden, wenn beim Authoring automatisch Code ausgegeben wird. Das erste ist eine ByteArray-Unterklasse zum Laden einer Preloader-SWF-Animation. Das zweite ist der Name einer ByteArray-Unterklasse für die SWF-Inhaltsdatei. Diese Argumente werden im Allgemeinen nicht im vom Endanwender geschriebenen Code verwendet.

Parameter

preloaderAnimClass:Class (default = null)
 
contentClassName:String (default = null)

Verwandte API-Elemente

Ereignisdetails

rslLoadComplete

Ereignis
Ereignisobjekttyp: fl.events.RSLEvent
Eigenschaft RSLEvent.type = fl.events.RSLEvent.RSL_LOAD_COMPLETE

Sprachversion: ActionScript 3.0
Produktversion: Flash CS5
Laufzeitversionen: Flash Player 10.1, AIR 2

Wird von RSLPreloader abgesetzt, wenn alle RSLs geladen wurden.

Ereignis, das von RSLPreloader ausgelöst wird, wenn alle RSLs erfolgreich heruntergeladen wurden. Die Eigenschaften bytesLoaded und bytesTotal sind für diesen Ereignistyp immer 0. Beim Vorausladen mit einer benutzerdefinierten Ereignisschleife MUSS Benutzerinhalt auf dieses Ereignis warten, um festzustellen, wann die Animationsschleife des Ladevorgangs beendet werden soll.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblestrue
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDie DisplayObject-Instanz, die in die Anzeigeliste aufgenommen wird. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
rslsLoadedDie Anzahl der Dateien, die erfolgreich heruntergeladen wurden.
rslsFailedDie Anzahl der Dateien, die nicht heruntergeladen werden konnten.
rslsTotalDie Gesamtzahl der Dateien, deren Download versucht wurde (erfolgreich oder nicht).
bytesLoadedDie Gesamtzahl der heruntergeladenen Bytes in erfolgreich heruntergeladenen Dateien.
bytesTotalDie Gesamtzahl der heruntergeladenen Bytes in Dateien, die erfolgreich oder nicht erfolgreich heruntergeladen wurden.
         import fl.events.RSLEvent;
         myPreloader.addEventListener(RSLEvent.RSL_LOAD_COMPLETE, loadComplete);
         function loadComplete(e:RSLEvent) {
         gotoAndPlay('startOfContent');
         }
         

rslLoadFailed

Ereignis  
Ereignisobjekttyp: fl.events.RSLErrorEvent
Eigenschaft RSLErrorEvent.type = fl.events.RSLErrorEvent.RSL_LOAD_FAILED

Sprachversion: ActionScript 3.0
Produktversion: Flash CS5
Laufzeitversionen: Flash Player 10.1, AIR 2

Wird von RSLPreloader abgesetzt, wenn der RSL-Download abgeschlossen ist und mindestens eine RSL nicht heruntergeladen werden konnte.

Fehler, der von RSLPreloader ausgelöst wird, wenn der RSL-Download abgeschlossen ist und mindestens eines nicht heruntergeladen werden konnte. Beim Vorausladen mit einer benutzerdefinierten Ereignisschleife MUSS Benutzerinhalt auf dieses Ereignis warten, um festzustellen, wann die Animationsschleife des Ladevorgangs beendet werden soll.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblestrue
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDie DisplayObject-Instanz, die in die Anzeigeliste aufgenommen wird. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
rslsLoadedDie Anzahl der Dateien, die erfolgreich heruntergeladen wurden.
rslsFailedDie Anzahl der Dateien, die nicht heruntergeladen werden konnten.
rslsTotalDie Gesamtzahl der Dateien, deren Download versucht wurde (erfolgreich oder nicht).
failedURLsEin Array von Dateien, die nicht heruntergeladen werden konnten.
         import fl.events.RSLErrorEvent;
         myPreloader.addEventListener(RSLErrorEvent.RSL_LOAD_FAILED, rslLoadFailedHandler);
         function rslLoadFailedHandler(e:RSLErrorEvent) {
         gotoAndPlay('rslLoadFailure');
         }
         

rslProgress

Ereignis  
Ereignisobjekttyp: fl.events.RSLEvent
Eigenschaft RSLEvent.type = fl.events.RSLEvent.RSL_PROGRESS

Sprachversion: ActionScript 3.0
Produktversion: Flash CS5
Laufzeitversionen: Flash Player 10.1, AIR 2

Wird von RSLPreloader abgesetzt, um den Fortschritt beim Herunterladen von RSL-Dateien anzuzeigen.

Ereignis, das von RSLPreloader ausgelöst wird, um den Fortschritt beim Herunterladen von RSL-Dateien anzuzeigen. Dies ist der einzige Ereignistyp, bei dem die Eigenschaften bytesLoaded und bytesTotal nicht null sind.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblestrue
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDie DisplayObject-Instanz, die in die Anzeigeliste aufgenommen wird. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.
rslsLoadedDie Anzahl der Dateien, die erfolgreich heruntergeladen wurden.
rslsFailedDie Anzahl der Dateien, die nicht heruntergeladen werden konnten.
rslsTotalDie Gesamtzahl der Dateien, deren Download versucht wurde (erfolgreich oder nicht).
bytesLoadedDie Gesamtzahl der heruntergeladenen Bytes in erfolgreich heruntergeladenen Dateien.
bytesTotalDie Gesamtzahl der heruntergeladenen Bytes in Dateien, die erfolgreich oder nicht erfolgreich heruntergeladen wurden.
         import fl.events.RSLEvent;
         myPreloader.addEventListener(RSLEvent.RSL_PROGRESS, progressHandler);
         function progressHandler(e:RSLEvent) {
         trace('rslsLoaded = ' + e.rslsLoaded);
         trace('rslsFailed = ' + e.rslsFailed);
         trace('rslsTotal = ' + e.rslsTotal);
         trace('bytesLoaded = ' + e.bytesLoaded);
         trace('bytesTotal = ' + e.bytesTotal);
         }
         




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