ProLoader  - AS3 Flash

Contém o objeto de exibição raiz do arquivo SWF ou do arquivo de imagem (JPEG, PNG ou GIF) que foi carregado com o uso do método load() ou loadBytes().

Retorna um objeto ProLoaderInfo correspondente ao objeto que está sendo carregado. Os objetos ProLoaderInfo são compartilhados entre o objeto ProLoader e o objeto de conteúdo carregado. O objeto ProLoaderInfo fornece informações sobre o progresso do carregamento e estatísticas sobre o arquivo carregado.

Os eventos relacionados ao carregamento são despachados pelo objeto ProLoaderInfo referenciado pela propriedade contentLoaderInfo do objeto ProLoader. A propriedade contentLoaderInfo é definida como um objeto ProLoaderInfo válido, antes de o conteúdo ser carregado, para que você possa adicionar ouvintes de eventos a esse objeto antes do carregamento.

Para descobrir erros não capturados que ocorrem em um SWF carregado, use a propriedade ProLoader.uncaughtErrorEvents, não a propriedade ProLoader.contentLoaderInfo.uncaughtErrorEvents.

Observar A propriedade contentLoaderInfo retorna um objeto de ProLoaderInfo. ProLoaderInfo não é uma subclasse de LoaderInfo e daqui não lhe dá a vantagem de uma forma implícita à superclasse. Por isso, esteja seguro de alterar as suas declarações de tipo de LoaderInfo a ProLoaderInfo.

Um objeto que despacha um evento uncaughtError quando um erro não controlado ocorre no código no arquivo SWF deste objeto ProLoader. Um erro não capturado acontece quando um erro é lançado fora de qualquer try..catch ou quando um objeto ErrorEvent é despachado sem ouvintes registrados.

Esta propriedade é criada após o carregamento do SWF associado a este objeto. Até lá, a propriedade uncaughtErrorEvents é null. Em um projeto somente para ActionScript, você pode acessar esta propriedade durante ou depois da execução da função do construtor da classe principal no arquivo SWF.

Acessar esta propriedade ProLoader em um player que não ofereça suporte para ela reaulta em erro. Retorna um objeto EventDispatcher em vez de um objeto UncaughtErrorEvents para evitar gerar erros em players sem suporte.

Elementos da API relacionados

Cria um objeto ProLoader que pode ser usado para carregar arquivos, como SWF, JPEG, GIF ou PNG. Chame o método load() para carregar o ativo como subordinado da instância de ProLoader. Você pode então adicionar o objeto ProLoader à lista de exibição (por exemplo, usando o método addChild() de uma instância de DisplayObjectContainer). O ativo é exibido no palco quando carregado.

Também é possível usar uma ocorrência de ProLoader "fora da lista", ou seja, sem adicioná-la ao contêiner de objetos de exibição na lista de exibição. Nesse modo, a ocorrência de Loader pode ser usada para carregar um arquivo SWF que contenha módulos adicionais de um aplicativo.

Para detectar quando o arquivo SWF terminar de ser carregado, você pode usar os eventos do objeto ProLoaderInfo associado à propriedade contentLoaderInfo do objeto ProLoader. Nesse ponto, o código no módulo do arquivo SWF pode ser executado para inicializar e iniciar o módulo. Nesse modo fora de linha, a ocorrência de ProLoader também pode ser usada para carregar um arquivo SWF que contenha componentes ou recursos de mídia. Mais uma vez, você pode usar as notificações de evento do objeto ProLoaderInfo para detectar quando os componentes terminam de ser carregados. Nesse ponto, o aplicativo pode começar a usar os componentes e os recursos de mídia na biblioteca do arquivo SWF, instanciando as classes do ActionScript 3.0 que representam esses componentes e recursos.

Para determinar o status de um objeto ProLoader, monitore os eventos a seguir do objeto ProLoaderInfo associado à propriedade contentLoaderInfo do objeto ProLoader:

• O evento open é despachado quando o carregamento é iniciado.
• O evento ioError ou securityError será despachado se o arquivo não puder ser carregado ou se um erro tiver ocorrido durante o processo de carregamento.
• O evento progress é acionado continuamente enquanto o arquivo está sendo carregado.
• O evento complete é despachado quando um arquivo termina de ser baixado, mas antes de os métodos e as propriedades do clipe de filme carregado estarem disponíveis. Se o Arquivo SWF carregado usar o pré-carregamento de RSL, este evento é despachado depois que o pré-carregamento de RSL conclui. Neste ponto, o verdadeiro conteúdo é disponível no content propriedade.
• O evento init será despachado depois que as propriedades e os métodos do arquivo SWF carregado estiverem acessíveis, para que você possa começar a manipular o arquivo SWF carregado. Esse evento é despachado antes do manipulador complete. Em arquivos SWF de fluxo, o evento init pode ocorrer significativamente antes do evento complete. Para a maioria das finalidades, use o manipulador init. Se o Arquivo SWF carregado usar o pré-carregamento de RSL, este evento é despachado depois que o pré-carregamento de RSL conclui. Neste ponto, o verdadeiro conteúdo é disponível no content propriedade.

Elementos da API relacionados

Cancela a operação do método load() que está atualmente em andamento para a ocorrência ProLoader.

Carrega um arquivo SWF, JPEG, JPEG progressivo, GIF não animado ou PNG em um objeto que é filho do objeto ProLoader. Se você carregar um arquivo GIF animado, apenas o primeiro quadro será exibido. Como o objeto ProLoader pode conter apenas um único filho, emitir uma solicitação load() subsequente terminará a solicitação anterior, se esta ainda estiver pendente, e começará um novo carregamento.

Observação: No AIR 1.5 e no Flash Player 10, o tamanho máximo de uma imagem carregada é de 8.191 pixels de largura ou de altura, e o número total de pixels não pode exceder 16.777.215 pixels. (Dessa forma, caso uma imagem carregada tenha 8.191 pixels de largura, ela só pode ter 2.048 pixels de altura.) No Flash Player 9 e anteriores e no AIR 1.1 e anteriores, a limitação é de 2.880 pixels de altura e de 2.880 pixels de largura.

Um arquivo SWF ou uma imagem carregada em um objeto ProLoader herda as propriedades de posição, giro e escala dos objetos de exibição-pai desse objeto ProLoader.

Use o método unload() para remover filmes ou imagens carregados com esse método ou para cancelar uma operação de carregamento em progresso.

Você pode impedir o arquivo SWF de usar esse método configurando o parâmetro allowNetworking das marcas object e embed na página HTML com o conteúdo SWF.

Ao usar esse método, considere o modelo de segurança do Flash Player, explicado na descrição da classe ProLoader.

No Flash Player 10 e posterior, se você usar um Content-Type de partes múltiplas (por exemplo, "multipart/form-data") que contém um upload (indicado por um parâmetro "filename" no cabeçalho "content-disposition" do corpo POST), a operação POST ficará sujeita às regras de segurança aplicadas a uploads:

• A operação POST deverá ser executada em resposta a uma ação iniciada pelo usuário, por exemplo, clique de mouse ou pressionamento de tecla.
• Se a operação POST for entre domínios (se o destino de POST não estiver no mesmo servidor do arquivo SWF que está enviando a solicitação POST), o servidor de destino deverá fornecer um arquivo de diretivas de URL que permita o acesso entre domínios.

Além disso, a sintaxe deverá ser válida (de acordo com o padrão RFC2046) para qualquer Content-Type de partes múltiplas. Se a sintaxe for inválida, a operação POST ficará sujeita às regras de segurança aplicadas a uploads.

Para obter mais informações relacionadas à segurança, consulte o tópico do Centro dos desenvolvedores do Flash Player Security.

Parâmetros

Elementos da API relacionados

Carrega de dados binários armazenados em um objeto ByteArray.

O método loadBytes() é assíncrono. Você deve esperar pelo evento "init" antes de acessar as propriedades de um objeto carregado.

Ao usar esse método, considere o modelo de segurança do Flash Player, explicado na descrição da classe ProLoader.

Parâmetros

Elementos da API relacionados

Carrega uma instância IFilePromise pelo promise parâmetro. O tipo do promise o parâmetro usa a superclasse de Objeto em vez de IFilePromise para evitar erros em outros playeres.

O método loadFilePromise pega um objeto IFilePromise e carrega os dados binários. Se os dados forem um fluxo progressivo, como a espera de um vídeo pelo "init" ou por eventos progress antes de acessar as propriedades do objeto carregado. Caso contrário, aguarde o evento completo para certificar-se de que os dados foram totalmente carregados.

Ao usar esse método, considere o modelo de segurança do Flash Player, explicado na descrição da classe ProLoader.

Parâmetros

Elementos da API relacionados

Remove um filho deste objeto ProLoader que foi carregado com o uso do método load(). A propriedade do objeto ProLoaderInfo associado é redefinida como null. O filho não é necessariamente destruído, uma vez que outros objetos podem ter referências a ele; entretanto, ele deixa de ser um filho do objeto ProLoader.

Como prática recomendada, antes de descarregar um arquivo SWF-filho, convém fechar explicitamente todos os fluxos nos objetos desse arquivo SWF-filho, como objetos LocalConnection, NetConnection, NetStream e Sound. Caso contrário, o áudio no arquivo SWF-filho poderá continuar a ser reproduzido, mesmo que esse arquivo SWF-filho tenha sido descarregado. Para encerrar fluxos no arquivo SWF-filho, adicione um ouvinte de evento ao filho que atende o evento unload. Quando o pai chamar ProLoader.unload(), o evento unload será despachado para o filho. O código a seguir mostra como fazer isso:

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

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

Elementos da API relacionados