Pakket | fl.rsl |
Klasse | public class RSLPreloader |
Overerving | RSLPreloader EventDispatcher Object |
Taalversie: | ActionScript 3.0 |
Productversie: | Flash CS5 |
Runtimeversies: | Flash Player 10.1, AIR 2 |
RSLEvent.RSL_LOAD_COMPLETE
, RSLErrorEvent.RSL_LOAD_FAILED
of RSLEvent.RSL_PROGRESS
) om de status van het RSL-bestand dat geladen wordt, aan te geven.
Verwante API-elementen
Eigenschap | Gedefinieerd door | ||
---|---|---|---|
constructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie. | Object | ||
debugWaitTime : int
Stel deze waarde in op het aantal milliseconden waarmee wordt gewacht voor het downloaden van het eerste RSL-bestand. | RSLPreloader | ||
numRSLInfos : int [alleen-lezen]
Het aantal RSLInfo-instanties die via addRSLInfo() zijn toegevoegd. | RSLPreloader |
Methode | Gedefinieerd door | ||
---|---|---|---|
RSLPreloader(mainTimeline:MovieClip = null)
Constructor. | RSLPreloader | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt. | EventDispatcher | ||
Voegt een beschrijvend RSLInfo-record toe aan het SWF- of SWZ-bestand dat wordt gedownload. | RSLPreloader | ||
Verzendt een gebeurtenis naar de gebeurtenisstroom. | EventDispatcher | ||
Haalt het RSLInfo-record op dat via addRSLInfo() aan de opgegeven index is toegevoegd. | RSLPreloader | ||
Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis. | EventDispatcher | ||
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | ||
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | ||
De loadContent-methode wordt opgeroepen vanaf frame 2 van het omvattende SWF-bestand wanneer er aan de start()-methode een contentklassenaam wordt doorgegeven. | RSLPreloader | ||
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | ||
Verwijdert een listener uit het object EventDispatcher. | EventDispatcher | ||
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in. | Object | ||
Hiermee wordt het downloaden van de RSL-bestanden gestart. | RSLPreloader | ||
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies. | Object | ||
Retourneert een tekenreeksrepresentatie van het opgegeven object. | Object | ||
Retourneert de primitieve waarde van het opgegeven object. | Object | ||
Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis. | EventDispatcher |
Gebeurtenis | Overzicht | Gedefinieerd door | ||
---|---|---|---|---|
[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de besturingssysteemfocus krijgt en actief wordt. | EventDispatcher | |||
[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de systeemfocus verliest en inactief wordt. | EventDispatcher | |||
Wordt verzonden door RSLPreloader wanneer alle RSL's het laden hebben voltooid. | RSLPreloader | |||
Wordt verzonden door RSLPreloader wanneer alle RSL's het downloaden hebben voltooid en een of meer downloads zijn mislukt. | RSLPreloader | |||
Wordt verzonden door RSLPreloader om de voortgang tijdens het downloaden van RSL-bestanden aan te geven. | RSLPreloader |
debugWaitTime | eigenschap |
debugWaitTime:int
Taalversie: | ActionScript 3.0 |
Productversie: | Flash CS5 |
Runtimeversies: | Flash Player 10.1, AIR 2 |
Stel deze waarde in op het aantal milliseconden waarmee wordt gewacht voor het downloaden van het eerste RSL-bestand. Dit is één manier om de ervaring voor de eindgebruiker te simuleren en de voorladerloop te testen. Het is vooral nuttig voor het testen van getekende RSL's die in cache geplaatst zijn (SWZ-bestanden), voor het bouwen in vertraging bij het laden zonder het leegmaken van de SWZ-cache. Schakel een code uit die deze waarde voor het implementeren op hoger dan 0 instelt. Gebruik een config-constante voor foutopsporing (zoals CONFIG::DEBUG
) om de code op te roepen. Een andere suggestie is om de vertraging in te stellen op een relatief HOGE waarde, zoals 5000 (equivalent aan 5 seconden) als een herinnering dat de foutopsporingscode moet worden verwijderd. Voor RSLLoader-instanties die automatisch tijdens het ontwerpen worden gegenereerd, kan de vertraging worden ingesteld door een setRSLPreloader(value:RSLPreloader):void
-methode te definiëren in de SWF die animatie laadt of in de code van de hoofdtijdlijn.
import fl.rsl.RSLPreloader; function setRSLPreloader(preloader:RSLPreloader):void { preloader.debugWaitTime = 10000; }
De standaardwaarde is 0.
Implementatie
public function get debugWaitTime():int
public function set debugWaitTime(value:int):void
numRSLInfos | eigenschap |
numRSLInfos:int
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Productversie: | Flash CS5 |
Runtimeversies: | Flash Player 10.1, AIR 2 |
Het aantal RSLInfo-instanties die via addRSLInfo()
zijn toegevoegd.
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]); } }
Implementatie
public function get numRSLInfos():int
Verwante API-elementen
RSLPreloader | () | Constructor |
public function RSLPreloader(mainTimeline:MovieClip = null)
Taalversie: | ActionScript 3.0 |
Productversie: | Flash CS5 |
Runtimeversies: | Flash Player 10.1, AIR 2 |
Constructor. Wanneer het ontwerpen code automatisch naar voorgeladen SWZ-bestanden wordt verstuurd, wordt dit als argument aan de hoofdtijdlijnklasse doorgegeven. Dit is over het algemeen niet nuttig voor code die voor eindgebruikers geschreven is.
ParametersmainTimeline:MovieClip (default = null )
|
addRSLInfo | () | methode |
public function addRSLInfo(info:RSLInfo):void
Taalversie: | ActionScript 3.0 |
Productversie: | Flash CS5 |
Runtimeversies: | Flash Player 10.1, AIR 2 |
Voegt een beschrijvend RSLInfo-record toe aan het SWF- of SWZ-bestand dat wordt gedownload.
import fl.rsl.RSLInfo; var info:RSLInfo = new RSLInfo(); info.addEntry('rsl.swf'); myPreloader.addRSLInfo(info); myPreloader.start();
Parameters
info:RSLInfo |
getRSLInfoAt | () | methode |
public function getRSLInfoAt(index:int):RSLInfo
Taalversie: | ActionScript 3.0 |
Productversie: | Flash CS5 |
Runtimeversies: | Flash Player 10.1, AIR 2 |
Haalt het RSLInfo-record op dat via addRSLInfo()
aan de opgegeven index is toegevoegd. De index stemt overeen met de volgorde waarin de records via addRSLInfo
zijn toegevoegd.
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]); } }
Parameters
index:int |
RSLInfo |
Verwante API-elementen
loadContent | () | methode |
public function loadContent():void
Taalversie: | ActionScript 3.0 |
Productversie: | Flash CS5 |
Runtimeversies: | Flash Player 10.1, AIR 2 |
De loadContent-methode wordt opgeroepen vanaf frame 2 van het omvattende SWF-bestand wanneer er aan de start()-methode een contentklassenaam wordt doorgegeven. Het wordt over het algemeen niet gebruikt met code die geschreven is voor eindgebruikers.
Verwante API-elementen
start | () | methode |
public function start(preloaderAnimClass:Class = null, contentClassName:String = null):void
Taalversie: | ActionScript 3.0 |
Productversie: | Flash CS5 |
Runtimeversies: | Flash Player 10.1, AIR 2 |
Hiermee wordt het downloaden van de RSL-bestanden gestart. Deze functie moet niet opgeroepen worden, tot alle RSLInfo-records via addRSLInfo()
zijn toegevoegd. Er kunnen tijdens het automatisch ontwerpen van code twee optionele argumenten worden gebruikt. De eerste is de ByteArray-subklasse voor het laden van een voorgeladen SWF-animatie. De tweede is de naam van een ByteArray-subklasse voor de content-SWF. Deze argumenten worden over het algemeen niet gebruikt in code die is geschreven voor eindgebruikers.
Parameters
preloaderAnimClass:Class (default = null )
| |
contentClassName:String (default = null )
|
Verwante API-elementen
rslLoadComplete | Gebeurtenis |
fl.events.RSLEvent
eigenschap RSLEvent.type =
fl.events.RSLEvent.RSL_LOAD_COMPLETE
Taalversie: | ActionScript 3.0 |
Productversie: | Flash CS5 |
Runtimeversies: | Flash Player 10.1, AIR 2 |
Wordt verzonden door RSLPreloader wanneer alle RSL's het laden hebben voltooid.
De gebeurtenis die wordt verzonden doorRSLPreloader
wanneer alle RSL's het downloaden hebben voltooid. De eigenschappen bytesLoaded
en bytesTotal
zijn voor dit gebeurtenistype altijd 0. Wanneer u vooraf laadt met een aangepaste gebeurtenisloop, MOET gebruikerscontent naar deze gebeurtenis luisteren om te bepalen wanneer de animatieloop die geladen wordt, wordt afgesloten.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | true |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
target | De instantie DisplayObject die wordt toegevoegd aan het weergaveoverzicht. Het target is niet altijd het object in het weergaveoverzicht dat in de gebeurtenislistener is geregistreerd. Gebruik de eigenschap currentTarget voor toegang tot het object in het weergaveoverzicht dat momenteel de gebeurtenis verwerkt. |
rslsLoaded | Het aantal bestanden waarvan het downloaden is gelukt. |
rslsFailed | het aantal bestanden waarvan het downloaden is mislukt. |
rslsTotal | het totaalaantal bestanden dat is gedownload, of het downloaden nu is gelukt of niet. |
bytesLoaded | Het totaalaantal gedownloade bytes in bestanden waarvan het downloaden is gelukt. |
bytesTotal | het totaalaantal gedownloade bytes in bestanden waarvan het downloaden wel en waarvan het downloaden niet is gelukt. |
import fl.events.RSLEvent; myPreloader.addEventListener(RSLEvent.RSL_LOAD_COMPLETE, loadComplete); function loadComplete(e:RSLEvent) { gotoAndPlay('startOfContent'); }
rslLoadFailed | Gebeurtenis |
fl.events.RSLErrorEvent
eigenschap RSLErrorEvent.type =
fl.events.RSLErrorEvent.RSL_LOAD_FAILED
Taalversie: | ActionScript 3.0 |
Productversie: | Flash CS5 |
Runtimeversies: | Flash Player 10.1, AIR 2 |
Wordt verzonden door RSLPreloader wanneer alle RSL's het downloaden hebben voltooid en een of meer downloads zijn mislukt.
De fout die wordt verzonden doorRSLPreloader
wanneer alle RSL's het downloaden hebben voltooid en een of meer downloads zijn mislukt. Wanneer u vooraf laadt met een aangepaste gebeurtenisloop, MOET gebruikerscontent naar deze gebeurtenis luisteren om te bepalen wanneer de animatieloop die geladen wordt, wordt afgesloten.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | true |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
target | De instantie DisplayObject die wordt toegevoegd aan het weergaveoverzicht. Het target is niet altijd het object in het weergaveoverzicht dat in de gebeurtenislistener is geregistreerd. Gebruik de eigenschap currentTarget voor toegang tot het object in het weergaveoverzicht dat momenteel de gebeurtenis verwerkt. |
rslsLoaded | Het aantal bestanden waarvan het downloaden is gelukt. |
rslsFailed | het aantal bestanden waarvan het downloaden is mislukt. |
rslsTotal | het totaalaantal bestanden dat is gedownload, of het downloaden nu is gelukt of niet. |
failedURLs | Een array van bestanden waarvan het downloaden is mislukt. |
import fl.events.RSLErrorEvent; myPreloader.addEventListener(RSLErrorEvent.RSL_LOAD_FAILED, rslLoadFailedHandler); function rslLoadFailedHandler(e:RSLErrorEvent) { gotoAndPlay('rslLoadFailure'); }
rslProgress | Gebeurtenis |
fl.events.RSLEvent
eigenschap RSLEvent.type =
fl.events.RSLEvent.RSL_PROGRESS
Taalversie: | ActionScript 3.0 |
Productversie: | Flash CS5 |
Runtimeversies: | Flash Player 10.1, AIR 2 |
Wordt verzonden door RSLPreloader om de voortgang tijdens het downloaden van RSL-bestanden aan te geven.
De gebeurtenis die wordt verzonden doorRSLPreloader
om de voortgang tijdens het downloaden van RSL-bestanden aan te geven. Dit is het enige gebeurtenistype waarvoor de eigenschappen bytesLoaded
en bytesTotal
niet nul zijn.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | true |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
target | De instantie DisplayObject die wordt toegevoegd aan het weergaveoverzicht. Het target is niet altijd het object in het weergaveoverzicht dat in de gebeurtenislistener is geregistreerd. Gebruik de eigenschap currentTarget voor toegang tot het object in het weergaveoverzicht dat momenteel de gebeurtenis verwerkt. |
rslsLoaded | Het aantal bestanden waarvan het downloaden is gelukt. |
rslsFailed | het aantal bestanden waarvan het downloaden is mislukt. |
rslsTotal | het totaalaantal bestanden dat is gedownload, of het downloaden nu is gelukt of niet. |
bytesLoaded | Het totaalaantal gedownloade bytes in bestanden waarvan het downloaden is gelukt. |
bytesTotal | het totaalaantal gedownloade bytes in bestanden waarvan het downloaden wel en waarvan het downloaden niet is gelukt. |
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); }
Wed Jun 13 2018, 11:42 AM Z