LoaderContext  - AS3

Especifica si se puede utilizar un objeto Loader para importar contenido con código ejecutable, por ejemplo, un archivo SWF, en el entorno limitado de seguridad del elemento que realiza la llamada. Hay dos operaciones de importación afectadas: el método Loader.loadBytes() y los métodos Loader.load() con LoaderContext.securityDomain = SecurityDomain.currentDomain. (La última operación no se admite en el entorno limitado de la aplicación de AIR.) Con la propiedad allowCodeImportestablecida como false, las operaciones de importación quedan limitadas a operaciones seguras, como cargar imágenes. La carga normal de archivos SWF sin importación con el método Loader.load() no se ve afectada por el valor de esta propiedad.

Esta propiedad es útil si desea importar contenido de la imagen en el entorno limitado (por ejemplo, cuando desee duplicar o procesar una imagen de un dominio diferente) pero no desea tomar el riesgo de seguridad de un archivo SWF receptor cuando se espera sólo un archivo de imagen. Dado que los archivos SWF pueden contener código ActionScript, importar un archivo SWF es una operación mucho más arriestada que importar un archivo de imagen.

En el contenido de AIR del entorno limitado de la aplicación, el valor predeterminado es false. En contenido ajeno a la aplicación (que incluye todo el contenido de Flash Player), el valor predeterminado es true.

La propiedad allowCodeImport se ha añadido en Flash Player 10.1 y AIR 2.0. No obstante, esta propiedad está disponible para los archivos SWF y las aplicaciones de AIR de todas las versiones si el motor de ejecución de Flash lo admite.

Elementos de API relacionados

Propiedad heredada, reemplazada por allowCodeImport, pero aún se admite por motivos de compatibilidad. Anteriormente, la única operación afectada por allowLoadBytesCodeExecution era el método Loader.loadBytes(), pero en Flash Player 10.1 y AIR 2.0, la operación de importación/carga de Loader.load() con LoaderContext.securityDomain = SecurityDomain.currentDomain se ve afectada también. (La última operación no se admite en el entorno limitado de la aplicación de AIR.) Este efecto doble hace que el nombre de la propiedad allowLoadBytesCodeExecution sea específico, por lo que ahora allowCodeImport es el nombre preferido para la propiedad. Ajustar los valores de allowCodeImport o allowLoadBytesCodeExecution influirá en el valor de ambos.

Especifica si se puede utilizar un objeto Loader para importar contenido con código ejecutable, por ejemplo, un archivo SWF, en el entorno limitado de seguridad del elemento que realiza la llamada. Con esta propiedad establecida como false, las operaciones de importación quedan limitadas a operaciones seguras, como cargar imágenes.

En el contenido de AIR del entorno limitado de la aplicación, el valor predeterminado es false. En contenido ajeno a la publicación, el valor predeterminado es true.

Elementos de API relacionados

Especifica el dominio de aplicación que se utiliza para los métodos Loader.load() o Loader.loadBytes(). Utilice esta propiedad sólo si carga un archivo SWF creado con ActionScript 3.0 (no una imagen ni un archivo SWF creados en ActionScript 1.0 ó 2.0).

Todos los dominios de seguridad se dividen en uno o varios dominios de aplicación, que están representados por objetos ApplicationDomain. Los dominios de aplicación no se destinan a la seguridad; sirven para administrar la cooperación de las unidades del código ActionScript. Si carga un archivo SWF desde otro dominio y permite su colocación en un dominio de seguridad independiente, no podrá controlar la elección del dominio de aplicación en el que se situará el archivo SWF cargado; si ha especificado una elección de dominio de aplicación, ésta se ignorará. Sin embargo, si carga un archivo SWF en su propio dominio de seguridad (bien porque el archivo procede de su propio dominio o porque se importa en su propio dominio de seguridad), sí podrá controlar la elección del dominio de aplicación para el archivo SWF cargado.

Puede transmitir un dominio de aplicación sólo desde su propio dominio de seguridad en LoaderContext.applicationDomain. Si intenta transmitir un dominio de aplicación desde otro dominio de seguridad, el resultado será un excepción SecurityError.

Existen cuatro opciones en cuanto al tipo de propiedad ApplicationDomain que puede utilizarse:

• Elemento secundario de la propiedad ApplicationDomain de la clase Loader. Es la opción predeterminada. Esta opción se puede representar de forma explícita con la sintaxis new ApplicationDomain(ApplicationDomain.currentDomain). Esto permite que el archivo SWF cargado utilice las clases principales directamente, por ejemplo, escribiendo new MyClassDefinedInParent(). Sin embargo, el elemento principal no puede utilizar esta sintaxis; si el elemento principal desea utilizar las clases secundarias, debe llamar a ApplicationDomain.getDefinition() para recuperarlas. La ventaja de esta opción es que, si el elemento secundario define una clase con el mismo nombre que una clase ya definida por el elemento principal, no se producirá ningún error; el elemento secundario simplemente hereda la definición principal de dicha clase y la definición secundaria conflictiva no se utiliza a no ser que el elemento principal o el secundario llame al método ApplicationDomain.getDefinition() para recuperarla.
• Propiedad ApplicationDomain del propio objeto Loader. Recurra a este dominio de aplicación si utiliza ApplicationDomain.currentDomain. Una vez completada la carga, los elementos principal y secundario pueden utilizar sus respectivas clases directamente. Si el elemento secundario intenta definir una clase con el mismo nombre que la clase ya definida por el elemento principal, se utiliza la clase del elemento principal y se omite la del elemento secundario.
• Elemento secundario de la propiedad ApplicationDomain del sistema. Recurra a este dominio de aplicación si utiliza new ApplicationDomain(null). Esto separa el cargador y el elemento cargado por completo y les permite definir versiones independientes de clases con el mismo nombre sin riesgo de conflicto ni solapamiento. El único modo de que cada uno pueda ver las clases del otro es llamar al método ApplicationDomain.getDefinition().
• Elemento secundario de cualquier otra propiedad ApplicationDomain. En ocasiones, obtendrá una jerarquía ApplicationDomain más compleja. Puede cargar un archivo SWF en cualquier propiedad ApplicationDomain desde su propia propiedad SecurityDomain. Por ejemplo, new ApplicationDomain(ApplicationDomain.currentDomain.parentDomain.parentDomain) carga un archivo SWF en un nuevo elemento secundario del elemento principal del elemento principal del dominio actual.

Una vez completada la carga, cada lado (el que se carga y el cargador) puede necesitar su propia propiedad ApplicationDomain (o la propiedad ApplicationDomain del otro lado) para llamar a ApplicationDomain.getDefinition(). Cada lado puede recuperar una referencia de su propio dominio de aplicación mediante ApplicationDomain.currentDomain. El archivo SWF que se carga puede recuperar una referencia a la propiedad ApplicationDomain del archivo SWF cargado mediante Loader.contentLoaderInfo.applicationDomain. Si el archivo SWF cargado sabe cómo se cargó, podrá encontrar el camino hasta el objeto ApplicationDomain del archivo SWF que se carga. Por ejemplo, si el elemento secundario se cargó de forma predeterminada, podrá encontrar el dominio de aplicación del archivo SWF que se carga mediante ApplicationDomain.currentDomain.parentDomain.

Para más información, consulte el apartado "Clase ApplicationDomain" del capítulo “Entorno del sistema del cliente” de la Guía del desarrollador de ActionScript 3.0.

Elementos de API relacionados

Especifica si la aplicación debe intentar descargar un archivo de política URL desde el servidor del objeto cargado antes de comenzar la carga del propio objeto. Esta marca se aplica al método Loader.load(), pero no a Loader.loadBytes().

Establezca la marca como true al cargar una imagen (archivo JPEG, GIF o PNG) desde el exterior de la llamada al dominio del propio archivo SWF y si necesitará acceder al contenido de dicha imagen desde ActionScript. Algunos ejemplos de acceso al contenido de las imágenes son hacer referencia a la propiedad Loader.content para obtener un objeto Bitmap o llamar al método BitmapData.draw() para obtener una copia de los píxeles de la imagen cargada. Si intenta realizar una de estas operaciones sin especificar checkPolicyFile en el tiempo de carga, es probable que obtenga una excepción SecurityError, ya que no se ha descargado aún el archivo de política necesario.

Al llamar al método Loader.load() con LoaderContext.checkPolicyFile definido como true, la aplicación no inicia la descarga del objeto especificado en URLRequest.url hasta haber descargado correctamente un archivo adecuado de política URL o hasta descubrir que no existe ningún archivo de política correcto. Flash Player o AIR primero tiene en cuenta los archivos de política ya descargados. Seguidamente, intenta descargar cualquier archivo de política pendiente especificado en las llamadas al método Security.loadPolicyFile() y, a continuación, intenta descargar un archivo de política desde la ubicación predeterminada que corresponde a URLRequest.url, que es /crossdomain.xml en el mismo servidor que URLRequest.url. En todos los casos, el archivo de política dado debe existir en URLRequest.url por la ubicación del archivo de política, y el archivo debe permitir el acceso a una o varias etiquetas <allow-access-from>.

Si define checkPolicyFile en true, la descarga principal especificada en el método Loader.load() no se carga hasta que se procesa completamente el archivo de política. Por lo tanto, siempre y cuando exista el archivo de política necesario, la descarga habrá finalizado tan pronto como se reciba cualquiera de los eventos ProgressEvent.PROGRESS o Event.COMPLETE de la propiedad contentLoaderInfo del objeto Loader, y podrá comenzar de forma segura las operaciones que requieren el archivo de política.

Si define checkPolicyFile como true y no se encuentra ningún archivo de política adecuado, no se recibe ningún indicio de error hasta que no se intente la operación que emite una excepción SecurityError. Sin embargo, cuando el objeto LoaderInfo distribuye un evento ProgressEvent.PROGRESS o Event.COMPLETE, se puede comprobar si se encontró un archivo de política adecuado verificando el valor de la propiedad LoaderInfo.childAllowsParent.

Si no necesita un acceso a nivel de píxeles en la imagen que va a cargar, no debe definir la propiedad checkPolicyFile como true. No es muy adecuado buscar un archivo de política en este caso, ya que podría retrasar el inicio de la descarga y consumir ancho de banda de red de forma innecesaria.

Intente también evitar el establecimiento de checkPolicyFile como true si utiliza el método Loader.load() para descargar un archivo SWF. Esto se debe a que los permisos de SWF a SWF no están controlados por archivos de política, sino por el método Security.allowDomain() y, por tanto, checkPolicyFile no surte ningún efecto al cargar un archivo SWF. No es muy adecuado buscar un archivo de política en este caso, ya que podría retrasar la descarga del archivo SWF y consumir ancho de banda de red de forma innecesaria. (Flash Player o AIR no puede saber si la descarga principal será un archivo SWF o una imagen, ya que la descarga del archivo de política se produce antes de la descarga principal.)

Debe tener cuidado con checkPolicyFile si descarga un objeto desde una URL que utilice redirección HTTP en el lado del servidor. Los archivos de política siempre se recuperan desde la URL inicial correspondiente especificada en URLRequest.url. Si el objeto final procede de una URL distinta por la redirección HTTP, puede que los archivos de política descargados inicialmente no se puedan aplicar a la URL final del objeto, que es la URL determinante en las decisiones de seguridad. Si se produce esta situación, puede examinar el valor de LoaderInfo.url tras recibir un evento ProgressEvent.PROGRESS o Event.COMPLETE, que le indicará la URL final del objeto. A continuación, llame al método Security.loadPolicyFile() con una URL de archivo de política basada en la URL final del objeto. A continuación, sondee el valor de LoaderInfo.childAllowsParent hasta que sea true.

No necesita definir esta propiedad en contenido de AIR ejecutado en el entorno limitado de la aplicación. El contenido del entorno limitado de la aplicación de AIR puede llamar al método BitmapData.draw() utilizando cualquier contenido cargado como origen.

Elementos de API relacionados

Especifica si se descodifican los datos de imagen de mapa de bits cuando se utilizan o cuando se cargan.

Bajo la norma predeterminada, ImageDecodingPolicy.ON_DEMAND, el motor de ejecución descodifica los datos de imagen cuando se necesitan (para la visualización u otra finalidad). Esta política mantiene el comportamiento de descodificación utilizado por las versiones anteriores del motor de ejecución.

En la política ImageDecodingPolicy.ON_LOAD, el motor de ejecución descodifica la imagen inmediatamente después de que se haya cargado y antes de distribuir el evento complete. La descodificación de imágenes mediante carga y no bajo demanda, puede mejorar la animación y el rendimiento de la interfaz de usuario. Notará la diferencia cuando visualice una sucesión rápida de varias imágenes cargadas. Algunos ejemplos de una visualización rápida de imágenes son las listas de desplazamiento o el control Cover Flow. Por otro lado, utilizar la política onLoad indiscriminadamente puede aumentar el uso de la memoria de la aplicación. Hay más datos de imagen descodificada en memoria de los que habría al mismo tiempo en la política onDemand.

En ambas políticas, el motor de ejecución utiliza la mismo caché y comportamiento una vez descodificada la imagen. El motor de ejecución puede vaciar los datos descodificados en cualquier momento y volver descodificar la imagen la próxima vez que sea necesario.

Para establecer la política de descodificación de imágenes (por ejemplo, en ON_LOAD):

     var loaderContext:LoaderContext = new LoaderContext(); 
     loaderContext.imageDecodingPolicy = ImageDecodingPolicy.ON_LOAD 
     var loader:Loader = new Loader(); 
     loader.load(new URLRequest("http://www.adobe.com/myimage.png"), loaderContext);
     

Elementos de API relacionados

Un objeto que contiene los parámetros para transferir al objeto LoaderInfo del contenido.

Normalmente, el valor de la propiedad contentLoaderInfo.parameters se obtiene analizando la URL de solicitud. Si se establece la variable de parameters, contentLoaderInfo.parameters obtiene su valor del objeto LoaderContext, en lugar de la URL de solicitud. La variable parameters sólo acepta objetos que contengan pares de cadena nombre-valor, similares a los parámetros de URL. Si el objeto no contiene pares de cadena nombre-valor, se emite un error IllegalOperationError.

La finalidad de esta API es activar el archivo SWF de carga para que reenvíe sus parámetros a un archivo SWF cargado. Esta funcionalidad es especialmente útil cuando se utiliza el método loadBytes(), ya que LoadBytes no permite transferir parámetros a través de la URL. Los parámetros se pueden reenviar correctamente sólo a otro archivo SWF de AS3; un archivo SWF de AS1 o AS2 no puede recibir los parámetros de forma accesible, aunque el objeto loaderInfo.parameters AS3 de AVM1Movie será el objeto reenviado.

Por ejemplo, considérese la siguiente URL:

http://yourdomain/users/jdoe/test01/child.swf?foo=bar;

El siguiente código utiliza la propiedad LoaderContext.parameters para reproducir un parámetro transferido a esta URL:

      import flash.system.LoaderContext; 
      import flash.display.Loader; 
      var l:Loader = new Loader(); 
      var lc:LoaderContext = new LoaderContext; 
      lc.parameters = { "foo": "bar" }; 
      l.load(new URLRequest("child.swf"), lc);
     

Para verificar que el parámetro se ha transferido correctamente, utilice la siguiente sentencia trace después de ejecutar este código:

trace(loaderInfo.parameters.foo);

Si el contenido se ha cargado correctamente, esta sentencia trace imprime el mensaje “bar”.

El elemento principal al que Loader intentará añadir el contenido cargado.

Cuando el contenido está completamente cargado, el objeto Loader normalmente se convierte en el elemento principal del contenido. Si requestedContentParent está definido, el objeto que especifica se convierte en el elemento principal, a menos que un error de tiempo de ejecución impida la asignación. Esta reasignación de estado también puede realizarse después del evento complete sin tener que usar esta propiedad. Sin embargo, si se especifica el elemento principal con LoaderContext.requestedContentParent, se eliminan eventos adicionales.

LoaderContext.requestedContentParent define el elemento principal deseado antes de que el fotograma uno active la ejecución del contenido cargado, pero después de que el constructor se haya ejecutado. Si requestedContentParent es null (valor predeterminado), el objeto Loader se convierte en elemento principal del contenido.

Si el contenido cargado es un objeto AVM1Movie, o si se emite un error cuando se llama a addChild() en el objeto requestedContentParent, se producen las siguientes operaciones:

• El objeto Loader se convierte en el elemento principal del contenido cargado.
• El motor de ejecución distribuye un evento AsyncErrorEvent.

Si el elemento principal y el contenido cargado se encuentran en diferentes entornos limitados de seguridad, y si el elemento principal solicitado no tiene acceso al contenido cargado, se producen las siguientes operaciones:

• El objeto Loader se convierte en el elemento principal del contenido cargado.
• El motor de ejecución distribuye un evento SecurityErrorEvent.

El siguiente código utiliza requestedContentParent para colocar el contenido cargado en un objeto Sprite:

      import flash.system.LoaderContext; 
      import flash.display.Loader; 
      import flash.display.Sprite; 
     
      var lc:LoaderContext = new LoaderContext(); 
      var l:Loader = new Loader(); 
      var s:Sprite = new Sprite(); 
      lc.requestedContentParent = s; 
      addChild(s); 
      l.load(new URLRequest("child.swf"), lc);
     

Cuando se ejecuta este código, el archivo SWF secundario aparece en el escenario. Este hecho confirma que el objeto Sprite que se añade al escenario es el elemento principal del archivo child.swf cargado.

Especifica el dominio de seguridad que se utiliza para una operación Loader.load(). Utilice esta propiedad sólo si carga un archivo SWF (no una imagen).

La elección del dominio de seguridad tiene relevancia únicamente si se carga un archivo SWF que pueda proceder de otro dominio distinto (un servidor diferente) del archivo SWF que se carga. Al cargar un archivo SWF desde su propio dominio, siempre se coloca en el dominio de seguridad. Sin embargo, al cargar un archivo SWF desde un dominio distinto, existen dos opciones. Puede permitir que el archivo SWF cargado se coloque en su dominio de seguridad "natural", que no coincide con el del archivo SWF que se carga. Esta opción es la predeterminada. La otra opción consiste en especificar que desea colocar el archivo SWF cargado en el mismo dominio de seguridad que el archivo SWF que se carga. Para ello, establezca myLoaderContext.securityDomain para que sea igual que SecurityDomain.currentDomain. Este proceso recibe el nombre de carga de importación y equivale, en lo que respecta a la seguridad, a copiar el archivo SWF cargado en su propio servidor y cargarlo desde allí. Para que la carga de importación sea correcta, el servidor del archivo SWF cargado debe disponer de un archivo de política apto para el dominio del archivo SWF que se carga.

Puede transmitir su propio dominio de seguridad sólo en LoaderContext.securityDomain. Si intenta transmitir cualquier otro dominio de seguridad, el resultado será una excepción SecurityError.

El contenido del entorno limitado de seguridad de la aplicación de AIR no puede cargar contenido desde otros entornos limitados a su propio dominio de seguridad SecurityDomain.

Para obtener más información, consulte el capítulo “Seguridad” de la Guía del desarrollador de ActionScript 3.0.

Elementos de API relacionados

Crea un nuevo objeto LoaderContext con la configuración especificada. Para obtener información detallada sobre esta configuración, consulte las descripciones de las propiedades de esta clase.

Elementos de API relacionados