AVURLLoader

Pacote	flash.media
Classe	public class AVURLLoader
Herança	AVURLLoader URLLoader EventDispatcher Object

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

A classe URLLoader baixa dados de uma URL como texto, dados binários ou variáveis codificadas em URL. Ela é útil para o download de arquivos de texto, XML ou outras informações a serem usadas em um aplicativo dinâmico com base em dados.

Um objeto URLLoader baixa todos os dados de uma URL antes de torná-los disponíveis para o código nos aplicativos. Ele envia notificações sobre o progresso do download, que você pode monitorar por meio das propriedades bytesLoaded e bytesTotal, bem como por meio de eventos despachados.

Ao carregar arquivos de vídeo muito grandes, como os FLVs, podem ocorrer erros de insuficiência de memória.

Ao usar essa classe no conteúdo nas caixas de proteção de segurança do Flash Player e do Adobe AIR em outra área de segurança, considere os seguinte modelo de segurança:

Um arquivo SWF da caixa de proteção local com sistema de arquivos não pode carregar dados de um recurso que está na caixa de proteção da rede nem fornecer dados para ele.
Por padrão, a URL e o arquivo SWF da chamada que você carrega precisam estar exatamente no mesmo domínio. Por exemplo, um arquivo SWF em www.adobe.com pode carregar dados apenas de fontes que também estejam em www.adobe.com. Para carregar dados de outro domínio, coloque um arquivo de diretivas de URL no servidor que está hospedando os dados.

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

Elementos da API relacionados

URLRequest
URLVariables
AVURLStream

Propriedades públicas

Ocultar propriedades públicas herdadas

Mostrar propriedades públicas herdadas

	Propriedade		Definido por
		bytesLoaded : uint = 0 Indica o número de bytes que foram carregados até agora durante a operação de carregamento.	URLLoader
		bytesTotal : uint = 0 Indica o número total de bytes nos dados baixados.	URLLoader
		constructor : Object Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto.	Object
		cookieHeader : String [somente gravação]	AVURLLoader
		data : * Os dados recebidos da operação de carregamento.	URLLoader
		dataFormat : String = "text" Controla se os dados baixados são recebidos como texto (URLLoaderDataFormat.TEXT), dados binários brutos (URLLoaderDataFormat.BINARY) ou variáveis codificadas em URL (URLLoaderDataFormat.VARIABLES).	URLLoader

Métodos públicos

Ocultar métodos públicos herdados

Mostrar métodos públicos herdados

	Método		Definido por
		AVURLLoader(request:URLRequest = null) Cria um objeto URLLoader.	AVURLLoader
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [substituir]	AVURLLoader
		close():void [substituir] Encerra a operação de carregamento em andamento.	AVURLLoader
		dispatchEvent(event:Event):Boolean Envia um evento para o fluxo de eventos.	EventDispatcher
		hasEventListener(type:String):Boolean Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indica se um objeto tem uma propriedade especificada definida.	Object
		isPrototypeOf(theClass:Object):Boolean Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro.	Object
		load(request:URLRequest):void [substituir] Envia e carrega dados da URL especificada.	AVURLLoader
		propertyIsEnumerable(name:String):Boolean Indica se a propriedade especificada existe e é enumerável.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Remove um ouvinte do objeto EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Define a disponibilidade de uma propriedade dinâmica para operações de repetição.	Object
		toLocaleString():String Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade.	Object
		toString():String Retorna a representação de string do objeto especificado.	Object
		valueOf():Object Retorna o valor primitivo do objeto especificado.	Object
		willTrigger(type:String):Boolean Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado.	EventDispatcher

Eventos

Clique para obter mais informações sobre eventos

Ocultar eventos herdados

Mostrar eventos herdados

	Resumo	Definido por
activate	[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR ganha o foco do sistema operacional e está se tornando inativo.	EventDispatcher
complete	Despachado depois que todos os dados recebidos são decodificados e inseridos na propriedade "data" do objeto URLLoader.	AVURLLoader
deactivate	[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR perde o foco do sistema operacional e está se tornando inativo.	EventDispatcher
httpResponseStatus	Despachado se uma chamada para o método load() tentar acessar dados via HTTP e o Adobe AIR atual for capaz de detectar e retornar o código de status da solicitação.	AVURLLoader
httpStatus	Despachado se uma chamada ao URLLoader.load() tentar acessar os dados via HTTP.	AVURLLoader
ioError	Despachado se uma chamada para URLLoader.load() resultar em um erro fatal que finaliza o download.	AVURLLoader
open	Despachado quando a operação de download é iniciada após uma chamada para o método URLLoader.load().	AVURLLoader
progress	Despachado quando os dados são recebidos ao longo do progresso da operação de download.	AVURLLoader
securityError	Despachado se uma chamada para URLLoader.load() tentar carregar dados de um servidor fora da área de segurança.	AVURLLoader

Detalhes da propriedade

cookieHeader

propriedade

cookieHeader:String [somente gravação]

Implementação
public function set cookieHeader(value:String):void

Detalhes do construtor

()

Construtor

public function AVURLLoader(request:URLRequest = null)

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Cria um objeto URLLoader.

Parâmetros

request:URLRequest (default = null) — Um objeto URLRequest especificando a URL para download. Se esse parâmetro for omitido, nenhuma operação de carregamento começará. Se for especificado, a operação de carregamento começará imediatamente (consulte a entrada load para obter mais informações).

Elementos da API relacionados

URLLoader.load()

Detalhes do método

addEventListener

()

método

override public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void

Parâmetros

	`type:String`

	`listener:Function`

	`useCapture:Boolean` (default = `false`)

	`priority:int` (default = `0`)

	`useWeakReference:Boolean` (default = `false`)

close

()

método

override public function close():void

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Encerra a operação de carregamento em andamento. Qualquer operação de carregamento em andamento é imediatamente terminada. Se nenhuma URL estiver sendo enviada por fluxo no momento, um erro de fluxo inválido será lançado.

load

()

método

override public function load(request:URLRequest):void

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Envia e carrega dados da URL especificada. Os dados podem ser recebidos como texto, dados binários brutos ou variáveis codificadas em URL, dependendo do valor definido para a propriedade dataFormat. Observe que o valor padrão da propriedade dataFormat é texto. Se você quiser enviar dados à URL especificada, poderá definir a propriedade data no objeto URLRequest.

Observação: Se um arquivo que está sendo carregado contiver caracteres não ASCII (como é o caso de muitos idiomas que não são o inglês), convém salvar o arquivo com codificação UTF-8 ou UTF-16, em contraste com um formato não Unicode, como ASCII.

Um arquivo SWF da caixa de proteção local com sistema de arquivos não pode carregar dados de um recurso que está na caixa de proteção da rede nem fornecer dados para ele.

Por padrão, a URL e o arquivo SWF da chamada que você carrega precisam estar exatamente no mesmo domínio. Por exemplo, um arquivo SWF em www.adobe.com pode carregar dados apenas de fontes que também estejam em www.adobe.com. Para carregar dados de outro domínio, coloque um arquivo de diretivas de URL no servidor que está hospedando os dados.

Não é possível conectar-se às portas normalmente reservadas. Para ver uma lista completa de portas bloqueadas, consulte "Restrição de APIs de rede" no Guia do Desenvolvedor do ActionScript 3.0.

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 os padrões 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

request:URLRequest — Um objeto URLRequest especificando a URL para download.

Eventos

	`complete:Event` — Despachado depois que os dados forem carregados com êxito.

	`httpStatus:HTTPStatusEvent` — Se o acesso ocorrer via HTTP e o ambiente atual do Flash Player oferecer suporte à obtenção de códigos de status, você poderá receber estes eventos além de qualquer evento `complete` ou `error`.

	`ioError:IOErrorEvent` — Não foi possível concluir a operação de carregamento.

	`progress:ProgressEvent` — Despachado quando os dados são recebidos ao longo do progresso da operação de download.

	`securityError:SecurityErrorEvent` — Uma operação de carregamento tentou recuperar dados de um servidor fora da área de segurança do chamador. Isso pode ser resolvido com o uso de um arquivo de diretivas no servidor.

	`securityError:SecurityErrorEvent` — Uma operação de carregamento tentou carregar um arquivo SWZ (um componente da plataforma Adobe), mas o certificado é inválido ou a compilação não corresponde ao componente.

	`open:Event` — Despachado quando uma operação de carregamento é iniciada.

	`httpResponseStatus:HTTPStatusEvent` — Despachado se uma chamada para o método `load()` tentar acessar dados via HTTP e o Adobe AIR atual for capaz de detectar e retornar o código de status da solicitação.

Lança

	`ArgumentError` — Objetos `URLRequest.requestHeader` não podem conter certos cabeçalhos proibidos de solicitações HTTP. Para obter mais informações, consulte a descrição da classe URLRequestHeader.

	`MemoryError` — Esse erro pode ocorrer pelos seguintes motivos: 1) O Flash Player ou o Adobe AIR não consegue converter o parâmetro `URLRequest.data` de UTF8 em MBCS. Esse erro será aplicável se o objeto URLRequest transmitido a `load()` estiver definido de modo a realizar uma operação `GET` e se `System.useCodePage` estiver definido como `true`. 2) O Flash Player ou o Adobe AIR não consegue alocar memória para os dados `POST`. Esse erro será aplicável se o objeto URLRequest transmitido ao método `load` estiver definido de modo a realizar uma operação `POST`.

	`SecurityError` — Os arquivos locais não confiáveis não podem se comunicar com a Internet. Isso pode ser evitado reclassificando esse arquivo como local com rede ou confiável.

	`SecurityError` — Você está tentando se conectar a uma porta normalmente reservada. Para ver uma lista completa de portas bloqueadas, consulte "Restrição de APIs de rede" no Guia do Desenvolvedor do ActionScript 3.0.

	`TypeError` — O valor do parâmetro de solicitação ou da propriedade `URLRequest.url` do objeto URLRequest transmitido é `null`.

Elementos da API relacionados

URLRequestHeader
URLRequest.requestHeaders
URLRequest.data
URLRequest.digest

Detalhe do evento

complete

Evento

Tipo do objeto de evento: flash.events.Event
propriedade Event.type = flash.events.Event.COMPLETE

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Despachado depois que todos os dados recebidos são decodificados e inseridos na propriedade "data" do objeto URLLoader. Os dados recebidos poderão ser acessados quando esse evento tiver sido despachado.

A constante Event.COMPLETE define o valor da propriedade type de um objeto de evento complete.

Esse evento tem as seguintes propriedades:

Propriedade	Valor
`bubbles`	`false`
`cancelable`	`false`; não há comportamento padrão a ser cancelado.
`currentTarget`	O objeto que está processando ativamente o objeto Event com um ouvinte de evento.
`target`	O objeto de rede que concluiu o carregamento.

Elementos da API relacionados

URLLoader.load()

httpResponseStatus

Evento

Tipo do objeto de evento: flash.events.HTTPStatusEvent
propriedade HTTPStatusEvent.type = flash.events.HTTPStatusEvent.HTTP_RESPONSE_STATUS

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, AIR 1.0, Flash Lite 4

Despachado se uma chamada para o método load() tentar acessar dados via HTTP e o Adobe AIR atual for capaz de detectar e retornar o código de status da solicitação.

Ao contrário do evento httpStatus, o evento httpResponseStatus é entregue antes de qualquer dado de resposta. O evento httpResponseStatus inclui valores para as propriedades responseHeaders e responseURL (que estão indefinidas para um evento httpStatus. Observe que o evento httpResponseStatus (se houver) será despachado antes (e além de) qualquer evento complete ou error.

A constante HTTPStatusEvent.HTTP_RESPONSE_STATUS define o valor da propriedade type de um objeto de evento httpResponseStatus.

Esse evento tem as seguintes propriedades:

Propriedade	Valor
`bubbles`	`false`
`cancelable`	`false`; não há comportamento padrão a ser cancelado.
`currentTarget`	O objeto que está processando ativamente o objeto Event com um ouvinte de evento.
`responseURL`	O URL do qual a resposta foi retornada.
`responseHeaders`	Os cabeçalhos de resposta que a resposta retornou, como uma matriz de objetos URLRequestHeader.
`status`	O código de status HTTP retornado pelo servidor.
`redirecionado`	Se a resposta for o resultado de um redirecionamento.
`target`	O objeto de rede que recebe o código de status HTTP.

Elementos da API relacionados

load()

httpStatus

Evento

Tipo do objeto de evento: flash.events.HTTPStatusEvent
propriedade HTTPStatusEvent.type = flash.events.HTTPStatusEvent.HTTP_STATUS

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Despachado se uma chamada ao URLLoader.load() tentar acessar os dados via HTTP. Para o conteúdo em execução no Flash Player, este evento somente será despachado se o ambiente atual do Flash Player puder detectar e executar o código de status para a solicitação. (Alguns ambientes de navegador podem não ser capazes de fornecer essas informações.) Observe que o evento httpStatus (se houver) será despachado antes (e além de) qualquer evento complete ou error.

A constante HTTPStatusEvent.HTTP_STATUS define o valor da propriedade type de um objeto de evento httpStatus.

Esse evento tem as seguintes propriedades:

Propriedade	Valor
`bubbles`	`false`
`cancelable`	`false`; não há comportamento padrão a ser cancelado.
`currentTarget`	O objeto que está processando ativamente o objeto Event com um ouvinte de evento.
`status`	O código de status HTTP retornado pelo servidor.
`target`	O objeto de rede que recebe o código de status HTTP.

Elementos da API relacionados

URLLoader.load()

ioError

Evento

Tipo do objeto de evento: flash.events.IOErrorEvent
propriedade IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Despachado se uma chamada para URLLoader.load() resultar em um erro fatal que finaliza o download.

Define o valor da propriedade type de um objeto de evento ioError.

Esse evento tem as seguintes propriedades:

Propriedade	Valor
`bubbles`	`false`
`cancelable`	`false`; não há comportamento padrão a ser cancelado.
`currentTarget`	O objeto que está processando ativamente o objeto Event com um ouvinte de evento.
`errorID`	Um número de referência associado ao erro específico (somente AIR).
`target`	O objeto de rede que está recebendo o erro de entrada/saída.
`text`	Texto a ser exibido como uma mensagem de erro.

Elementos da API relacionados

URLLoader.load()

open

Evento

Tipo do objeto de evento: flash.events.Event
propriedade Event.type = flash.events.Event.OPEN

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Despachado quando a operação de download é iniciada após uma chamada para o método URLLoader.load().

A constante Event.OPEN define o valor da propriedade type de um objeto de evento open.

Esse evento tem as seguintes propriedades:

Propriedade	Valor
`bubbles`	`false`
`cancelable`	`false`; não há comportamento padrão a ser cancelado.
`currentTarget`	O objeto que está processando ativamente o objeto Event com um ouvinte de evento.
`target`	O objeto de rede que abriu uma conexão.

Elementos da API relacionados

URLLoader.load()

progress

Evento

Tipo do objeto de evento: flash.events.ProgressEvent
propriedade ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Despachado quando os dados são recebidos ao longo do progresso da operação de download.

Observe que com um objeto URLLoader, não é possível acessar os dados até que eles tenham sido totalmente recebidos. Portanto, o evento "progress" apenas serve como notificação do nível de andamento do download. Para acessar os dados antes que eles sejam totalmente baixados, use um objeto AVURLStream.

Define o valor da propriedade type de um objeto de evento progress.

Esse evento tem as seguintes propriedades:

Propriedade	Valor
`bubbles`	`false`
`bytesLoaded`	O número de itens ou bytes carregados no momento em que o ouvinte processa o evento.
`bytesTotal`	O número total de itens ou bytes que serão carregados no final se o processo de carregamento tiver êxito.
`cancelable`	`false`; não há comportamento padrão a ser cancelado.
`currentTarget`	O objeto que está processando ativamente o objeto Event com um ouvinte de evento.
`target`	O objeto que está informando o andamento.

Elementos da API relacionados

URLLoader.load()

securityError

Evento

Tipo do objeto de evento: flash.events.SecurityErrorEvent
propriedade SecurityErrorEvent.type = flash.events.SecurityErrorEvent.SECURITY_ERROR

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Despachado se uma chamada para URLLoader.load() tentar carregar dados de um servidor fora da área de segurança. Também despachado se uma chamada para URLLoader.load() tentar carregar um arquivo SWZ e o certificado for inválido ou a string de compilação não corresponder ao componente.

A constante SecurityErrorEvent.SECURITY_ERROR define o valor da propriedade type de um objeto de evento securityError.

Esse evento tem as seguintes propriedades:

Propriedade	Valor
`bubbles`	`false`
`cancelable`	`false`; não há comportamento padrão a ser cancelado.
`currentTarget`	O objeto que está processando ativamente o objeto Event com um ouvinte de evento.
`target`	O objeto de rede que reporta o erro de segurança.
`text`	Texto a ser exibido como uma mensagem de erro.

Elementos da API relacionados

URLLoader.load()

Aspectos jurídicos | Política de privacidade on-line

AVURLLoader - AS3

Pacotesx

Elementos de linguagem

Apêndices

Pacote flash.media

cookieHeader

AVURLLoader

addEventListener

close

load

complete

httpResponseStatus

httpStatus

ioError

open

progress

securityError