Paket | fl.rsl |
Klasse | public class RSLPreloader |
Vererbung | RSLPreloader EventDispatcher Object |
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS5 |
Laufzeitversionen: | Flash Player 10.1, AIR 2 |
RSLEvent.RSL_LOAD_COMPLETE
, RSLErrorEvent.RSL_LOAD_FAILED
oder RSLEvent.RSL_PROGRESS
), um den Status des RSL-Dateiladevorgangs anzugeben.
Verwandte API-Elemente
Eigenschaft | Definiert von | ||
---|---|---|---|
constructor : 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 |
Methode | Definiert von | ||
---|---|---|---|
RSLPreloader(mainTimeline:MovieClip = null)
Konstruktor. | RSLPreloader | ||
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 | ||
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | ||
Ruft den RSLInfo-Datensatz ab, der an der angegebenen Indexposition über addRSLInfo() hinzugefügt wurde. | RSLPreloader | ||
Ü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 | ||
Die loadContent-Methode wird von Bild 2 der Wrapper-SWF-Datei aufgerufen, wenn der start()-Methode ein Inhaltsklassenname übergeben wird. | RSLPreloader | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Beginnt mit dem Download der RSL-Dateien. | RSLPreloader | ||
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 |
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 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 |
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
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.
ParametermainTimeline:MovieClip (default = null )
|
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 |
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
rslLoadComplete | Ereignis |
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 vonRSLPreloader
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:
Eigenschaft | Wert |
---|---|
bubbles | true |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Die 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. |
rslsLoaded | Die Anzahl der Dateien, die erfolgreich heruntergeladen wurden. |
rslsFailed | Die Anzahl der Dateien, die nicht heruntergeladen werden konnten. |
rslsTotal | Die Gesamtzahl der Dateien, deren Download versucht wurde (erfolgreich oder nicht). |
bytesLoaded | Die Gesamtzahl der heruntergeladenen Bytes in erfolgreich heruntergeladenen Dateien. |
bytesTotal | Die 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 |
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 vonRSLPreloader
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:
Eigenschaft | Wert |
---|---|
bubbles | true |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Die 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. |
rslsLoaded | Die Anzahl der Dateien, die erfolgreich heruntergeladen wurden. |
rslsFailed | Die Anzahl der Dateien, die nicht heruntergeladen werden konnten. |
rslsTotal | Die Gesamtzahl der Dateien, deren Download versucht wurde (erfolgreich oder nicht). |
failedURLs | Ein 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 |
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 vonRSLPreloader
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:
Eigenschaft | Wert |
---|---|
bubbles | true |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Die 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. |
rslsLoaded | Die Anzahl der Dateien, die erfolgreich heruntergeladen wurden. |
rslsFailed | Die Anzahl der Dateien, die nicht heruntergeladen werden konnten. |
rslsTotal | Die Gesamtzahl der Dateien, deren Download versucht wurde (erfolgreich oder nicht). |
bytesLoaded | Die Gesamtzahl der heruntergeladenen Bytes in erfolgreich heruntergeladenen Dateien. |
bytesTotal | Die 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); }
Tue Jun 12 2018, 10:04 AM Z