Paquete | fl.rsl |
Clase | public class RSLPreloader |
Herencia | RSLPreloader EventDispatcher Object |
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flash CS5 |
Versiones de motor de ejecución: | Flash Player 10.1, AIR 2 |
RSLEvent.RSL_LOAD_COMPLETE
, RSLErrorEvent.RSL_LOAD_FAILED
o RSLEvent.RSL_PROGRESS
) para indicar el estado de la carga del archivo RSL.
Elementos de API relacionados
Propiedad | Definido por | ||
---|---|---|---|
constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | ||
debugWaitTime : int
Establezca este valor en el número de milisegundos que se debe esperar antes de descargar el primer archivo RSL. | RSLPreloader | ||
numRSLInfos : int [solo lectura]
El número de instancias de RSLInfo añadidas mediante addRSLInfo(). | RSLPreloader |
Método | Definido por | ||
---|---|---|---|
RSLPreloader(mainTimeline:MovieClip = null)
Constructor. | RSLPreloader | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un objeto de detector de eventos con un objeto EventDispatcher, de modo que el detector reciba la notificación de un evento. | EventDispatcher | ||
Añade un registro descriptivo de RSLInfo en el archivo SWF o archivo SWZ que se está descargando. | RSLPreloader | ||
Distribuye un evento en el flujo del evento. | EventDispatcher | ||
Obtiene el registro RSLInfo añadido a través addRSLInfo() en el índice especificado. | RSLPreloader | ||
Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento. | EventDispatcher | ||
Indica si un objeto tiene definida una propiedad especificada. | Object | ||
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro. | Object | ||
El método loadContent se llama desde el fotograma 2 del SWF envolvente cuando se suministra el nombre de la clase de contenido al método start(). | RSLPreloader | ||
Indica si existe la propiedad especificada y si es enumerable. | Object | ||
Elimina un detector del objeto EventDispatcher. | EventDispatcher | ||
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | ||
Inicia la descarga de los archivos RSL. | RSLPreloader | ||
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional. | Object | ||
Devuelve la representación de cadena del objeto especificado. | Object | ||
Devuelve el valor simple del objeto especificado. | Object | ||
Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto. | EventDispatcher |
Evento | Resumen | Definido por | ||
---|---|---|---|---|
[evento broadcast] Se distribuye cuando Flash Player o AIR pasan a estar activos. | EventDispatcher | |||
[evento broadcast] Se distribuye cuando Flash Player o de AIR pasan a estar inactivos. | EventDispatcher | |||
Distribuido por RSLPreloader cuando todas las bibliotecas RSL han terminado de cargarse. | RSLPreloader | |||
Distribuido por RSLPreloader cuando ha terminado la descarga de todas las RSL y una o varias han fallado. | RSLPreloader | |||
Distribuido por RSLPreloader para indicar el progreso de descarga de archivos RSL. | RSLPreloader |
debugWaitTime | propiedad |
debugWaitTime:int
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flash CS5 |
Versiones de motor de ejecución: | Flash Player 10.1, AIR 2 |
Establezca este valor en el número de milisegundos que se debe esperar antes de descargar el primer archivo RSL. Se trata de una forma de simular la experiencia del usuario final y de probar el bucle de precarga. Resulta especialmente útil en los RLS almacenados en caché, firmados y probados (archivos SWZ), para crear una demora de carga sin vaciar la caché del archivo SWZ. Desactive cualquier código que establezca este valor en mayor que 0 antes de continuar. Utilice una constante de configuración de depuración (por ejemplo, CONFIG::DEBUG
) para llamar al código. Otra sugerencia es definir la demora en un valor relativamente grande, por ejemplo 5.000 (equivalente a 5 segundos), como recordatorio para eliminar el código de depuración. En las instancias de RSLLoader generadas automáticamente mediante el entorno de edición, la demora se puede establecer definiendo un método setRSLPreloader(value:RSLPreloader):void
en el SWF de la animación de carga o en el código de la línea de tiempo principal.
import fl.rsl.RSLPreloader; function setRSLPreloader(preloader:RSLPreloader):void { preloader.debugWaitTime = 10000; }
El valor predeterminado es 0.
Implementación
public function get debugWaitTime():int
public function set debugWaitTime(value:int):void
numRSLInfos | propiedad |
numRSLInfos:int
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flash CS5 |
Versiones de motor de ejecución: | Flash Player 10.1, AIR 2 |
El número de instancias de RSLInfo añadidas mediante 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]); } }
Implementación
public function get numRSLInfos():int
Elementos de API relacionados
RSLPreloader | () | Información sobre |
public function RSLPreloader(mainTimeline:MovieClip = null)
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flash CS5 |
Versiones de motor de ejecución: | Flash Player 10.1, AIR 2 |
Constructor. Cuando la edición produce código automáticamente para precargar archivos SWZ, se transfiere en la línea de tiempo principal como un argumento. Esto no es generalmente útil para el código escrito por el usuario final.
ParámetrosmainTimeline:MovieClip (default = null )
|
addRSLInfo | () | método |
public function addRSLInfo(info:RSLInfo):void
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flash CS5 |
Versiones de motor de ejecución: | Flash Player 10.1, AIR 2 |
Añade un registro descriptivo de RSLInfo en el archivo SWF o archivo SWZ que se está descargando.
import fl.rsl.RSLInfo; var info:RSLInfo = new RSLInfo(); info.addEntry('rsl.swf'); myPreloader.addRSLInfo(info); myPreloader.start();
Parámetros
info:RSLInfo |
getRSLInfoAt | () | método |
public function getRSLInfoAt(index:int):RSLInfo
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flash CS5 |
Versiones de motor de ejecución: | Flash Player 10.1, AIR 2 |
Obtiene el registro RSLInfo añadido a través addRSLInfo()
en el índice especificado. El índice corresponde al orden en el que se han añadido los registros mediante 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]); } }
Parámetros
index:int |
RSLInfo |
Elementos de API relacionados
loadContent | () | método |
public function loadContent():void
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flash CS5 |
Versiones de motor de ejecución: | Flash Player 10.1, AIR 2 |
El método loadContent se llama desde el fotograma 2 del SWF envolvente cuando se suministra el nombre de la clase de contenido al método start(). No se utiliza generalmente con código escrito por el usuario final.
Elementos de API relacionados
start | () | método |
public function start(preloaderAnimClass:Class = null, contentClassName:String = null):void
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flash CS5 |
Versiones de motor de ejecución: | Flash Player 10.1, AIR 2 |
Inicia la descarga de los archivos RSL. No debe llamarse a esta función hasta que todos los registros de RSLInfo se hayan añadido a través addRSLInfo()
. Se pueden utilizar dos argumentos opcionales cuando el entorno de edición genera código automáticamente. El primero es una subclase de ByteArray para cargar una animación SWF de precarga. El segundo es el nombre de una subclase de ByteArray para el contenido SWF. Estos argumentos generalmente no se utilizan en el código escrito del usuario final.
Parámetros
preloaderAnimClass:Class (default = null )
| |
contentClassName:String (default = null )
|
Elementos de API relacionados
rslLoadComplete | Evento |
fl.events.RSLEvent
propiedad RSLEvent.type =
fl.events.RSLEvent.RSL_LOAD_COMPLETE
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flash CS5 |
Versiones de motor de ejecución: | Flash Player 10.1, AIR 2 |
Distribuido por RSLPreloader cuando todas las bibliotecas RSL han terminado de cargarse.
Evento distribuido porRSLPreloader
cuando todas las bibliotecas RSL han terminado de descargarse. Las propiedades bytesLoaded
y bytesTotal
siempre son 0 para este tipo de evento. Cuando se precarga con un bucle de evento personalizado, el contenido del usuario DEBE detectar este evento para determinar cuándo salir del bucle de animación de carga.
Este evento tiene las propiedades siguientes:
Propiedad | Valor |
---|---|
bubbles | true |
cancelable | false ; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | La instancia de DisplayObject que se va a añadir a la lista de visualización. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente. |
rslsLoaded | El número de archivos que se han descargado correctamente. |
rslsFailed | El número de archivos que no se han descargado. |
rslsTotal | el número total de archivos que se han descargado, correctamente o no. |
bytesLoaded | El número total de bytes descargados en los archivos que se han descargado correctamente. |
bytesTotal | el número total de bytes descargados en los archivos que ha descargado, correctamente o no. |
import fl.events.RSLEvent; myPreloader.addEventListener(RSLEvent.RSL_LOAD_COMPLETE, loadComplete); function loadComplete(e:RSLEvent) { gotoAndPlay('startOfContent'); }
rslLoadFailed | Evento |
fl.events.RSLErrorEvent
propiedad RSLErrorEvent.type =
fl.events.RSLErrorEvent.RSL_LOAD_FAILED
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flash CS5 |
Versiones de motor de ejecución: | Flash Player 10.1, AIR 2 |
Distribuido por RSLPreloader cuando ha terminado la descarga de todas las RSL y una o varias han fallado.
Error distribuido porRSLPreloader
cuando ha terminado la descarga de todas las RSL y una o varias han fallado. Cuando se precarga con un bucle de evento personalizado, el contenido del usuario DEBE detectar este evento para determinar cuándo salir del bucle de animación de carga.
Este evento tiene las propiedades siguientes:
Propiedad | Valor |
---|---|
bubbles | true |
cancelable | false ; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | La instancia de DisplayObject que se va a añadir a la lista de visualización. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente. |
rslsLoaded | El número de archivos que se han descargado correctamente. |
rslsFailed | El número de archivos que no se han descargado. |
rslsTotal | el número total de archivos que se han descargado, correctamente o no. |
failedURLs | Un conjunto de archivos que no se han descargado. |
import fl.events.RSLErrorEvent; myPreloader.addEventListener(RSLErrorEvent.RSL_LOAD_FAILED, rslLoadFailedHandler); function rslLoadFailedHandler(e:RSLErrorEvent) { gotoAndPlay('rslLoadFailure'); }
rslProgress | Evento |
fl.events.RSLEvent
propiedad RSLEvent.type =
fl.events.RSLEvent.RSL_PROGRESS
Versión del lenguaje: | ActionScript 3.0 |
Versión de producto: | Flash CS5 |
Versiones de motor de ejecución: | Flash Player 10.1, AIR 2 |
Distribuido por RSLPreloader para indicar el progreso de descarga de archivos RSL.
Evento distribuido porRSLPreloader
para indicar el progreso de descarga de archivos RSL. Éste es el único tipo de evento para el que las propiedades bytesLoaded
y bytesTotal
son distintas de cero.
Este evento tiene las propiedades siguientes:
Propiedad | Valor |
---|---|
bubbles | true |
cancelable | false ; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | La instancia de DisplayObject que se va a añadir a la lista de visualización. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente. |
rslsLoaded | El número de archivos que se han descargado correctamente. |
rslsFailed | El número de archivos que no se han descargado. |
rslsTotal | el número total de archivos que se han descargado, correctamente o no. |
bytesLoaded | El número total de bytes descargados en los archivos que se han descargado correctamente. |
bytesTotal | el número total de bytes descargados en los archivos que ha descargado, correctamente o no. |
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:12 PM Z