| Paket | flash.media |
| Klass | public class AVURLLoader |
| Arv | AVURLLoader  URLLoader EventDispatcher Object |
| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ett URLLoader-objekt laddar ned alla data från en URL innan den görs tillgänglig för kod i programmen. Aviseringar om förloppet av nedladdningen skickas ut. Du kan bevaka dem via egenskaperna bytesLoaded och bytesTotal samt även via skickade händelser.
När en mycket stor videofil (som FVL) läses in kan minnesproblem uppstå.
När du använder den här klassen i Flash Player och i AIR-programinnehåll i andra säkerhetssandlådor än programsäkerhetssandlådan, bör du överväga att använda följande säkerhetsmodell:
- En SWF-fil i sandlådan lokal-med-filsystem kan inte hämta data från, eller leverera data till, en resurs som finns i nätverkssandlådan.
- Den anropade SWF-filen och URL:en som du läser in, måste som standard finnas i exakt samma domän. En SWF-fil på www.adobe.com kan till exempel bara läsa in data från källor som också finns på www.adobe.com. Om du vill läsa in data från en annan domän sparar du en URL-principfil på servern där data finns.
Mer information om säkerhet finns i avsnittet Security på Flash Player Developer Center.
Relaterade API-element
Dölj ärvda publika egenskaper
Visa ärvda publika egenskaper| Egenskap | Definieras med | ||
|---|---|---|---|
 | bytesLoaded : uint = 0
Anger antalet byte som har hämtats hittills under inläsningen. | URLLoader | |
| bytesTotal : uint = 0
Anger det totala antalet databyte som laddas ned. | URLLoader | |
| constructor : Object
En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans. | Object | |
| cookieHeader : String [lässkyddad] | AVURLLoader | ||
| data : *
De data som tas emot från inläsningen. | URLLoader | |
| dataFormat : String = "text"
Styr om laddade ned data tas emot som text (URLLoaderDataFormat.TEXT), binära rådata (URLLoaderDataFormat.BINARY) eller URL-kodade variabler (URLLoaderDataFormat.VARIABLES). | URLLoader | |
| Metod | Definieras med | ||
|---|---|---|---|
AVURLLoader(request:URLRequest = null)
Skapar ett URLLoader-objekt. | AVURLLoader | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [åsidosätt] | AVURLLoader | ||
[åsidosätt]
Stänger den pågående inläsningen. | AVURLLoader | ||
|
Skickar en händelse till händelseflödet. | EventDispatcher | |
|
Kontrollerar om EventDispatcher-objektet har några avlyssnare registrerade för en viss typ av händelse. | EventDispatcher | |
|
Anger om det finns en egenskap angiven för ett objekt. | Object | |
|
Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter. | Object | |
[åsidosätt]
Skickar och läser in data från den angivna URL:en. | AVURLLoader | ||
|
Anger om den angivna egenskapen finns och är uppräkningsbar. | Object | |
|
Tar bort en avlyssnare från EventDispatcher-objektet. | EventDispatcher | |
|
Anger tillgänglighet för en dynamisk egenskap för slingåtgärder. | Object | |
|
Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner. | Object | |
|
Returnerar det angivna objektets strängbeteckning. | Object | |
|
Returnerar det angivna objektets primitiva värde. | Object | |
|
Kontrollerar om en händelseavlyssnare är registrerad för det här EventDispatcher-objektet eller något av dess överordnade objekt för den angivna händelsetypen. | EventDispatcher | |
| Händelse | Sammanfattning | Definieras med | ||
|---|---|---|---|---|
| [utsändningshändelse] Skickas när Flash Player eller AIR får operativsystemfokus och blir aktivt. | EventDispatcher | ||
| Skickas när alla mottagna data har avkodats och placerats i egenskapen data i URLLoader-objektet. | AVURLLoader | |||
| [utsändningshändelse] Skickas när Flash Player eller AIR förlorar operativsystemfokus och blir inaktivt. | EventDispatcher | ||
| Skickas om ett anrop till metoden load() försöker få tillgång till data via HTTP och Adobe AIR kan identifiera och returnera statuskoden för begäran. | AVURLLoader | |||
| Skickas när ett anrop till URLLoader.load() försöker komma åt data via HTTP. | AVURLLoader | |||
| Skickas om ett anrop till URLLoader.load() resulterar i ett allvarligt fel som gör att nedladdningen avbryts. | AVURLLoader | |||
| Skickas när nedladdningen påbörjas efter anropet till metoden URLLoader.load(). | AVURLLoader | |||
| Skickas när data tas emot under nedladdningsförloppet. | AVURLLoader | |||
| Skickas när ett anrop till URLLoader.load() försöker läsa in data från en server utanför säkerhetssandlådan. | AVURLLoader | |||
cookieHeader | egenskap |
AVURLLoader | () | Konstruktor |
public function AVURLLoader(request:URLRequest = null)| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Skapar ett URLLoader-objekt.
Parametrarrequest:URLRequest (default = null)load för mer information).
|
Relaterade API-element
addEventListener | () | metod |
override public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):voidParametrar
type:String | |
listener:Function | |
useCapture:Boolean (default = false) | |
priority:int (default = 0) | |
useWeakReference:Boolean (default = false) |
close | () | metod |
override public function close():void| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Stänger den pågående inläsningen. Eventuell pågående inläsning avslutas omedelbart. Om det inte finns någon URL för direktuppspelning utlöser ett fel för ogiltig dataström.
load | () | metod |
override public function load(request:URLRequest):void| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Skickar och läser in data från den angivna URL:en. Alla data kan tas emot som text, binära rådata eller URL-kodade variabler beroende på värdet du anger för egenskapen dataFormat. Observera att standardvärdet för egenskapen dataFormat är text. Om du vill skicka data till angiven URL kan du använda egenskapen data i objektet URLRequest.
Obs!Om en fil som läses in innehåller andra tecken än ASCII-tecken (finns i många icke-engelska språk) rekommenderas att du sparar filen med UTF-8 eller UTF-16-kodning i stället för ett icke-Unicode-format som ASCII.
En SWF-fil i sandlådan lokal-med-filsystem kan inte hämta data från, eller leverera data till, en resurs som finns i nätverkssandlådan.
Den anropade SWF-filen och URL:en som du läser in, måste som standard finnas i exakt samma domän. En SWF-fil på www.adobe.com kan till exempel bara läsa in data från källor som också finns på www.adobe.com. Om du vill läsa in data från en annan domän sparar du en URL-principfil på servern där data finns.
Du kan inte ansluta till vanligtvis reserverade portar. Du hittar en fullständig lista över spärrade portar i avsnittet ”Begränsa nätverks-API:er” i Utvecklarhandbok för Adobe ActionScript 3.0.
Om du i Flash Player 10 eller senare använder en multipart-innehållstyp (till exempel ”multipart/form-data”) som innehåller en överföring (vilket indikeras av en ”filename”-parameter i ett ”content-disposition”-huvud inuti POST), gäller de säkerhetsregler som används för överföringar också för POST-åtgärden.
- POST-åtgärden måste utföras som ett svar på en användarinitierad åtgärd som exempelvis en musklickning eller en tangenttryckning.
- Om POST-åtgärden är för korsdomän (POST-målet ligger inte på samma server som SWF-filen som skickar POST-begäran), måste målservern ha en URL-policyfil som tillåter korsdomänåtkomst.
För en multipart-innehållstyp måste också syntaxen vara giltig (enligt RFC2046-standarderna). Om syntaxen verkar vara ogiltig, gäller samma regler för POST-åtgärden som för överföringar.
Mer information om säkerhet finns i avsnittet Security på Flash Player Developer Center.
Parametrar
request:URLRequest — Ett URLRequest-objekt som anger vilket URL som ska laddas ned.
|
Händelser
complete: — Skickas när alla data är inlästa.
| |
httpStatus: — Om åtkomsten sker via HTTP, och den aktuella Flash Player-miljön stöder hämtning av statuskoder, kan dessa händelser skickas utöver eventuella complete- eller error-händelser.
| |
ioError: — Det gick inte att slutföra inläsningen.
| |
progress: — Skickas när data tas emot under nedladdningsförloppet.
| |
securityError: — En inläsningsåtgärd försökte hämta data från en server utanför anroparens säkerhetssandlåda. Detta kan åtgärdas genom att använda en policyfil på servern.
| |
securityError: — En inläsningsåtgärd försökte läsa in en SWZ-fil (en Adobe-plattformskomponent), men certifikatet är ogiltigt eller så matchar sammanfattningen inte komponenten.
| |
open: — Skickas när en inläsning initieras.
| |
httpResponseStatus: — Skickas om ett anrop till metoden load() försöker komma åt data via HTTP och Adobe AIR kan identifiera och returnera statuskoden för begäran.
|
Utlöser
ArgumentError — Objekten URLRequest.requestHeader får inte innehålla vissa förbjudna rubriker för HTTP-begäran. Mer information finns i beskrivningen av klassen URLRequestHeader.
| |
MemoryError — Detta fel kan bero på följande: 1) Flash Player eller AIR kan inte konvertera parametern URLRequest.data från UTF8 till MBCS. Detta fel uppstår om objektet URLRequest som skickas till load() är inställt för en GET-åtgärd och om System.useCodePage är angivet med true. 2) Flash Player eller AIR kan inte tilldela minne för POST-data. Detta fel uppstår om objektet URLRequest som skickas till load är inställt för en POST-åtgärd.
| |
SecurityError — Lokala otillförlitliga filer kanske inte kan kommunicera med Internet. Du kan lösa problemet genom att klassificera om filen som lokal med nätverkstjänst eller tillförlitlig.
| |
SecurityError — Du försöker ansluta till en vanligtvis reserverad port. Du hittar en fullständig lista över spärrade portar i avsnittet ”Begränsa nätverks-API:er” i Utvecklarhandbok för Adobe ActionScript 3.0.
| |
TypeError — Värdet för begäranparametern eller egenskapen URLRequest.url för objektet URLRequest som skickas är null.
|
Relaterade API-element
URLRequest.requestHeaders
URLRequest.data
URLRequest.digest
complete | Händelse |
flash.events.Eventegenskap Event.type =
flash.events.Event.COMPLETE| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Skickas när alla mottagna data har avkodats och placerats i egenskapen data i URLLoader-objektet. Alla mottagna data är tillgängliga efter att denna händelse har skickats.
Event.COMPLETE-konstanten definierar värdet på type-egenskapen i ett complete-händelseobjekt.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | false |
cancelable | false; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
target | Det nätverksobjekt som har lästs in. |
Relaterade API-element
httpResponseStatus | Händelse |
flash.events.HTTPStatusEventegenskap HTTPStatusEvent.type =
flash.events.HTTPStatusEvent.HTTP_RESPONSE_STATUS| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0, AIR 1.0, Flash Lite 4 |
Skickas om ett anrop till metoden load() försöker få tillgång till data via HTTP och Adobe AIR kan identifiera och returnera statuskoden för begäran.
Till skillnad frånhttpStatus-händelsen levereras httpResponseStatus-händelsen innan eventuella svarsdata. Dessutom inkluderar httpResponseStatus-händelsen värdena för responseHeaders och responseURL-egenskaperna (som är odefinierade i en httpStatus-händelse). Observera att httpResponseStatus-händelsen (om sådan finns) skickas före (och utöver) händelserna complete eller error.
HTTPStatusEvent.HTTP_RESPONSE_STATUS-konstanten definierar värdet på type-egenskapen i ett httpResponseStatus-händelseobjekt.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | false |
cancelable | false; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
responseURL | URL:en som svaret returnerades från. |
responseHeaders | Svarsrubriken som svaret returnerade har en array med URLRequestHeader-objekt. |
status | Den HTTP-statuskod som returneras av servern. |
redirected | Om svaret är resultatet av en omdirigering. |
target | Nätverksobjektet tar emot en HTTP-statuskod. |
Relaterade API-element
httpStatus | Händelse |
flash.events.HTTPStatusEventegenskap HTTPStatusEvent.type =
flash.events.HTTPStatusEvent.HTTP_STATUS| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Skickas när ett anrop till URLLoader.load() försöker komma åt data via HTTP. Den här händelsen skickas endast för innehåll som körs i Flash Player om den aktuella Flash Player-miljön upptäcker och returnerar statuskoden för begäran. (I vissa webbläsarmiljöer kanske den här informationen inte kan returneras.) Observera att eventuell httpStatus-händelse skickas före (och utöver) händelserna complete och error.
HTTPStatusEvent.HTTP_STATUS definierar värdet på type-egenskapen i ett httpStatus-händelseobjekt.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | false |
cancelable | false; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
status | Den HTTP-statuskod som returneras av servern. |
target | Nätverksobjektet tar emot en HTTP-statuskod. |
Relaterade API-element
ioError | Händelse |
flash.events.IOErrorEventegenskap IOErrorEvent.type =
flash.events.IOErrorEvent.IO_ERROR| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Skickas om ett anrop till URLLoader.load() resulterar i ett allvarligt fel som gör att nedladdningen avbryts.
Definierar värdet för ettioError-händelseobjekts type-egenskap.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | false |
cancelable | false; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
errorID | Ett referensnummer som associeras med det specifika felet (enbart AIR). |
target | Objektet är med om ett in-/utdatafel. |
text | Text som visas som felmeddelande. |
Relaterade API-element
open | Händelse |
flash.events.Eventegenskap Event.type =
flash.events.Event.OPEN| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Skickas när nedladdningen påbörjas efter anropet till metoden URLLoader.load().
Event.OPEN-konstanten definierar värdet på type-egenskapen i ett open-händelseobjekt.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | false |
cancelable | false; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
target | Det nätverksobjekt som har öppnat en anslutning. |
Relaterade API-element
progress | Händelse |
flash.events.ProgressEventegenskap ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Skickas när data tas emot under nedladdningsförloppet.
Observera att med objektet URLLoader går det inte att få åtkomst till data förrän allt har tagits emot. Händelseförloppet fungerar som en avisering om hur nedladdningen genomförs. Använd objektet AVURLStream om du behöver komma åt data innan nedladdningen är slutförd.
Definierar värdet för ettprogress-händelseobjekts type-egenskap.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | false |
bytesLoaded | Antalet objekt eller byte som har lästs in när avlyssnaren bearbetar händelsen. |
bytesTotal | Det totala antalet objekt eller byte som kommer att ha lästs in om inläsningen lyckas. |
cancelable | false; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
target | Objektet rapporterar förlopp. |
Relaterade API-element
securityError | Händelse |
flash.events.SecurityErrorEventegenskap SecurityErrorEvent.type =
flash.events.SecurityErrorEvent.SECURITY_ERROR| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Skickas när ett anrop till URLLoader.load() försöker läsa in data från en server utanför säkerhetssandlådan. Skickas också om ett anrop till URLLoader.load() försöker att läsa in en SWZ-fil och certifikatet är ogiltigt eller sammanfattningsfilen inte matchar komponenten.
SecurityErrorEvent.SECURITY_ERROR definierar värdet för ett securityError-händelseobjekts type-egenskap.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | false |
cancelable | false; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
target | Nätverksobjektet rapporterar säkerhetsfelet. |
text | Text som visas som felmeddelande. |
Relaterade API-element
Tue Jun 12 2018, 01:40 PM Z