ProLoader  - AS3 Flash

Contiene el objeto de visualización raíz del archivo SWF o el archivo de imagen (JPG, PNG o GIF) que se cargó empleando los métodos load() o loadBytes().

Devuelve un objeto ProLoaderInfo que corresponde al objeto que se está cargando. Los objetos ProLoaderInfo se comparten entre el objeto ProLoader y el objeto de contenido cargado. El objeto ProLoaderInfo proporciona información de progreso de carga y estadísticas sobre el archivo cargado.

Los eventos relacionados con la carga se distribuyen mediante el objeto ProLoaderInfo al que hace referencia la propiedad contentLoaderInfo del objeto ProLoader. La propiedad contentLoaderInfo se establece como un objeto ProLoaderInfo válido, antes incluso de que se cargue el contenido, de modo que se puedan añadir detectores de eventos al objeto antes de la carga.

Para detectar errores no capturados producidos en un archivo SWF cargado, utilice la propiedad ProLoader.uncaughtErrorEvents, no la propiedad ProLoader.contentLoaderInfo.uncaughtErrorEvents.

Nota La propiedad contentLoaderInfo devuelve un objeto ProLoaderInfo. ProLoaderInfo no es una subclase de LoaderInfo y, por lo tanto, no ofrece las ventajas de una copia implícita en la superclase. Por ello, asegúrese de cambiar su declaraciones type de LoaderInfo a ProLoaderInfo.

Un objeto que distribuye un evento uncaughtError cuando se produce un error no gestionado en el código de este objeto ProLoader del archivo SWF. Un error sin capturar se produce cuando se emite un error fuera de los bloques try..catch o cuando un objeto ErrorEvent se distribuye sin ningún detector registrado.

Esta propiedad se crea cuando el archivo SWF asociado a este objeto ha terminado de cargarse. Hasta entonces, la propiedad uncaughtErrorEvents es null. En un proyecto sólo de ActionScript, puede acceder a esta propiedad durante o después de la ejecución de la función del constructor de la clase principal del archivo SWF.

Acceder a esta propiedad ProLoader en un reproductor que no admita, producirá un error. Devuelve un objeto EventDispatcher en lugar de un objeto UncaughtErrorEvents para evitar generar errores en reproductores no compatibles.

Elementos de API relacionados

Crea un objeto ProLoader que puede utilizar para cargar archivos como, por ejemplo, archivos SWF, JPEG, GIF o PNG. Llame al método load() para cargar el activo como elemento secundario de la instancia de ProLoader. Posteriormente, puede añadir el objeto ProLoader a la lista de visualización (por ejemplo, empleando el método addChild() de una instancia de DisplayObjectContainer). El activo aparece en el escenario conforme se va cargando.

También puede utilizar una instancia "offlist" (fuera de lista) de ProLoader, es decir, sin añadirla a un contenedor de objeto de visualización de la lista de visualización. En este modo, la instancia de Loader podría utilizarse para cargar un archivo SWF que contuviera módulos adicionales de una aplicación.

Para detectar cuándo termina de cargarse el archivo SWF, puede utilizar los eventos del objeto ProLoaderInfo asociado a la propiedad contentLoaderInfo del objeto ProLoader. Al llegar a ese punto, puede ejecutarse el código del archivo SWF de módulo para inicializar e iniciar el módulo. En el modo offlist (fuera de lista), una instancia de ProLoader podría utilizarse para cargar un archivo SWF que contuviera componentes o elementos multimedia adicionales. Una vez más, puede utilizar las notificaciones de eventos de objeto ProLoaderInfo para detectar cuándo terminan de cargarse los componentes. Al llegar a este punto, la aplicación puede comenzar a utilizar los componentes y elementos multimedia de la biblioteca del archivo SWF mediante la creación de instancias de las clases de ActionScript 3.0 que representan a dichos componentes y elementos.

Para determinar el estado de un objeto ProLoader, controle los siguientes eventos del objeto ProLoaderInfo asociado a la propiedad contentLoaderInfo del objeto ProLoader:

• El evento open se distribuye cuando comienza la carga.
• El evento ioError o securityError se distribuye si el archivo no se puede cargar o si se produce un error durante el proceso de carga.
• El evento progress se activa continuamente mientras se está cargando el archivo.
• El evento complete se distribuye cuando finaliza la descarga de un archivo, pero antes de que estén disponibles los métodos y propiedades del clip de película cargado. Si el archivo SWF cargado utiliza precarga RSL, este evento se distribuye después de que finalice la precarga RSL. En este punto, el contenido real está disponible en la propiedad content.
• El evento init se distribuye una vez que estén accesibles las propiedades y los métodos del archivo SWF cargado, de manera que pueda comenzar a manipular el archivo SWF cargado. Se distribuye este evento antes que el controlador complete. Al transmitir mediante flujo archivos SWF, el evento init puede tener lugar bastante antes que el evento complete. En la mayoría de los casos, utilice el controlador init. Si el archivo SWF cargado utiliza precarga RSL, este evento se distribuye después de que finalice la precarga RSL. En este punto, el contenido real está disponible en la propiedad content.

Elementos de API relacionados

Cancela una operación de método load() que está actualmente en curso para la instancia de ProLoader.

Carga un archivo SWF, JPEG, JPEG progresivo, GIF sin animar o PNG en un objeto que es un elemento secundario de este objeto ProLoader. Si carga un archivo GIF animado, sólo aparece el primer fotograma. Dado que el objeto ProLoader sólo puede contener un único elemento secundario, la emisión de una petición load() posteriormente pone fin a la petición anterior, si ésta continúa pendiente, y comienza una nueva carga.

Nota: en AIR 1.5 y en Flash Player 10, el tamaño máximo de una imagen cargada es 8,191 píxeles de ancho o de largo, y el número total máximo de píxeles es 16.777.215. (De modo que si una imagen cargada tiene una anchura de 8.191 píxeles, sólo puede tener 2.048 píxeles de alto.) En Flash Player 9 y versiones anteriores y en AIR 1.1 y versiones anteriores, el límite es 2.880 píxeles de alto y 2.880 píxeles de ancho.

Un archivo SWF o imagen cargada en un objeto ProLoader hereda las propiedades de posición, giro y escala de los objetos de visualización principales del objeto ProLoader.

Utilice el método unload() para eliminar películas o imágenes cargadas con este método o cancelar una operación de carga que se encuentra en curso.

Asimismo, se puede impedir que un archivo SWF utilice este método si define el parámetro allowNetworking de las etiquetas object y embed de la página HTML que aloja el contenido SWF.

Cuando utilice este método, considere el modelo de seguridad de Flash Player (consulte la descripción de la clase ProLoader).

En Flash Player 10 y versiones posteriores, si utiliza una estructura Content-Type de varias partes (por ejemplo, "multipart/form-data") con una acción de carga (indicada por un parámetro "filename" en un encabezado "content-disposition" dentro del cuerpo POST), la operación POST está sujeta a las reglas de seguridad aplicadas a las cargas:

• Es preciso realizar una operación POST como respuesta a una acción iniciada por el usuario, por ejemplo, un clic de ratón o la pulsación de una tecla.
• Si la operación POST afecta a varios dominios (el destino POST no se encuentra en el mismo servidor que el archivo SWF que envía la petición POST), el servidor de destino debe proporcionar un archivo de política URL que permita el acceso a varios dominios.

Asimismo, en cualquier estructura Content-Type de varias partes, la sintaxis debe ser válida (de acuerdo con la norma RFC2046). Si la sintaxis no es válida, la operación POST está sujeta a las reglas de seguridad que se aplican a las cargas.

Para obtener más información, consulte el tema del Centro de desarrollo de Flash Player Seguridad.

Parámetros

Elementos de API relacionados

Se carga a partir de datos binarios almacenados en un objeto ByteArray.

El método loadBytes() es asíncrono. Se debe esperar al evento "init" antes de acceder a las propiedades de un objeto cargado.

Cuando utilice este método, considere el modelo de seguridad de Flash Player (consulte la descripción de la clase ProLoader).

Parámetros

Elementos de API relacionados

Carga una instancia de IFilePromise a través del parámetro promise. El tipo del parámetro promise utiliza la superclase Object en lugar de IFilePromise para evitar errores en otros reproductores.

El método loadFilePromise toma un objeto IFilePromise y carga los datos binarios. Si los datos son un flujo progresivo, como una espera de vídeo para los eventos "init" o progress antes de acceder a las propiedades del objeto cargado. De lo contrario, espera al evento complete para asegurarse de que los datos se han cargado por completo.

Cuando utilice este método, considere el modelo de seguridad de Flash Player (consulte la descripción de la clase ProLoader).

Parámetros

Elementos de API relacionados

Elimina un elemento secundario del objeto ProLoader que se cargó utilizando el método load(). El elemento property del objeto ProLoaderInfo asociado se restablece con el valor null. El elemento secundario no se destruye necesariamente, ya que otros objetos pueden contener referencias a él; sin embargo, deja de ser elemento secundario del objeto ProLoader.

La práctica más recomendable consiste en cerrar explícitamente los flujos de los objetos de un archivo SWF secundario como, por ejemplo, los objetos LocalConnection, NetConnection, NetStream y Sound, antes de descargar dicho archivo SWF secundario. En caso contrario, podría continuar reproduciéndose el sonido del archivo SWF secundario aunque se hubiera descargado el archivo SWF secundario. Para cerrar los flujos del archivo SWF secundario, añada un detector de eventos al elemento secundario que detecte el evento unload. Cuando el elemento principal llame a ProLoader.unload(), se distribuirá el evento unload al elemento secundario. En el ejemplo siguiente, se muestra cómo puede lograr esto:

function closeAllStreams(evt:Event) { 
    myNetStream.close();
    mySound.close();
    myNetConnection.close();
    myLocalConnection.close();
}

myMovieClip.loaderInfo.addEventListener(Event.UNLOAD, closeAllStreams);

Elementos de API relacionados