AVURLStream - Referência da API Adobe ActionScript® 3 (AS3 )

Pacote	flash.media
Classe	public class AVURLStream
Herança	AVURLStream URLStream EventDispatcher Object

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

A classe URLStream fornece acesso de baixo nível a URLs de download. Os dados são disponibilizados ao código de aplicativo logo depois de serem baixados, em vez de aguardarem a conclusão do arquivo inteiro, como no caso de URLLoader. A classe URLStream também permite encerrar um fluxo antes que o seu download seja finalizado. O conteúdo do arquivo baixado é disponibilizado como dados binários brutos.

As operações de leitura em URLStream são do tipo sem bloqueio. Isso significa que você deve usar a propriedade bytesAvailable para determinar se há dados suficientes disponíveis antes da leitura. Uma exceção EOFError será lançada se não houver dados suficientes disponíveis.

Todos os dados binários são codificados por padrão no formato big-endian, com o byte mais significativo primeiro.

As regras de segurança que se aplicam ao download de URLs com a classe URLStream são idênticas às aplicadas a objetos URLLoader. Arquivos de diretivas podem ser baixados conforme necessário. Regras de segurança de arquivos locais são impostas e avisos de segurança são apresentados conforme necessário.

Elementos da API relacionados

URLLoader
URLRequest

Propriedades públicas

Ocultar propriedades públicas herdadas

Mostrar propriedades públicas herdadas

	Propriedade		Definido por
		bytesAvailable : uint [somente leitura] Retorna o número de bytes de dados disponíveis para leitura no buffer de entrada.	URLStream
		connected : Boolean [somente leitura] Indica se este objeto URLStream está conectado no momento.	URLStream
		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]	AVURLStream
		endian : String Indica a ordem de byte para os dados.	URLStream
		objectEncoding : uint Controla a versão do AMF (Action Message Format) usada ao gravar ou ler um objeto.	URLStream

Métodos públicos

Ocultar métodos públicos herdados

Mostrar métodos públicos herdados

	Método		Definido por
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento.	EventDispatcher
		close():void Encerra o fluxo imediatamente e cancela a operação de download.	URLStream
		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] Inicia o download da URL especificada no parâmetro de solicitação.	AVURLStream
		propertyIsEnumerable(name:String):Boolean Indica se a propriedade especificada existe e é enumerável.	Object
		readBoolean():Boolean Lê um valor booliano do fluxo.	URLStream
		readByte():int Lê um byte com sinal do fluxo.	URLStream
		readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void Lê bytes de comprimento de dados do fluxo.	URLStream
		readDouble():Number Lê do fluxo um número de ponto flutuante de precisão dupla IEEE 754.	URLStream
		readFloat():Number Lê do fluxo um número de ponto flutuante de precisão única IEEE 754.	URLStream
		readInt():int Lê um inteiro de 32 bits com sinal do fluxo.	URLStream
		readMultiByte(length:uint, charSet:String):String Lê uma string de vários bytes de comprimento especificado, do fluxo de bytes, usando o conjunto de caracteres especificado.	URLStream
		readObject():* Lê um objeto a partir do soquete, codificado em AMF (Action Message Format).	URLStream
		readShort():int Lê um inteiro de 16 bits com sinal do fluxo.	URLStream
		readUnsignedByte():uint Lê um byte sem sinal do fluxo.	URLStream
		readUnsignedInt():uint Lê um inteiro de 32 bits sem sinal do fluxo.	URLStream
		readUnsignedShort():uint Lê um inteiro de 16 bits sem sinal do fluxo.	URLStream
		readUTF():String Lê uma string UTF-8 do fluxo.	URLStream
		readUTFBytes(length:uint):String Lê uma sequência de bytes UTF-8 de comprimento a partir do fluxo e retorna uma string.	URLStream
		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 quando os dados foram carregados com êxito.	URLStream
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 URLStream.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.	URLStream
httpStatus	Despachado se uma chamada para URLStream.load() tentar acessar dados via HTTP, e o Flash Player ou o Adobe AIR for capaz de detectar e retornar o código de status da solicitação.	URLStream
ioError	Despachado quando ocorre um erro de entrada/saída que resulta na falha de uma operação de carregamento.	URLStream
open	Despachado quando uma operação de carregamento é iniciada.	URLStream
progress	Despachado quando os dados são recebidos ao longo do progresso da operação de download.	URLStream
securityError	Despachado se uma chamada para URLStream.load() tentar carregar dados de um servidor fora da área de segurança.	URLStream

Detalhes da propriedade

cookieHeader

propriedade

cookieHeader:String [somente gravação]

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

Detalhes do método

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

Inicia o download da URL especificada no parâmetro solicitação.

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.

Se a operação de carregamento falhar imediatamente, uma exceção IOError ou SecurityError (incluindo o erro de segurança de arquivo local) será lançada com uma descrição da falha. Caso contrário, um evento open será despachado se o download da URL for iniciado com êxito. ou um evento "erro" será despachado se um erro ocorrer.

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.

No Flash Player, você não pode 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, é possível impedir que um arquivo SWF use esse método, definindo o parâmetro allowNetworking das marcas object e embed na página HTML que tem o conteúdo SWF.

No Flash Player 10 e posterior, além do AIR 1.5 e posterior, caso você use um multipart Content-Type (por exemplo, "multipart/form-data") que contenha um carregamento (indicado por um parâmetro "filename" em um cabeçalho "content-disposition" dentro do corpo POST), a operação POST está sujeita a regras de segurança aplicadas a carregamentos:

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.

Essas regras também se aplicam ao conteúdo do AIR nas caixas de proteção de segurança do aplicativo. Contudo, no Adobe AIR, o conteúdo na área de segurança application (conteúdo instalado com o Adobe AIR) não é restringido por essas limitações de segurança.

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

No AIR, um objeto URLRequest pode se registrar no evento de status httpResponse. 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.

Caso haja um ouvinte de evento httpResponseStatus, o corpo da mensagem de resposta é sempre despachado; e as respostas do código de status HTTP sempre resultam em um evento complete. Isso é verdadeiro, independentemente do código de status da resposta HTTP indicar um êxito ou um erro.

No AIR, caso não haja nenhumouvinte de evento httpResponseStatus, o comportamento será diferente, com base na versão do SWF:

Para o conteúdo do SWF 9, o corpo da mensagem de resposta HTTP é despachado somente se o código de status de resposta HTTP indica êxito. Do contrário (caso haja um erro), nenhum corpo é despachado e o objeto URLRequest despacha um evento IOE.
Para o conteúdo do SWF 10, o corpo da mensagem de resposta HTTP é sempre despachado. Caso haja um erro, o objeto URLRequest despacha um evento IOError.

Parâmetros

request:URLRequest — Um objeto URLRequest especificando a URL para download. Se o valor desse parâmetro ou da propriedade URLRequest.url do objeto URLRequest transmitido for null, o aplicativo lançará um erro de ponteiro nulo.

Eventos

	`complete:Event` — Despachado depois que os dados forem carregados com êxito. Caso haja um ouvinte de evento `httpResponseStatus`, o objeto URLRequest também despacha um evento `complete` independentemente de o código de status da resposta HTTP indicar êxito ou erro.

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

	`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.

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

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

	`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.

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: 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`. 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 para carregamento estiver definido de modo a realizar uma operação `POST`.

	`SecurityError` — Os arquivos SWF locais não confiáveis não podem se comunicar com a Internet. Isso pode ser evitado reclassificando esse arquivo SWF 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.

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

AVURLStream - AS3

Pacotesx

Elementos de linguagem

Apêndices

Pacote flash.media

cookieHeader

load