Pacchetto | fl.rsl |
Classe | public class RSLPreloader |
Ereditarietà | RSLPreloader EventDispatcher Object |
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS5 |
Versioni runtime: | Flash Player 10.1, AIR 2 |
RSLEvent.RSL_LOAD_COMPLETE
, RSLErrorEvent.RSL_LOAD_FAILED
o RSLEvent.RSL_PROGRESS
) per indicare lo stato di caricamento dei file RSL.
Elementi API correlati
Proprietà | Definito da | ||
---|---|---|---|
constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | ||
debugWaitTime : int
Impostate questo valore sul numero di millisecondi di attesa prima che venga scaricato il primo file RSL. | RSLPreloader | ||
numRSLInfos : int [sola lettura]
Il numero di istanze RSLInfo aggiunte tramite addRSLInfo(). | RSLPreloader |
Metodo | Definito da | ||
---|---|---|---|
RSLPreloader(mainTimeline:MovieClip = null)
Funzione di costruzione. | RSLPreloader | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un oggetto listener di eventi con un oggetto EventDispatcher, in modo che il listener riceva la notifica di un evento. | EventDispatcher | ||
Aggiunge un record RSLInfo descrittivo al file SWF o SWZ in corso di scaricamento. | RSLPreloader | ||
Invia un evento nel flusso di eventi. | EventDispatcher | ||
Ottiene il record RSLInfo aggiunto tramite addRSLInfo() nella posizione di indice specificata. | RSLPreloader | ||
Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento. | EventDispatcher | ||
Indica se per un oggetto è definita una proprietà specifica. | Object | ||
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | ||
Il metodo loadContent viene chiamato dal fotogramma 2 sul file wrapper SWF quando un nome di classe di contenuto viene fornito al metodo start(). | RSLPreloader | ||
Indica se la proprietà specificata esiste ed è enumerabile. | Object | ||
Rimuove un listener dall'oggetto EventDispatcher. | EventDispatcher | ||
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | ||
Avvia il download dei file RSL. | RSLPreloader | ||
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | ||
Restituisce la rappresentazione in formato stringa dell'oggetto specificato. | Object | ||
Restituisce il valore di base dell'oggetto specificato. | Object | ||
Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato. | EventDispatcher |
Evento | Riepilogo | Definito da | ||
---|---|---|---|---|
[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR ottiene lo stato di attivazione del sistema operativo ed entra nello stato attivo. | EventDispatcher | |||
[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR perde l'attivazione del sistema operativo e sta entrando nello stato inattivo. | EventDispatcher | |||
Inviato da RSLPreloader dopo che è stato completato il caricamento di tutte le RSL. | RSLPreloader | |||
Inviato da RSLPreloader al termine dello scaricamento di tutte le RSL, qualora una o più di esse non sia stata scaricata. | RSLPreloader | |||
Inviato da RSLPreloader per indicare l'avanzamento dello scaricamento dei file RSL. | RSLPreloader |
debugWaitTime | proprietà |
debugWaitTime:int
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS5 |
Versioni runtime: | Flash Player 10.1, AIR 2 |
Impostate questo valore sul numero di millisecondi di attesa prima che venga scaricato il primo file RSL. Questo è un modo per simulare l'attività dell'utente finale e verificare il ciclo di precaricamento. È particolarmente utile per i test delle RSL (file SWZ) con segno e memorizzate nella cache, per creare un ritardo di caricamento senza svuotare la cache SWZ. Prima della distribuzione, disattivate tutto il codice che imposta questo valore maggiore di 0. Utilizzate una costante di configurazione di debug (ad esempio CONFIG::DEBUG
) per chiamare il codice. Un altro suggerimento consiste nell'impostare il ritardo su un valore relativamente ELEVATO, ad esempio 5000 (che equivale a 5 secondi), come promemoria per rimuovere il codice di debug. Per le istanze RSLLoader generate automaticamente dall'ambiente di creazione, il ritardo può essere impostato mediante la definizione di un metodo setRSLPreloader(value:RSLPreloader):void
nel file SWF dell'animazione in fase di caricamento o nel codice della linea temporale principale.
import fl.rsl.RSLPreloader; function setRSLPreloader(preloader:RSLPreloader):void { preloader.debugWaitTime = 10000; }
Il valore predefinito è 0.
Implementazione
public function get debugWaitTime():int
public function set debugWaitTime(value:int):void
numRSLInfos | proprietà |
numRSLInfos:int
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS5 |
Versioni runtime: | Flash Player 10.1, AIR 2 |
Il numero di istanze RSLInfo aggiunte tramite addRSLInfo()
.
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]); } }
Implementazione
public function get numRSLInfos():int
Elementi API correlati
RSLPreloader | () | Funzione di costruzione |
public function RSLPreloader(mainTimeline:MovieClip = null)
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS5 |
Versioni runtime: | Flash Player 10.1, AIR 2 |
Funzione di costruzione. Quando l'ambiente di creazione genera automaticamente codice per precaricare i file SWZ, passa la classe Timeline principale come argomento. In genere, ciò non è utile per il codice scritto dall'utente finale.
ParametrimainTimeline:MovieClip (default = null )
|
addRSLInfo | () | metodo |
public function addRSLInfo(info:RSLInfo):void
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS5 |
Versioni runtime: | Flash Player 10.1, AIR 2 |
Aggiunge un record RSLInfo descrittivo al file SWF o SWZ in corso di scaricamento.
import fl.rsl.RSLInfo; var info:RSLInfo = new RSLInfo(); info.addEntry('rsl.swf'); myPreloader.addRSLInfo(info); myPreloader.start();
Parametri
info:RSLInfo |
getRSLInfoAt | () | metodo |
public function getRSLInfoAt(index:int):RSLInfo
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS5 |
Versioni runtime: | Flash Player 10.1, AIR 2 |
Ottiene il record RSLInfo aggiunto tramite addRSLInfo()
nella posizione di indice specificata. L'indice corrisponde all'ordine in cui i record sono stati aggiunti tramite addRSLInfo()
.
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]); } }
Parametri
index:int |
RSLInfo |
Elementi API correlati
loadContent | () | metodo |
public function loadContent():void
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS5 |
Versioni runtime: | Flash Player 10.1, AIR 2 |
Il metodo loadContent viene chiamato dal fotogramma 2 sul file wrapper SWF quando un nome di classe di contenuto viene fornito al metodo start(). Non viene in genere utilizzato per il codice scritto dall'utente finale.
Elementi API correlati
start | () | metodo |
public function start(preloaderAnimClass:Class = null, contentClassName:String = null):void
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS5 |
Versioni runtime: | Flash Player 10.1, AIR 2 |
Avvia il download dei file RSL. Questa funzione non dovrà essere chiamata finché tutti i record RSLInfo non saranno stati aggiunti tramite addRSLInfo()
. Quando l'ambiente di creazione genera codice automaticamente, possono essere utilizzati due argomenti opzionali. Il primo è una sottoclasse ByteArray per caricare un'animazione SWF del precaricatore. Il secondo è il nome di una sottoclasse ByteArray per il contenuto SWF. Questi argomenti non vengono in genere utilizzati nel codice scritto dall'utente finale.
Parametri
preloaderAnimClass:Class (default = null )
| |
contentClassName:String (default = null )
|
Elementi API correlati
rslLoadComplete | Evento |
fl.events.RSLEvent
proprietà RSLEvent.type =
fl.events.RSLEvent.RSL_LOAD_COMPLETE
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS5 |
Versioni runtime: | Flash Player 10.1, AIR 2 |
Inviato da RSLPreloader dopo che è stato completato il caricamento di tutte le RSL.
Evento inviato daRSLPreloader
dopo che è stato completato lo scaricamento di tutte le RSL. Le proprietà bytesLoaded
e bytesTotal
sono sempre 0 per questo tipo di evento. Quando il precaricamento avviene con un ciclo di eventi personalizzati, è NECESSARIO che il contenuto utente intercetti questo evento per determinare quando uscire dal ciclo di caricamento dell'animazione.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
bubbles | true |
cancelable | false ; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'istanza DisplayObject che viene aggiunta all'elenco di visualizzazione. Il target non è sempre l'oggetto nell'elenco di visualizzazione che ha registrato il listener di eventi. Utilizzate la proprietà currentTarget per accedere all'oggetto dell'elenco di visualizzazione che sta elaborando l'evento. |
rslsLoaded | Il numero di file che sono stati scaricati correttamente. |
rslsFailed | Il numero di file che non è stato possibile scaricare. |
rslsTotal | Il numero di file che scaricati correttamente o non scaricati. |
bytesLoaded | Il numero totale di byte scaricati contenuti nei file che sono stati scaricati correttamente. |
bytesTotal | Il numero totale di byte scaricati contenuti nei file che sono stati scaricati correttamente o meno. |
import fl.events.RSLEvent; myPreloader.addEventListener(RSLEvent.RSL_LOAD_COMPLETE, loadComplete); function loadComplete(e:RSLEvent) { gotoAndPlay('startOfContent'); }
rslLoadFailed | Evento |
fl.events.RSLErrorEvent
proprietà RSLErrorEvent.type =
fl.events.RSLErrorEvent.RSL_LOAD_FAILED
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS5 |
Versioni runtime: | Flash Player 10.1, AIR 2 |
Inviato da RSLPreloader al termine dello scaricamento di tutte le RSL, qualora una o più di esse non sia stata scaricata.
Errore inviato daRSLPreloader
al termine dello scaricamento di tutte le RSL, qualora una o più di esse non sia stata scaricata. Quando il precaricamento avviene con un ciclo di eventi personalizzati, è NECESSARIO che il contenuto utente intercetti questo evento per determinare quando uscire dal ciclo di caricamento dell'animazione.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
bubbles | true |
cancelable | false ; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'istanza DisplayObject che viene aggiunta all'elenco di visualizzazione. Il target non è sempre l'oggetto nell'elenco di visualizzazione che ha registrato il listener di eventi. Utilizzate la proprietà currentTarget per accedere all'oggetto dell'elenco di visualizzazione che sta elaborando l'evento. |
rslsLoaded | Il numero di file che sono stati scaricati correttamente. |
rslsFailed | Il numero di file che non è stato possibile scaricare. |
rslsTotal | Il numero di file che scaricati correttamente o non scaricati. |
failedURLs | Un array di file che non è stato possibile scaricare. |
import fl.events.RSLErrorEvent; myPreloader.addEventListener(RSLErrorEvent.RSL_LOAD_FAILED, rslLoadFailedHandler); function rslLoadFailedHandler(e:RSLErrorEvent) { gotoAndPlay('rslLoadFailure'); }
rslProgress | Evento |
fl.events.RSLEvent
proprietà RSLEvent.type =
fl.events.RSLEvent.RSL_PROGRESS
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flash CS5 |
Versioni runtime: | Flash Player 10.1, AIR 2 |
Inviato da RSLPreloader per indicare l'avanzamento dello scaricamento dei file RSL.
Evento inviato daRSLPreloader
per indicare l'avanzamento dello scaricamento dei file RSL. Questo è il solo tipo di evento per cui le proprietà bytesLoaded
e bytesTotal
hanno un valore diverso da zero.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
bubbles | true |
cancelable | false ; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'istanza DisplayObject che viene aggiunta all'elenco di visualizzazione. Il target non è sempre l'oggetto nell'elenco di visualizzazione che ha registrato il listener di eventi. Utilizzate la proprietà currentTarget per accedere all'oggetto dell'elenco di visualizzazione che sta elaborando l'evento. |
rslsLoaded | Il numero di file che sono stati scaricati correttamente. |
rslsFailed | Il numero di file che non è stato possibile scaricare. |
rslsTotal | Il numero di file che scaricati correttamente o non scaricati. |
bytesLoaded | Il numero totale di byte scaricati contenuti nei file che sono stati scaricati correttamente. |
bytesTotal | Il numero totale di byte scaricati contenuti nei file che sono stati scaricati correttamente o meno. |
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, 02:44 PM Z