LoaderContext  - AS3

Especifica se você pode usar um objetoLoader para importar o conteúdo com o código executável, tal como um arquivo SWF, na área de segurança do chamador. Há duas operações de importação afetadas: o método Loader.loadBytes() e o método Loader.load()com LoaderContext.securityDomain = SecurityDomain.currentDomain . (A última operação não é suportada na caixa de proteção de aplicativos do AIR.) Com a propriedade allowCodeImport definida como false , estas operações de importação são restringidas a operações seguras, tais como carregar imagens. O arquivo SWF normal, não de importação, carregando com o método Loader.load() não é afetado pelo valor desta propriedade.

Esta propriedade é útil quando você quer importar o conteúdo de imagem na sua caixa de proteção - por exemplo, quando você quer duplicar ou processar uma imagem de um domínio diferente - mas não quer assumir o risco de segurança de receber um arquivo SWF quando esperava apenas um arquivo de imagem. Uma vez que os arquivos SWF podem conter o código de ActionScript, importar um arquivo SWF é uma operação muito mais arriscada do que a importação de um arquivo de imagem.

No conteúdo AIR na caixa de proteção do aplicativo, o valor padrão é false. No conteúdo estranho ao aplicativo (que inclui todo o conteúdo em Flash Player), o valor padrão é true.

A propriedade allowCodeImport foi adicionada no Flash Player 10.1 e AIR 2.0. Contudo, esta propriedade é posta à disposição em arquivos SWF e aplicativos AIR de todas as versões quando o Flash Runtime suporta isso.

Elementos da API relacionados

Propriedade legacy, substituída por allowCodeImport , mas ainda suportada para fim de compatibilidade. Anteriormente, a única operação afetada por allowLoadBytesCodeExecution foi o método Loader.loadBytes(), mas desde o Flash Player 10.1 e o AIR 2.0 a operação que carrega a importação de Loader.load() com LoaderContext.securityDomain = SecurityDomain.currentDomain também é afetada. (A última operação não é suportada na caixa de proteção de aplicativos do AIR.) Este efeito duplo tornou o nome da propriedade allowLoadBytesCodeExecution muito específico; assim, agora allowCodeImport é o nome da propriedade preferencial. Configurar allowCodeImport ou allowLoadBytesCodeExecution afetará o valor de ambos.

Especifica se você pode usar um objetoLoader para importar o conteúdo com o código executável, tal como um arquivo SWF, na área de segurança do chamador. Com esta propriedade definida como false, estas operações de importação são restritas a operações seguras como carregar imagens.

No conteúdo AIR na caixa de proteção do aplicativo, o valor padrão é false. No conteúdo "não aplicativo", o valor padrão é true.

Elementos da API relacionados

Especifica o domínio de aplicativo a ser usado para o método Loader.load() ou Loader.loadBytes(). Use esta propriedade apenas durante o carregamento de um arquivo SWF gravado no ActionScript 3.0 (não uma imagem ou arquivo SWF gravado no ActionScript 1.0 ou no ActionScript 2.0).

Todo domínio de segurança é dividido em um ou mais domínios de aplicativo, representado pelos objetos ApplicationDomain. Os domínios de aplicativo não são para fins de segurança, eles são para unidades de auxilio de gerenciamento do código ActionScript. Se você estiver carregando um arquivo SWF de outro domínio e permitir que ele seja colocado em um domínio de segurança distinto, não será possível controlar a escolha de domínio de aplicativo em que o arquivo SWF carregado será colocado, e se você tiver especificado uma opção de domínio de aplicativo, ela será ignorada. No entanto, se estiver carregando um arquivo SWF em seu próprio domínio de segurança, seja porque o arquivo SWF vem do seu próprio domínio ou porque você o está importando para o seu domínio de segurança, você poderá controlar a seleção de domínio de aplicativo do arquivo SWF carregado.

Você só pode transmitir um domínio de aplicativo de seu próprio domínio de segurança em LoaderContext.applicationDomain. A tentativa de transmitir um domínio de aplicativo de qualquer outro domínio de segurança resulta em uma exceção SecurityError.

Você tem quatro opções do tipo de propriedade ApplicationDomain a usar:

• ApplicationDomain do carregador child. O padrão. Você pode representar explicitamente essa opção com a sintaxe new ApplicationDomain(ApplicationDomain.currentDomain). Isso permite que o arquivo SWF carregado use diretamente as classes do pai, por exemplo, gravando new MyClassDefinedInParent(). O pai, entretanto, não pode usar essa sintaxe. Se o pai quiser usar as classes do filho, ele deverá chamar o ApplicationDomain.getDefinition() para recuperá-las. A vantagem dessa opção é que, se o filho definir uma classe com o mesmo nome de uma classe já definida pelo pai, não resultará em erro; o filtro simplesmente herdará a definição do pai dessa classe e a definição conflitante do filho permanecerá sem uso mesmo que o filho ou o pai chamem o método ApplicationDomain.getDefinition() para recuperá-la.
• ApplicationDomain do próprio carregador. Você utiliza esse domínio de aplicativo ao usar o ApplicationDomain.currentDomain. Quando a carga estiver concluída, pai e filho podem usar diretamente a classe um do outro. Se o filho tentar definir uma classe com o mesmo nome de uma classe já definida pelo pai, a classe do pai será usada e a classe do filho ignorada.
• Filho do ApplicationDomain do sistema. Você utiliza esse domínio de aplicativo quando usar o new ApplicationDomain(null). Essa ação separa carregador e carregado completamente, permitindo que definam versões de classes distintas com o mesmo nome sem conflito ou ofuscação. A única maneira de um lado ver as classes do outro é chamando o método ApplicationDomain.getDefinition().
• Filho de algum outro ApplicationDomain. Ocasionalmente, você pode ter uma hierarquia ApplicationDomain mais complexa. Você pode carregar o arquivo SWF em qualquer ApplicationDomain de seu próprio SecurityDomain. Por exemplo, o new ApplicationDomain(ApplicationDomain.currentDomain.parentDomain.parentDomain) carrega o arquivo SWF em um novo filho do pai do pai do domínio atual.

Quando a carga for concluída, um dos lados (de carregamento ou carregado) talvez precise localizar o respectivo ApplicationDomain ou o ApplicationDomain do outro lado, com a finalidade de chamar o ApplicationDomain.getDefinition(). Cada lado pode recuperar a referência para o próprio domínio de aplicativo usando o ApplicationDomain.currentDomain. O arquivo SWF de carregamento pode recuperar a referência para o ApplicationDomain do arquivo SWF carregado por meio de Loader.contentLoaderInfo.applicationDomain. Se o arquivo SWF carregado souber como foi carregado, ele poderá localizar o próprio caminho para o objeto ApplicationDomain do arquivo SWF carregado. Por exemplo, se o filho foi carregado da maneira padrão, ele poderá encontrar o domínio de aplicativo do arquivo SWF carregado usando o ApplicationDomain.currentDomain.parentDomain.

Para obter mais informações, consulte a seção "Classe ApplicationDomain" do capítulo "Ambiente do Sistema Cliente" do Guia do Desenvolvedor do ActionScript 3.0.

Elementos da API relacionados

Especifica se o aplicativo deverá tentar baixar um arquivo de diretivas de URL a partir do servidor do objeto carregado antes de começar a carregar o próprio objeto. Este sinalizador é aplicável ao método Loader.load() mas não ao método Loader.loadBytes().

Defina este sinalizador como true quando estiver carregando uma imagem (JPEG, GIF ou PNG) de fora do domínio do próprio arquivo SWF de chamada, e você espera precisar acessar o conteúdo dessa imagem no ActionScript. Exemplos de acesso ao conteúdo da imagem incluem referência à propriedade Loader.content para obter um objeto Bitmap e chamada do método BitmapData.draw() para obter uma cópia dos pixels da imagem carregada. parei aqui Se você tentar realizar uma dessas operações sem ter especificado o checkPolicyFile no momento do carregamento, poderá obter uma exceção SecurityError porque o arquivo de diretivas necessário ainda não foi baixado.

Quando você chama o método Loader.load() com o LoaderContext.checkPolicyFile definido como true, o aplicativo não inicia o download do objeto especificado em URLRequest.url até que tenha baixado com êxito um arquivo de diretivas de URL pertinente ou descoberto que esse arquivo de diretivas não existe. O Flash Player ou o AIR considera primeiro os arquivos de diretivas que já foram baixados e, em seguida, tenta baixar qualquer arquivo de diretivas pendente especificado em chamadas para o método Security.loadPolicyFile(); depois, tenta baixar um arquivo de diretivas do local padrão que corresponde ao URLRequest.url, que é o /crossdomain.xml no mesmo servidor do URLRequest.url. Em todos os casos, é solicitada a existência do arquivo de diretivas em URLRequest.url em virtude do local do arquivo de diretivas e o arquivo deve permitir o acesso de uma ou mais marcas <allow-access-from>.

Se checkPolicyFile for definido como true, o download principal especificado no método Loader.load() não será carregado até que o arquivo de diretiva tenha sido processado completamente. Portanto, desde que exista o arquivo de diretivas que você precisa, assim que você tiver recebido qualquer evento ProgressEvent.PROGRESS ou Event.COMPLETE da propriedade contentLoaderInfo do objeto Loader, o download do arquivo de diretivas será concluído e você poderá começar a executar com segurança operações que requerem o arquivo de diretivas.

Se você definir o checkPolicyFile como true e nenhum arquivo de diretivas relevante for encontrado, nenhuma indicação de erro será recebida até que você tente uma operação que lance uma exceção SecurityError. No entanto, depois que o objeto LoaderInfo enviar um evento ProgressEvent.PROGRESS ou Event.COMPLETE, você poderá testar se foi encontrado um arquivo de diretivas relevante, verificando o valor da propriedade LoaderInfo.childAllowsParent.

Se você não precisar de acesso de nível de pixels à imagem que está sendo carregada, não deverá definir a propriedade checkPolicyFile como true. Verificar o arquivo de diretivas nesse caso é inútil, pois pode atrasar o início do download e consumir desnecessariamente largura de banda de rede.

Tente também evitar definir checkPolicyFile como true se estiver usando o método Loader.load() para baixar um arquivo SWF. Isso ocorre porque permissões de SWF para SWF não são controladas por arquivos de diretivas, mas pelo método Security.allowDomain() e, portanto, checkPolicyFile não tem nenhum efeito quando você carrega um arquivo SWF. Verificar o arquivo de diretivas nesse caso é inútil, pois pode atrasar o download do arquivo SWF e consumir desnecessariamente largura de banda de rede. (O Flash Player ou o AIR não pode informar se seu download principal será um arquivo SWF ou uma imagem, porque o download do arquivo de diretivas ocorre antes do download principal).

Seja cauteloso com o checkPolicyFile se você estiver baixando um objeto de um URL que possa usar redirecionamentos HTTP no lado do servidor. Arquivos de diretivas são sempre recuperados do URL inicial correspondente especificado em URLRequest.url. Se o objeto final vier de um URL diferente devido a um redirecionamento HTTP, os arquivos de diretivas baixados inicialmente talvez não sejam aplicáveis ao URL final do objeto, que é o URL importante nas decisões de segurança. Se você se encontra nesta situação, poderá examinar o valor de LoaderInfo.url após ter recebido um eventoProgressEvent.PROGRESS ou Event.COMPLETE que informa o URL final do objeto. Em seguida, chame o método Security.loadPolicyFile() com um URL de arquivo de diretivas com base no URL final do objeto. Em seguida, consulte o valor de LoaderInfo.childAllowsParent até ele se tornar true.

Você não precisa definir essa propriedade para o conteúdo do AIR em execução na caixa de proteção do aplicativo. O conteúdo na caixa de proteção do aplicativo do AIR pode chamar o método BitmapData.draw() usando qualquer imagem carregada como origem.

Elementos da API relacionados

Especifica se é necessário decodificar dados de imagem quando utilizados ou quando carregados.

Na política padrão, ImageDecodingPolicy.ON_DEMAND, o tempo de execução decodifica os dados de imagem quando estes são necessários (para exibição ou outra finalidade). Esta política mantém o comportamento de decodificação usado por versões anteriores do tempo de execução.

Sob a política ImageDecodingPolicy.ON_LOAD, o tempo de execução decodifica a imagem imediatamente depois que é carregado e antes de despachar o evento complete. Decodificar imagens no carregamento em vez de decodificá-las sob demanda pode melhorar o desempenho de interface do usuário e a animação. É possível observar melhorias quando várias imagens carregadas são exibidas em sucessão rápida. Alguns exemplos de uma exibição rápida de imagens são listas de rolagem ou controle de fluxo coberto. Por outro lado, utilizar a política onLoad indiscriminadamente poderá aumentar a utilização da memória de pico de seu aplicativo. Mais dados de imagem decodificados poderão estar na memória de uma vez do que se estivesse na política onDemand.

Em ambas as políticas, o tempo de execução usa a mesma cache e comportamento de fluxo depois que a imagem é decodificada. O tempo de execução pode liberar os dados decodificados a qualquer momento e decodificar novamente a imagem na próxima vez em que isto seja necessário.

Para definir a política de decodificação de imagem (por exemplo, para 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 da API relacionados

Um objeto que contém os parâmetros para transmitir ao objeto LoaderInfo do conteúdo.

Normalmente, o valor do contentLoaderInfo.parameters a propriedade é obtida analisando o URL de solicitação. Se o parameters o var é definido, o contentLoaderInfo.parameters obtém o seu valor do objeto de LoaderContext, em vez de do URL de solicitação. A var parameters aceita somente objetos que contêm pares de string de nome-valor, semelhantes a parâmetros de URL. Se o objeto não contiver pares de string de nome-valor, um IllegalOperationError é lançado.

O propósito deste API deve ativar o Arquivo SWF de carregamento para expedir os seus parâmetros a um Arquivo SWF carregado. Esta funcionalidade é especialmente útil quando você usa o loadBytes() método, desde então LoadBytes não fornece um meio de transmitir parâmetros pelo URL. Os parâmetros podem ser expedidos com sucesso só a outro Arquivo SWF AS3; um AS1 ou o Arquivo SWF AS2 não podem receber os parâmetros em um formulário acessível, embora o AVM1Movie's AS3 loaderInfo.parameters objeto seja o objeto expedido.

Por exemplo, considere a seguinte URL:

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

O seguinte código usa a propriedade LoaderContext.parameters para replicar um parâmetro passado para 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 se o parâmetro foi passado corretamente, use a seguinte instrução trace depois de executar este código:

trace(loaderInfo.parameters.foo);

Se o conteúdo foi carregado com sucesso, este rastreamento imprimirá "bar".

O pai para o qual o Loader tentará adicionar o conteúdo carregado.

Quando o conteúdo é completamente carregado, o objeto de Carregador normalmente torna-se o pai do conteúdo. Se requestedContentParent é definido, o objeto que ele especifica torna-se o pai, a menos que um erro de tempo de execução previna a atribuição. Estes recuidados paternais também podem ser feitos depois o complete evento sem uso desta propriedade. Contudo, especificando o pai com LoaderContext.requestedContentParent elimina extra eventos.

LoaderContext.requestedContentParent estabelece o pai desejado antes do quadro que scriptes no conteúdo carregado realizam, mas depois que o construtor correu. Se requestedContentParent é nulo (o padrão), o objeto de Carregador torna-se o pai do conteúdo.

Se o conteúdo carregado for um objeto de AVM1Movie, ou se um erro for lançado quando addChild() é invocado no requestedContentParent objeto, então as seguintes ações ocorrem:

• O objeto de Carregador torna-se o pai do conteúdo carregado.
• O tempo de execução despacha um AsyncErrorEvent.

Se o pai solicitado e o conteúdo carregado estiverem em caixas de proteção de segurança diferentes, e se o pai solicitado não tiver acesso ao conteúdo carregado, então as seguintes ações ocorrem:

• O Carregador torna-se o pai do conteúdo carregado.
• O tempo de execução despacha a SecurityErrorEvent.

O código a seguir usa requestedContentParent para posicionar o conteúdo carregado em um 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);
     

Quando este código é executado, o arquivo SWF subordinado é exibido no palco. Esse fato confirma que o objeto Sprite que você adicionou ao palco é o pai do arquivo child.swf carregado.

Especifica o domínio de segurança a ser usado para uma operação Loader.load(). Só use essa propriedade quando carregar um arquivo SWF (não uma imagem).

A escolha do domínio de segurança só é significativa se você estiver carregando um arquivo SWF que possa vir de um domínio diferente (um servidor diferente) do arquivo SWF carregado. Quando você carrega um arquivo SWF do seu próprio domínio, ele é sempre colocado no respectivo domínio de segurança. Mas quando carrega um arquivo SWF de um domínio diferente, você tem duas opções. Você pode permitir que o arquivo SWF carregado seja colocado no próprio domínio de segurança "natural", que é diferente desse do arquivo SWF que está sendo carregado; este é o padrão. A outra opção é especificar que você deseja colocar o arquivo SWF carregado no mesmo domínio de segurança do arquivo SWF que está sendo carregado, definindo que myLoaderContext.securityDomain é igual a SecurityDomain.currentDomain. Isso se chama importar carregamento e equivale, para fins de segurança, a copiar o arquivo SWF carregado em seu próprio servidor e carregá-lo de lá. Para que a importação de carregamento seja bem sucedida, o servidor do arquivo SWF carregado deve ter um arquivo de diretrizes que confie no domínio do arquivo SWF que está sendo carregado.

Você só pode transmitir seu próprio domínio de segurança em LoaderContext.securityDomain. A tentativa de transmitir qualquer outro domínio de segurança resulta em uma exceção SecurityError.

O conteúdo na área de segurança do aplicativo AIR não pode carregar o conteúdo de outras áreas de segurança em seu SecurityDomain.

Para obter mais informações, consulte o capítulo "Segurança" no Guia do Desenvolvedor do ActionScript 3.0.

Elementos da API relacionados

Cria um novo objeto LoaderContext com as configurações especificadas. Para obter detalhes completos sobre essas configurações, consulte as descrições das propriedades dessa classe.

Elementos da API relacionados