| Pacchetto | flash.media |
| Classe | public class AVURLLoader |
| Ereditarietà | AVURLLoader  URLLoader EventDispatcher Object |
| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Un oggetto URLLoader scarica tutti i dati da un URL prima di renderli disponibili per il codice nelle applicazioni. Invia delle notifiche relative all'avanzamento dello scaricamento, che è possibile monitorare mediante le proprietà bytesLoaded e bytesTotal, oltre che mediante gli eventi inviati.
Quando vengono caricati file video molto grandi, ad esempio file FLV, è possibile che vengano visualizzati errori di esaurimento della memoria.
Quando utilizzate questa classe in Flash Player e nel contenuto dell'applicazione AIR nelle funzioni di sicurezza sandbox diverse dalla funzione di sicurezza dell'applicazione, considerate il modello di sicurezza seguente:
- Un file SWF che si trova nella sandbox locale con file system potrebbe non caricare dati da o fornire dati a una risorsa presente nella sandbox di rete.
- Per impostazione predefinita, il file SWF chiamante e l'URL da caricare devono trovarsi esattamente nello stesso dominio. Ad esempio, un file SWF sul sito www.adobe.com può caricare i dati solo dalle origini presenti in www.adobe.com. Per caricare dati da un dominio diverso, collocate un file dei criteri degli URL sul server sul quale si trovano i dati.
Per ulteriori informazioni sulla sicurezza, vedete l'argomento sulla sicurezza nel Centro per sviluppatori di Flash Player .
Elementi API correlati
Nascondi proprietà pubbliche ereditate
Mostra proprietà pubbliche ereditate| Proprietà | Definito da | ||
|---|---|---|---|
 | bytesLoaded : uint = 0
Indica il numero di byte che sono stati caricati fino a quel momento durante l'operazione di caricamento. | URLLoader | |
| bytesTotal : uint = 0
Indica il numero totale di byte dei dati scaricati. | URLLoader | |
| constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | |
| cookieHeader : String [sola scrittura] | AVURLLoader | ||
| data : *
I dati ricevuti dall'operazione di caricamento. | URLLoader | |
| dataFormat : String = "text"
Controlla se i dati scaricati vengono ricevuti sotto forma di testo (URLLoaderDataFormat.TEXT), dati binari originari (URLLoaderDataFormat.BINARY) o variabili con codifica URL (URLLoaderDataFormat.VARIABLES). | URLLoader | |
| Metodo | Definito da | ||
|---|---|---|---|
AVURLLoader(request:URLRequest = null)
Crea un oggetto URLLoader. | AVURLLoader | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [override] | AVURLLoader | ||
[override]
Chiude l'operazione di caricamento in corso. | AVURLLoader | ||
|
Invia un evento nel flusso di eventi. | EventDispatcher | |
|
Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento. | EventDispatcher | |
|
Indica se per un oggetto è definita una proprietà specifica. | Object | |
|
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | |
[override]
Invia e carica i dati da un URL specificato. | AVURLLoader | ||
|
Indica se la proprietà specificata esiste ed è enumerabile. | Object | |
|
Rimuove un listener dall'oggetto EventDispatcher. | EventDispatcher | |
|
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | |
|
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | |
|
Restituisce la rappresentazione in formato stringa dell'oggetto specificato. | Object | |
|
Restituisce il valore di base dell'oggetto specificato. | Object | |
|
Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato. | EventDispatcher | |
| Evento | Riepilogo | Definito da | ||
|---|---|---|---|---|
| [evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR ottiene lo stato di attivazione del sistema operativo ed entra nello stato attivo. | EventDispatcher | ||
| Inviato dopo che tutti i dati ricevuti sono stati decodificati e collocati nella proprietà data dell'oggetto URLLoader. | AVURLLoader | |||
| [evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR perde l'attivazione del sistema operativo e sta entrando nello stato inattivo. | EventDispatcher | ||
| Inviato se una chiamata al metodo load() tenta di accedere ai dati via HTTP e Adobe AIR è in grado di rilevare e restituire il codice di stato della richiesta. | AVURLLoader | |||
| Inviato se una chiamata a URLLoader.load() tenta di accedere ai dati via HTTP. | AVURLLoader | |||
| Inviato se una chiamata a URLLoader.load() produce un errore irreversibile che interrompe lo scaricamento. | AVURLLoader | |||
| Inviato quando l'operazione di scaricamento inizia in seguito a una chiamata al metodo URLLoader.load(). | AVURLLoader | |||
| Inviato quando vengono ricevuti i dati mentre è in corso l'operazione di scaricamento. | AVURLLoader | |||
| Inviato se una chiamata al metodo URLLoader.load() tenta di caricare dati da un server al di fuori della funzione di sicurezza sandbox. | AVURLLoader | |||
cookieHeader | proprietà |
AVURLLoader | () | Funzione di costruzione |
public function AVURLLoader(request:URLRequest = null)| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Crea un oggetto URLLoader.
Parametrirequest:URLRequest (default = null)load).
|
Elementi API correlati
addEventListener | () | metodo |
override public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):voidParametri
type:String | |
listener:Function | |
useCapture:Boolean (default = false) | |
priority:int (default = 0) | |
useWeakReference:Boolean (default = false) |
close | () | metodo |
override public function close():void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Chiude l'operazione di caricamento in corso. Tutte le operazioni di caricamento in corso vengono immediatamente terminate. Se al momento non è in corso lo streaming di un URL, viene generato un errore di streaming non valido.
load | () | metodo |
override public function load(request:URLRequest):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Invia e carica i dati da un URL specificato. I dati possono essere ricevuti sotto forma di testo, dati binari originari o variabili con codifica URL, a seconda del valore che è stato impostato per la proprietà dataFormat. Il valore predefinito per la proprietà dataFormat è text. Per inviare dati all'URL specificato, è possibile impostare la proprietà data nell'oggetto URLRequest.
Nota: se un file caricato contiene caratteri non ASCII come in molte lingue diverse dall'inglese, si consiglia di salvare il file con una codifica UTF-8 o UTF-16, in contrapposizione a un formato non codificato con Unicode come ASCII.
Un file SWF che si trova nella sandbox locale con file system potrebbe non caricare dati da o fornire dati a una risorsa presente nella sandbox di rete.
Per impostazione predefinita, il file SWF chiamante e l'URL da caricare devono trovarsi esattamente nello stesso dominio. Ad esempio, un file SWF sul sito www.adobe.com può caricare i dati solo dalle origini presenti in www.adobe.com. Per caricare dati da un dominio diverso, collocate un file dei criteri degli URL sul server sul quale si trovano i dati.
Non potete collegarvi alle porte comunemente riservate. Per un elenco completo di porte bloccate, vedete "Limitazioni delle API di connettività di rete" nella Guida per gli sviluppatori di ActionScript 3.0.
In Flash Player 10 e versioni successive, se utilizzate un Content-Type multipart (ad esempio "multipart/form-data") che contiene un caricamento (indicato da un parametro "filename" in un'intestazione "content-disposition" nel corpo POST), l'operazione POST è soggetta alle regole di sicurezza applicate ai caricamenti:
- L'operazione POST deve essere eseguita come risposta a un'azione compiuta dall'utente, come un clic del mouse o la pressione di un tasto.
- Se l'operazione POST è tra più domini (il target POST non si trova sullo stesso server del file SWF che invia la richiesta POST), il server di destinazione deve fornire un file di criteri URL che consenta l'accesso tra più domini.
Inoltre, per qualsiasi Content-Type multipart, la sintassi deve essere valida (in conformità agli standard RFC2046). Se la sintassi non è valida, l'operazione POST è soggetta alle regole di sicurezza applicate ai caricamenti.
Per ulteriori informazioni sulla sicurezza, vedete l'argomento sulla sicurezza nel Centro per sviluppatori di Flash Player .
Parametri
request:URLRequest — Un oggetto URLRequest che specifica l'URL da scaricare.
|
Eventi
complete: — Inviato dopo che i dati sono stati caricati correttamente.
| |
httpStatus: — Se l'accesso avviene via HTTP e l'ambiente Flash Player corrente supporta l'ottenimento di codici di stato, è possibile ricevere questi eventi in aggiunta agli eventi complete o error.
| |
ioError: — Impossibile completare l'operazione di caricamento.
| |
progress: — Inviato quando vengono ricevuti i dati mentre è in corso l'operazione di scaricamento.
| |
securityError: — Un'operazione di caricamento ha tentato di recuperare dati da un server che si trova al di fuori della funzione di sicurezza sandbox del chiamante. Questo inconveniente può essere risolto utilizzando un file dei criteri sul server.
| |
securityError: — Un'operazione di caricamento ha tentato di caricare un file SWZ (un componente della piattaforma Adobe), ma il certificato non è valido o l'oggetto digest non corrisponde al componente.
| |
open: — Inviato quando inizia un'operazione di caricamento.
| |
httpResponseStatus: — Inviato se una chiamata al metodo load() tenta di accedere ai dati via HTTP e Adobe AIR è in grado di rilevare e restituire il codice di stato della richiesta.
|
Genera
ArgumentError — Gli oggetti URLRequest.requestHeader potrebbero non contenere determinate intestazioni di richiesta HTTP proibite. Per ulteriori informazioni, vedete la descrizione della classe URLRequestHeader.
| |
MemoryError — Questo errore può verificarsi per i seguenti motivi: 1) Flash Player o AIR non è in grado di convertire il parametro URLRequest.data da UTF8 a MBCS. Questo errore è applicabile se l'oggetto URLRequest passato a load() è impostato per eseguire un'operazione GET e se System.useCodePage è impostato su true. 2) Flash Player o AIR non è in grado di allocare memoria per i dati POST. Questo errore è applicabile se l'oggetto URLRequest passato a load è impostato per eseguire un'operazione POST.
| |
SecurityError — I file non attendibili locali potrebbero non essere in grado di comunicare con Internet. Questo inconveniente può essere risolto riclassificando il file come file locale con utilizzo in rete o come attendibile.
| |
SecurityError — State tentando di collegarvi a una porta comunemente riservata. Per un elenco completo di porte bloccate, vedete "Limitazioni delle API di connettività di rete" nella Guida per gli sviluppatori di ActionScript 3.0.
| |
TypeError — Il valore del parametro request o della proprietà URLRequest.url dell'oggetto URLRequest passato è null.
|
Elementi API correlati
URLRequest.requestHeaders
URLRequest.data
URLRequest.digest
complete | Evento |
flash.events.Eventproprietà Event.type =
flash.events.Event.COMPLETE| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Inviato dopo che tutti i dati ricevuti sono stati decodificati e collocati nella proprietà data dell'oggetto URLLoader. È possibile accedere ai dati ricevuti solo quando questo evento è stato inviato.
La costanteEvent.COMPLETE definisce il valore della proprietà type di un oggetto evento complete.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'oggetto di rete che ha completato il caricamento. |
Elementi API correlati
httpResponseStatus | Evento |
flash.events.HTTPStatusEventproprietà HTTPStatusEvent.type =
flash.events.HTTPStatusEvent.HTTP_RESPONSE_STATUS| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, AIR 1.0, Flash Lite 4 |
Inviato se una chiamata al metodo load() tenta di accedere ai dati via HTTP e Adobe AIR è in grado di rilevare e restituire il codice di stato della richiesta.
A differenza dell'eventohttpStatus, l'evento httpResponseStatus viene inviato prima dei dati di risposta. Inoltre, l'evento httpResponseStatus include valori per le proprietà responseHeaders e responseURL (che non sono definite per un evento httpStatus). L'evento httpResponseStatus (se presente) viene inviato prima di (e in aggiunta a) qualsiasi evento complete o error.
La costante HTTPStatusEvent.HTTP_RESPONSE_STATUS definisce il valore della proprietà type di un oggetto evento httpResponseStatus.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
responseURL | L'URL da cui è stata restituita la risposta. |
responseHeaders | Le intestazioni di risposta che la risposta ha restituito, come un array di oggetti URLRequestHeader. |
status | Il codice di stato HTTP restituito dal server. |
redirected | Se la risposta è il risultato di un reindirizzamento. |
target | L'oggetto di rete che riceve un codice di stato HTTP. |
Elementi API correlati
httpStatus | Evento |
flash.events.HTTPStatusEventproprietà HTTPStatusEvent.type =
flash.events.HTTPStatusEvent.HTTP_STATUS| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Inviato se una chiamata a URLLoader.load() tenta di accedere ai dati via HTTP. Per il contenuto in esecuzione in Flash Player, questo evento viene inviato solo se l'ambiente Flash Player corrente è in grado di rilevare e restituire il codice di stato per la richiesta. (Alcuni ambienti browser potrebbero non essere in grado di fornire queste informazioni). L'evento httpStatus (se presente) viene inviato prima di (e in aggiunta a) qualsiasi evento complete o error.
HTTPStatusEvent.HTTP_STATUS definisce il valore della proprietà type di un oggetto evento httpStatus.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
status | Il codice di stato HTTP restituito dal server. |
target | L'oggetto di rete che riceve un codice di stato HTTP. |
Elementi API correlati
ioError | Evento |
flash.events.IOErrorEventproprietà IOErrorEvent.type =
flash.events.IOErrorEvent.IO_ERROR| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Inviato se una chiamata a URLLoader.load() produce un errore irreversibile che interrompe lo scaricamento.
Definisce il valore della proprietàtype di un oggetto evento ioError.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
errorID | Un numero di riferimento associato all'errore specifico (solo AIR). |
target | L'oggetto di rete interessato dall'errore di input/output. |
text | Testo da visualizzare come messaggio di errore. |
Elementi API correlati
open | Evento |
flash.events.Eventproprietà Event.type =
flash.events.Event.OPEN| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Inviato quando l'operazione di scaricamento inizia in seguito a una chiamata al metodo URLLoader.load().
Event.OPEN definisce il valore della proprietà type di un oggetto evento open.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'oggetto di rete che ha aperto una connessione. |
Elementi API correlati
progress | Evento |
flash.events.ProgressEventproprietà ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Inviato quando vengono ricevuti i dati mentre è in corso l'operazione di scaricamento.
Con un oggetto URLLoader non è possibile accedere ai dati fino a quando i dati non sono stati completamente ricevuti. Pertanto, l'evento di avanzamento funge solo da notifica dell'avanzamento dello scaricamento. Per accedere ai dati prima di averli completamente scaricati, utilizzate un oggetto AVURLStream.
Definisce il valore della proprietàtype di un oggetto evento progress.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
bytesLoaded | Il numero di elementi o di byte caricati nel momento in cui il listener elabora l'evento. |
bytesTotal | Il numero totale di elementi o byte che vengono caricati se il processo di caricamento viene completato correttamente. |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'oggetto che riporta l'avanzamento. |
Elementi API correlati
securityError | Evento |
flash.events.SecurityErrorEventproprietà SecurityErrorEvent.type =
flash.events.SecurityErrorEvent.SECURITY_ERROR| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Inviato se una chiamata al metodo URLLoader.load() tenta di caricare dati da un server al di fuori della funzione di sicurezza sandbox. Inviato anche se una chiamata a URLLoader.load() tenta di caricare un file SWZ e il certificato non è valido o la stringa digest non corrisponde al componente.
SecurityErrorEvent.SECURITY_ERROR definisce il valore della proprietà type di un oggetto evento securityError.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'oggetto di rete che riporta l'errore di sicurezza. |
text | Testo da visualizzare come messaggio di errore. |
Elementi API correlati
Tue Jun 12 2018, 02:44 PM Z