LoaderInfo  - AS3

La versión de ActionScript del archivo SWF cargado. La versión del lenguaje se especifica mediante las enumeraciones de la clase ActionScriptVersion, como ActionScriptVersion.ACTIONSCRIPT2 y ActionScriptVersion.ACTIONSCRIPT3.

Nota: esta propiedad siempre tiene el valor ActionScriptVersion.ACTIONSCRIPT2 o ActionScriptVersion.ACTIONSCRIPT3. Tanto ActionScript 1.0 como 2.0 se indican como ActionScriptVersion.ACTIONSCRIPT2 (versión 2.0). Esta propiedad sólo distingue ActionScript 1.0 y 2.0 de ActionScript 3.0.

Elementos de API relacionados

Cuando se carga un archivo SWF externo, todas las definiciones de ActionScript 3.0 contenidas en la clase cargada se almacenan en la propiedad applicationDomain.

Todo el código de un archivo SWF se define para que exista en un dominio de aplicación. El dominio de aplicación actual es el lugar en el que se ejecuta la aplicación principal. El dominio del sistema contiene todos los dominios de aplicación, incluido el dominio actual y todas las clases utilizadas por Flash Player o Adobe AIR.

Todos los dominios de aplicación tienen asociado un dominio principal, excepto el dominio del sistema. El dominio principal del applicationDomain de la aplicación principal es el dominio del sistema. Sólo es necesario definir las clases cargadas si su clase principal no las ha definido todavía. No es posible anular una definición de clase cargada con otra definición más reciente.

Para consultar ejemplos de dominios de aplicación, consulte el capítulo “Entorno del sistema del cliente” de la Guía del desarrollador de ActionScript 3.0.

Elementos de API relacionados

Los bytes asociados al objeto LoaderInfo.

Número de bytes cargados para el medio. Cuando este número sea igual al valor de bytesTotal, se habrán cargado todos los bytes.

El número de bytes comprimidos en todo el archivo multimedia.

Antes de que el objeto Loader correspondiente a este objeto LoaderInfo distribuya el primer evento progress, bytesTotal es 0. Tras el primer evento progress del objeto Loader, bytesTotal reflejará el número real de bytes descargados.

Nota (solo iOS): cuando se ejecuta una aplicación en iOS, el valor devuelto no es el mismo que en otras plataformas.

Elementos de API relacionados

Expresa la relación de confianza del contenido (elemento secundario) hacia el Loader (elemento principal). Si el elemento secundario ha permitido el acceso del elemento principal, el valor es true; en caso contrario, el valor es false. Esta propiedad se define con el valor true si el objeto secundario ha llamado al método allowDomain() para conceder permiso al dominio principal o si hay una política de URL cargada en el dominio secundario que concede permiso al dominio principal. Si el elemento secundario y el elemento principal están en el mismo dominio, esta propiedad se define con el valor true.

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

Objeto que puede definirse con el código del contenido cargado para mostrar las propiedades y los métodos a los que se puede tener acceso a través del código del entorno limitado del objeto Loader. Este puente de entorno limitado permite al contenido de dominios ajenos a la aplicación disponer de acceso controlado a los scripts del entorno limitado de la aplicación, y viceversa. El puente de entorno limitado sirve de pasarela entre los entornos limitados, facilitando así una interacción explícita entre los entornos limitados de seguridad de la aplicación y los que no los on.

Elementos de API relacionados

El objeto cargado asociado a este objeto LoaderInfo.

El tipo MIME del archivo cargado. El valor es null si el archivo no se ha cargado lo suficiente como para que se determine el tipo. En la siguiente lista se enumeran los valores posibles:

• "application/x-shockwave-flash"
• "image/jpeg"
• "image/gif"
• "image/png"

La velocidad de fotogramas nominal, en fotogramas por segundo, del archivo SWF cargado. Este número suele ser un entero, aunque no tiene por qué serlo necesariamente.

Este valor puede ser diferente de la velocidad de fotogramas realmente utilizada. Flash Player o Adobe AIR sólo utiliza una velocidad de fotogramas para todos los archivos SWF cargados en un momento concreto y dicha velocidad se determina mediante la velocidad de fotogramas nominal del archivo SWF principal. Asimismo, es posible que no se alcance la velocidad de fotogramas principal debido al hardware, a la sincronización de sonido o a otros factores.

Altura nominal del archivo cargado. Este valor puede ser diferente de la altura real con la que se muestra el contenido, ya que es posible que se haya aplicado escala al contenido cargado o a sus objetos de visualización principales.

Indica si se ha truncado la propiedad LoaderInfo.url. Cuando el valor de isURLInaccessible es true, el valor de LoaderInfo.url es sólo el dominio de la URL final desde la que se cargó el contenido. Por ejemplo, la propiedad se trunca si el contenido se carga desde http://www.adobe.com/assets/hello.swf, y la propiedad LoaderInfo.url tiene el valor http://www.adobe.com. El valor de isURLInaccessible es true sólo cuando todos los siguientes también son true:

• Se ha producido una redirección HTTP durante la carga del contenido.
• El archivo SWF que llama a Loader.load() procede de un dominio distinto al de la URL final del contenido.
• El archivo SWF que llama a Loader.load() no tiene permiso para acceder al contenido. Se concede permiso para acceder al contenido del mismo modo que se concede para BitmapData.draw(): llame a Security.allowDomain() para acceder a un archivo SWF (o para contenido no SWF, establezca un archivo de política y utilice la propiedad LoaderContext.checkPolicyFile).

Nota: la propiedadisURLInaccessible se añadió en Flash Player 10.1 y en AIR 2.0. No obstante, esta propiedad está disponible para los archivos SWF de todas las versiones si el motro de ejecución de Flash lo admite. Así, utilizar determinadas herramientas de edición en “modo estricto” provoca un error de compilación. Para solucionar el error, utilice la sintaxis indirecta myLoaderInfo["isURLInaccessible"] o desactive el modo estricto. Si utiliza Flash CS5 Professional o Flex SDK 4.1, puede usar y compilar esta API para motores de ejecución previos a Flash Player 10.1 y AIR 2.

Para contenido de la aplicación en AIR, el valor de esta propiedad siempre es false.

Elementos de API relacionados

El objeto Loader asociado a este objeto LoaderInfo. Si el objeto LoaderInfo es la propiedad loaderInfo de la instancia de la clase principal del archivo SWF, no habrá ningún objeto Loader asociado.

La URL del archivo SWF que inició la carga del medio descrito por este objeto LoaderInfo. Para la instancia de la clase principal del archivo SWF, esta URL es la misma que la del propio archivo SWF.

Objeto que contiene los pares nombre-valor que representan los parámetros proporcionados al archivo SWF cargado.

Puede utilizar un bucle for-in para extraer todos los nombres y valores del objeto parameters.

Las dos fuentes de parámetros son: la cadena de consulta de la URL del archivo SWF principal y el valor del parámetro HTML FlashVars (éste sólo afecta al archivo SWF principal).

La propiedad parameters sustituye a la técnica de ActionScript 1.0 y 2.0 por la que los parámetros del archivo SWF se proporcionan como propiedades de la línea de tiempo principal.

El valor de la propiedad parameters es null para los objetos Loader que contengan archivos SWF que utilicen ActionScript 1.0 o 2.0. El valor sólo es distinto de null para los objetos Loader que contengan archivos SWF que utilicen ActionScript 3.0.

Expresa la relación de confianza del Loader (elemento principal) hacia el contenido (elemento secundario). Si el elemento principal ha permitido el acceso del elemento secundario, el valor es true; en caso contrario, es false. Esta propiedad se define con el valor true si el objeto principal ha llamado al método allowDomain() para conceder permiso al dominio secundario o si hay un archivo de política de URL cargado en el dominio principal que concede permiso al dominio secundario. Si el elemento secundario y el elemento principal están en el mismo dominio, esta propiedad se define con el valor true.

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

Objeto que puede definirse por código en el entorno limitado del objeto Loader para mostrar las propiedades y los métodos a los que se puede acceder desde el código del contenido cargado. Este puente de entorno limitado permite al contenido de dominios ajenos a la aplicación disponer de acceso controlado a los scripts del entorno limitado de la aplicación, y viceversa. El puente de entorno limitado sirve de pasarela entre los entornos limitados, facilitando así una interacción explícita entre los entornos limitados de seguridad de la aplicación y los que no los on.

Elementos de API relacionados

Expresa la relación de dominio entre el elemento cargador y el contenido: true si tienen el mismo dominio de origen; false en caso contrario.

Una instancia de EventDispatcher que puede utilizarse para intercambiar eventos entre límites de seguridad. Incluso cuando el objeto Loader y el contenido cargado se originan en dominios de seguridad que no confían entre sí, ambos pueden acceder a eventos sharedEvents y enviar y recibir eventos a través de este objeto.

La versión del formato del archivo SWF cargado. El formato del archivo se especifica mediante las enumeraciones de la clase SWFVersion, como SWFVersion.FLASH7 y SWFVersion.FLASH9.

Elementos de API relacionados

Un objeto que distribuye un evento uncaughtError cuando se produce un error no gestionado en el código de este objeto LoaderInfo 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.

Por ejemplo, si en un bloque try, hay un distribuidor de eventos que llama al controlador de eventos, el bloque catch no detecta el error si se inicia en el controlador de eventos. Cualquier error generado a partir de ese momento se puede detectar mediante LoaderInfo.uncaughtErrorEvents

Esta propiedad se crea cuando el archivo SWF asociado a este LoaderInfo 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. En proyectos de Flex, la propiedad uncaughtErrorEvents está disponible después de que se distribuya el evento applicationComplete.

Elementos de API relacionados

package
{
    import flash.display.Sprite;
    import flash.events.ErrorEvent;
    import flash.events.MouseEvent;
    import flash.events.UncaughtErrorEvent;

    public class UncaughtErrorEventExample extends Sprite
    {
        public function UncaughtErrorEventExample()
        {
            loaderInfo.uncaughtErrorEvents.addEventListener(UncaughtErrorEvent.UNCAUGHT_ERROR, uncaughtErrorHandler);
            
            drawUI();
        }
        
        private function uncaughtErrorHandler(event:UncaughtErrorEvent):void
        {
            if (event.error is Error)
            {
                var error:Error = event.error as Error;
                // do something with the error
            }
            else if (event.error is ErrorEvent)
            {
                var errorEvent:ErrorEvent = event.error as ErrorEvent;
                // do something with the error
            }
            else
            {
                // a non-Error, non-ErrorEvent type was thrown and uncaught
            }
        }
        
        private function drawUI():void
        {
            var btn:Sprite = new Sprite();
            btn.graphics.clear();
            btn.graphics.beginFill(0xFFCC00);
            btn.graphics.drawRect(0, 0, 100, 50);
            btn.graphics.endFill();
            addChild(btn);
            btn.addEventListener(MouseEvent.CLICK, clickHandler);
        }
        
        private function clickHandler(event:MouseEvent):void
        {
            throw new Error("Gak!");
        }
    }
}

<?xml version="1.0" encoding="utf-8"?>
<s:WindowedApplication xmlns:fx="http://ns.adobe.com/mxml/2009" 
                       xmlns:s="library://ns.adobe.com/flex/spark" 
                       xmlns:mx="library://ns.adobe.com/flex/halo"
                       applicationComplete="applicationCompleteHandler();">
    
    <fx:Script>
        <![CDATA[
            import flash.events.ErrorEvent;
            import flash.events.MouseEvent;
            import flash.events.UncaughtErrorEvent;
            
            private function applicationCompleteHandler():void
            {
                loaderInfo.uncaughtErrorEvents.addEventListener(UncaughtErrorEvent.UNCAUGHT_ERROR, uncaughtErrorHandler);
            }
    
            private function uncaughtErrorHandler(event:UncaughtErrorEvent):void
            {
                if (event.error is Error)
                {
                    var error:Error = event.error as Error;
                    // do something with the error
                }
                else if (event.error is ErrorEvent)
                {
                    var errorEvent:ErrorEvent = event.error as ErrorEvent;
                    // do something with the error
                }
                else
                {
                    // a non-Error, non-ErrorEvent type was thrown and uncaught
                }
            }
            
            private function clickHandler(event:MouseEvent):void
            {
                throw new Error("Gak!");
            }
        ]]>
    </fx:Script>
      
    <s:Button label="Cause Error" click="clickHandler(event);"/>
</s:WindowedApplication>

La URL del medio que se está cargando.

Antes de que el objeto Loader correspondiente a este objeto LoaderInfo distribuya el primer evento progress, el valor de la propiedad url podría reflejar sólo la URL inicial especificada en la llamada al método load() del objeto Loader. Tras el primer evento progress, la propiedad url reflejará la URL final del medio, después de cualquier redirección y de que se resuelvan las URL relativas.

En algunos casos, el valor de la propiedad url se trunca; consulte la propiedad isURLInaccessible para obtener más detalles.

Elementos de API relacionados

Anchura nominal del contenido cargado. Este valor puede ser diferente de la anchura real con la que se muestra el contenido, ya que es posible que se haya aplicado escala al contenido cargado o a sus objetos de visualización principales.

Devuelve el objeto LoaderInfo asociado al archivo SWF definido como objeto.

Parámetros

Se distribuye cuando los datos se han cargado correctamente. Dicho de otro modo, se distribuye cuando todo el contenido se ha descargado y la carga ha finalizado. El evento complete siempre se distribuye después del evento init. El evento init se distribuye cuando el objeto está listo para permitir el acceso, aunque no se haya descargado todo el contenido aún.

Este evento tiene las propiedades siguientes:

Elementos de API relacionados

Se distribuye cuando se realiza una petición de red sobre HTTP y se detecta un código de estado HTTP.

Este evento tiene las propiedades siguientes:

Elementos de API relacionados

Se distribuye cuando las propiedades y métodos de un archivo SWF cargado están accesibles y listos para usarse. El contenido, no obstante, se puede seguir descargando. Un objeto LoaderInfo distribuye el evento init cuando se cumplen las condiciones siguientes:

• Están accesibles todas las propiedades y los métodos asociados al objeto cargado y aquellos asociados al objeto LoaderInfo.
• Los constructores de todos los objetos secundarios deben haber finalizado.
• Ya se ha ejecutado todo el código de ActionScript del primer fotograma de la línea de tiempo principal del archivo SWF cargado.

Por ejemplo, se ha distribuido un evento Event.INIT al cargarse el primer fotograma de una película o una animación. Ya es posible acceder a la película y se puede añadir a la lista de visualización. Sin embargo, puede llevar más tiempo descargar toda la película. El evento Event.COMPLETE sólo se distribuye una vez cargada toda la película.

El evento init siempre precede al evento complete.

Este evento tiene las propiedades siguientes:

Elementos de API relacionados

Se distribuye cuando se produce un error de entrada o salida que provoca que una operación de carga se realice incorrectamente.

Este evento tiene las propiedades siguientes:

Elementos de API relacionados

Se distribuye cuando se inicia la operación de carga.

Este evento tiene las propiedades siguientes:

Elementos de API relacionados

Se distribuye al recibirse datos mientras progresa una operación de descarga.

Este evento tiene las propiedades siguientes:

Elementos de API relacionados

Se distribuye mediante un objeto LoaderInfo cuando un objeto cargado se elimina utilizando el método unload() del objeto Loader o cuando el mismo objeto Loader realiza una segunda carga y el contenido original se elimina antes de que comience la carga.

Este evento tiene las propiedades siguientes:

Elementos de API relacionados

1. Se crea una propiedad url, que es la ubicación y el nombre de la imagen.
2. El constructor de la clase crea un objeto Loader denominado loader.
3. El objeto loader crea una instancia de un detector de eventos para garantizar que la imagen se carga correctamente.
4. El constructor crea una nueva instancia de un objeto URLRequest, request, con url para que se conozcan el nombre del archivo y la ubicación.
5. El objeto request se transfiere después al método load() del objeto loader, que carga la imagen en la lista de visualización.

Importante: este ejemplo requiere que añada un archivo denominado Image.gif al mismo directorio que el archivo SWF compilado. Utilice una imagen que tenga un área que se ajuste a las dimensiones del archivo SWF principal.

package {
    import flash.display.Loader;
    import flash.display.LoaderInfo;
    import flash.display.Sprite;
    import flash.events.*;
    import flash.net.URLRequest;

    public class LoaderInfoExample extends Sprite {
        private var url:String = "Image.gif";

        public function LoaderInfoExample() {
            var loader:Loader = new Loader();
            loader.contentLoaderInfo.addEventListener(Event.INIT, initHandler);
            loader.contentLoaderInfo.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            var request:URLRequest = new URLRequest(url);
            loader.load(request);
            addChild(loader);
        }

        private function initHandler(event:Event):void {
            var loader:Loader = Loader(event.target.loader);
            var info:LoaderInfo = LoaderInfo(loader.contentLoaderInfo);
            trace("initHandler: loaderURL=" + info.loaderURL + " url=" + info.url);
        }

        private function ioErrorHandler(event:IOErrorEvent):void {
            trace("ioErrorHandler: " + event);
        }
    }
}