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 |
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
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é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 | ||
[substituir]
Encerra a operação de carregamento em andamento. | AVURLLoader | ||
Envia um evento para o fluxo de eventos. | EventDispatcher | ||
Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento. | EventDispatcher | ||
Indica se um objeto tem uma propriedade especificada definida. | Object | ||
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | ||
[substituir]
Envia e carrega dados da URL especificada. | AVURLLoader | ||
Indica se a propriedade especificada existe e é enumerável. | Object | ||
Remove um ouvinte do objeto EventDispatcher. | EventDispatcher | ||
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | ||
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | ||
Retorna a representação de string do objeto especificado. | Object | ||
Retorna o valor primitivo do objeto especificado. | Object | ||
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 |
Evento | Resumo | Definido por | ||
---|---|---|---|---|
[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 | |||
Despachado depois que todos os dados recebidos são decodificados e inseridos na propriedade "data" do objeto URLLoader. | AVURLLoader | |||
[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 | |||
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 | |||
Despachado se uma chamada ao URLLoader.load() tentar acessar os dados via HTTP. | AVURLLoader | |||
Despachado se uma chamada para URLLoader.load() resultar em um erro fatal que finaliza o download. | AVURLLoader | |||
Despachado quando a operação de download é iniciada após uma chamada para o método URLLoader.load(). | AVURLLoader | |||
Despachado quando os dados são recebidos ao longo do progresso da operação de download. | AVURLLoader | |||
Despachado se uma chamada para URLLoader.load() tentar carregar dados de um servidor fora da área de segurança. | AVURLLoader |
cookieHeader | propriedade |
AVURLLoader | () | 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âmetrosrequest: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
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: — Despachado depois que os dados forem carregados com êxito.
| |
httpStatus: — 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: — Não foi possível concluir a operação de carregamento.
| |
progress: — Despachado quando os dados são recebidos ao longo do progresso da operação de download.
| |
securityError: — 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: — 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: — Despachado quando uma operação de carregamento é iniciada.
| |
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.
|
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
URLRequest.requestHeaders
URLRequest.data
URLRequest.digest
complete | 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 constanteEvent.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
httpResponseStatus | 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 eventohttpStatus
, 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
httpStatus | 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
.
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
ioError | 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 propriedadetype
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
open | 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()
.
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
progress | 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 propriedadetype
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
securityError | 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.
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
Wed Jun 13 2018, 11:10 AM Z