Pakket | flash.media |
Klasse | public class AVURLLoader |
Overerving | AVURLLoader URLLoader EventDispatcher Object |
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Een URLLoader-object downloadt alle gegevens van een URL voordat deze aan de toepassingen beschikbaar worden gesteld. Er worden meldingen verzonden over de voortgang van de download, die u kunt via de eigenschappen bytesLoaded
en bytesTotal
en via verzonden gebeurtenissen kunt controleren.
Bij het laden van zeer grote videobestanden, bijvoorbeeld FLV-bestanden, kunnen fouten met betrekking tot te weinig geheugen optreden.
Wanneer u deze klasse gebruikt in Flash Player en in inhoud in een AIR-toepassing in andere beveiligingssandboxen dan de sandbox met toepassingsbeveiliging, moet u het volgende beveiligingsmodel overwegen:
- Een SWF-bestand in de sandbox Lokaal-met-bestandssysteem kan geen gegevens laden naar een bron in de netwerksandbox of deze bron van gegevens voorzien.
- Standaard moeten het aanroepende SWF-bestand en de URL die u laadt zich in exact hetzelfde domein bevinden. Een SWF-bestand op www.adobe.com kan bijvoorbeeld alleen gegevens laden van bronnen die zelf ook aanwezig zijn op www.adobe.com. Wanneer u gegevens van een ander domein wilt laden, plaatst u een bestand met URL-beleid op de server die als host fungeert voor de gegevens.
Lees voor meer informatie over beveiliging het onderwerp Security in het Flash Player Developer Center.
Verwante API-elementen
Eigenschap | Gedefinieerd door | ||
---|---|---|---|
bytesLoaded : uint = 0
Geeft het aantal bytes aan dat tot nu toe tijdens de laadbewerking is geladen. | URLLoader | ||
bytesTotal : uint = 0
Geeft het totale aantal bytes in de gedownloade gegevens aan. | URLLoader | ||
constructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie. | Object | ||
cookieHeader : String [alleen-schrijven] | AVURLLoader | ||
data : *
De gegevens die via de laadbewerking zijn ontvangen. | URLLoader | ||
dataFormat : String = "text"
Houdt bij of de gedownloade gegevens als tekst (URLLoaderDataFormat.TEXT), als onbewerkte binaire gegevens (URLLoaderDataFormat.BINARY) of als URL-gecodeerde variabelen (URLLoaderDataFormat.VARIABLES) zijn ontvangen. | URLLoader |
Methode | Gedefinieerd door | ||
---|---|---|---|
AVURLLoader(request:URLRequest = null)
Maakt een object URLLoader. | AVURLLoader | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [overschrijven] | AVURLLoader | ||
[overschrijven]
Sluit de laadbewerking die wordt uitgevoerd. | AVURLLoader | ||
Verzendt een gebeurtenis naar de gebeurtenisstroom. | EventDispatcher | ||
Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis. | EventDispatcher | ||
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | ||
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | ||
[overschrijven]
Verzendt en laadt gegevens via de opgegeven URL. | AVURLLoader | ||
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | ||
Verwijdert een listener uit het object EventDispatcher. | EventDispatcher | ||
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in. | Object | ||
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies. | Object | ||
Retourneert een tekenreeksrepresentatie van het opgegeven object. | Object | ||
Retourneert de primitieve waarde van het opgegeven object. | Object | ||
Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis. | EventDispatcher |
Gebeurtenis | Overzicht | Gedefinieerd door | ||
---|---|---|---|---|
[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de besturingssysteemfocus krijgt en actief wordt. | EventDispatcher | |||
Wordt verzonden nadat alle ontvangen gegevens zijn gedecodeerd en in de gegevenseigenschap van het object URLLoader zijn geplaatst. | AVURLLoader | |||
[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de systeemfocus verliest en inactief wordt. | EventDispatcher | |||
Wordt verzonden als een aanroep naar de methode load() via HTTP toegang tot gegevens probeert te krijgen, en Adobe AIR de statuscode voor de aanvraag kan detecteren en retourneren. | AVURLLoader | |||
Wordt verzonden als een aanroep naar URLLoader.load() via HTTP toegang probeert te krijgen tot gegevens. | AVURLLoader | |||
Wordt verzonden wanneer een aanroep naar URLLoader.load() resulteert in een fatale fout die de download beëindigt. | AVURLLoader | |||
Wordt verzonden wanneer de downloadbewerking begint na een aanroep van de methode URLLoader.load(). | AVURLLoader | |||
Wordt verzonden wanneer gegevens tijdens de downloadbewerking worden ontvangen. | AVURLLoader | |||
Wordt verzonden wanneer een aanroep naar URLLoader.load() probeert gegevens te laden van een server buiten de beveiligingssandbox. | AVURLLoader |
cookieHeader | eigenschap |
AVURLLoader | () | Constructor |
public function AVURLLoader(request:URLRequest = null)
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Maakt een object URLLoader.
Parametersrequest:URLRequest (default = null ) — Een object URLRequest dat de URL opgeeft die moet worden gedownload. Wanneer deze parameter wordt weggelaten, begint de laadbewerking niet. Wanneer de parameter wordt opgegeven, begint de laadbewerking direct (zie load voor meer informatie).
|
Verwante API-elementen
addEventListener | () | methode |
override public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Parameters
type:String | |
listener:Function | |
useCapture:Boolean (default = false )
| |
priority:int (default = 0 )
| |
useWeakReference:Boolean (default = false )
|
close | () | methode |
override public function close():void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Sluit de laadbewerking die wordt uitgevoerd. Een eventuele laadbewerking die wordt uitgevoerd, wordt direct beëindigd. Wanneer momenteel geen URL wordt gestreamd, wordt een fout met betrekking tot een ongeldige stream gegenereerd.
load | () | methode |
override public function load(request:URLRequest):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Verzendt en laadt gegevens via de opgegeven URL. De gegevens kunnen worden ontvangen als tekst, onbewerkte binaire gegevens of URL-gecodeerde variabelen, afhankelijk van de waarde die u voor de eigenschap dataFormat
instelt. De standaardwaarde van de eigenschap dataFormat
is tekst. Wanneer u gegevens naar de opgegeven URL wilt verzenden, kunt u de eigenschap data
in het object URLRequest instellen.
Opmerking: wanneer een bestand dat wordt geladen niet-ASCII-tekens bevat (zoals in vele niet-Engelse talen), wordt geadviseerd het bestand met UTF-8- of UTF-16-codering op te slaan in plaats van een niet-Unicode-indeling zoals ASCII.
Een SWF-bestand in de sandbox Lokaal-met-bestandssysteem kan geen gegevens laden naar een bron in de netwerksandbox of deze bron van gegevens voorzien.
Standaard moeten het aanroepende SWF-bestand en de URL die u laadt zich in exact hetzelfde domein bevinden. Een SWF-bestand op www.adobe.com kan bijvoorbeeld alleen gegevens laden van bronnen die zelf ook aanwezig zijn op www.adobe.com. Wanneer u gegevens van een ander domein wilt laden, plaatst u een bestand met URL-beleid op de server die als host fungeert voor de gegevens.
U kunt geen verbinding maken met algemeen gereserveerde poorten. Zie "Netwerk-API's beperken" in de Adobe ActionScript 3.0-ontwikkelaarsgids voor een volledige lijst van geblokkeerde poorten.
Als u in Flash Player 10 en hoger een multipart-inhoudstype gebruikt (bijvoorbeeld 'multipart/form-data') dat een upload bevat (aangegeven met de parameter 'bestandsnaam' in een header 'content-disposition' binnen de POST-body), gelden voor de POST-bewerking de beveiligingsregels die van toepassing zijn op uploads:
- De POST-bewerking moet worden uitgevoerd in reactie op een door de gebruiker geïnitieerde actie, zoals het klikken met de muis of het indrukken van een toets.
- Als bij de POST-bewerking verschillende domeinen betrokken zijn (het doel van de POST-bewerking bevindt zich niet op dezelfde server als het SWF-bestand dat de POST-aanvraag verstuurt), moet de doelserver een URL-beleidsbestand leveren dat interdomeintoegang toestaat.
In het geval van een multipart-inhoudstype is het ook essentieel dat de syntaxis juist is (in overeenstemming met de norm RFC2046). Als de syntaxis ongeldig lijkt te zijn, gelden voor de POST-bewerking de beveiligingsregels die van toepassing zijn op uploads.
Lees voor meer informatie over beveiliging het onderwerp Security in het Flash Player Developer Center.
Parameters
request:URLRequest — Een object URLRequest dat de URL opgeeft die moet worden gedownload.
|
Gebeurtenissen
complete: — Wordt verzonden nadat gegevens zijn geladen.
| |
httpStatus: — Wanneer toegang plaatsvindt via HTTP en de huidige Flash Player-omgeving het ophalen van statuscodes ondersteunt, kunt u deze gebeurtenissen ontvangen naast de gebeurtenissen complete of error .
| |
ioError: — De laadbewerking kan niet worden voltooid.
| |
progress: — Wordt verzonden wanneer gegevens tijdens de downloadbewerking worden ontvangen.
| |
securityError: — Een laadbewerking probeerde gegevens op te halen van een server buiten de beveiligingssandbox van de aanroeper. Dit kan worden omzeild door gebruik te maken van een beleidsbestand op de server.
| |
securityError: — Er is geprobeerd een SWZ-bestand (een component van het Adobe-platform) te laden, maar het certificaat is ongeldig of de digest-tekenreeks komt niet overeen met de component.
| |
open: — Wordt verzonden wanneer een laadbewerking begint.
| |
httpResponseStatus: — Wordt verzonden als een aanroep naar de methode load() via HTTP toegang tot gegevens probeert te krijgen en Adobe AIR de statuscode voor de aanvraag kan detecteren en retourneren.
|
Gegenereerde uitzondering
ArgumentError — Objecten URLRequest.requestHeader mogen bepaalde niet-toegestane HTTP-aanvraagheaders niet bevatten. Zie de beschrijving van de klasse URLRequestHeader voor meer informatie.
| |
MemoryError — Deze fout kan om de volgende redenen optreden: 1) Flash Player of AIR kan de parameter URLRequest.data niet converteren van UTF8 naar MBCS. Deze fout treedt op wanneer het object URLRequest dat aan load() is doorgegeven, een bewerking GET uitvoert en wanneer System.useCodePage op true is ingesteld. 2) Flash Player of AIR kan geen geheugen toewijzen voor de POST -gegevens. Deze fout doet zich voor wanneer het object URLRequest dat aan load wordt doorgegeven, een bewerking POST uitvoert.
| |
SecurityError — Lokale niet-vertrouwde bestanden mogen niet communiceren met internet. U kunt dit omzeilen door dit bestand opnieuw te classificeren als lokaal-met-netwerk of vertrouwd.
| |
SecurityError — U probeert verbinding te maken met een algemeen gereserveerde poort. Zie "Netwerk-API's beperken" in de Adobe ActionScript 3.0-ontwikkelaarsgids voor een volledige lijst van geblokkeerde poorten.
| |
TypeError — De waarde van de parameter request of de eigenschap URLRequest.url van het doorgegeven object URLRequest is null .
|
Verwante API-elementen
URLRequest.requestHeaders
URLRequest.data
URLRequest.digest
complete | Gebeurtenis |
flash.events.Event
eigenschap Event.type =
flash.events.Event.COMPLETE
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wordt verzonden nadat alle ontvangen gegevens zijn gedecodeerd en in de gegevenseigenschap van het object URLLoader zijn geplaatst. De ontvangen gegevens zijn toegankelijk nadat deze gebeurtenis is verzonden.
De constanteEvent.COMPLETE
definieert de waarde van de eigenschap type
van een complete
-gebeurtenisobject.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | false |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
target | Het netwerkobject dat klaar is met laden. |
Verwante API-elementen
httpResponseStatus | Gebeurtenis |
flash.events.HTTPStatusEvent
eigenschap HTTPStatusEvent.type =
flash.events.HTTPStatusEvent.HTTP_RESPONSE_STATUS
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, AIR 1.0, Flash Lite 4 |
Wordt verzonden als een aanroep naar de methode load() via HTTP toegang tot gegevens probeert te krijgen, en Adobe AIR de statuscode voor de aanvraag kan detecteren en retourneren.
In tegenstelling tot de gebeurtenishttpStatus
, wordt de gebeurtenis httpResponseStatus
vóór eventuele responsgegevens bezorgd. Bovendien bevat de gebeurtenis httpResponseStatus
waarden voor de eigenschappen responseHeaders
en responseURL
(die ongedefinieerd zijn voor een httpStatus
-gebeurtenis). De gebeurtenis httpResponseStatus
(indien aanwezig) wordt verzonden vóór (en als aanvulling op) een gebeurtenis complete
of error
.
De constante HTTPStatusEvent.HTTP_RESPONSE_STATUS
definieert de waarde van de eigenschap type
van een httpResponseStatus
-gebeurtenisobject.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | false |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
responseURL | De URL waar het antwoord vandaan komt. |
responseHeaders | De antwoordheaders die door het antwoord zijn geretourneerd, als een array van URLRequestHeader-objecten. |
status | De HTTP-statuscode die door de server wordt geretourneerd. |
redirected | Of de reactie het resultaat is van een omleiding. |
target | Het netwerkobject dat de HTTP-statuscode ontvangt. |
Verwante API-elementen
httpStatus | Gebeurtenis |
flash.events.HTTPStatusEvent
eigenschap HTTPStatusEvent.type =
flash.events.HTTPStatusEvent.HTTP_STATUS
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wordt verzonden als een aanroep naar URLLoader.load() via HTTP toegang probeert te krijgen tot gegevens. Voor inhoud die in Flash Player wordt uitgevoerd, wordt deze gebeurtenis alleen verzonden als de huidige Flash Player-omgeving de statuscode voor de aanvraag kan detecteren en retourneren. (Sommige browseromgevingen kunnen deze informatie mogelijk niet bieden.) De gebeurtenis httpStatus
(indien aanwezig) wordt verzonden voor (en als aanvulling op) een eventuele gebeurtenis complete
of error
.
HTTPStatusEvent.HTTP_STATUS
definieert de waarde van de eigenschap type
van een httpStatus
-gebeurtenisobject.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | false |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
status | De HTTP-statuscode die door de server wordt geretourneerd. |
target | Het netwerkobject dat de HTTP-statuscode ontvangt. |
Verwante API-elementen
ioError | Gebeurtenis |
flash.events.IOErrorEvent
eigenschap IOErrorEvent.type =
flash.events.IOErrorEvent.IO_ERROR
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wordt verzonden wanneer een aanroep naar URLLoader.load() resulteert in een fatale fout die de download beëindigt.
Definieert de waarde van de eigenschaptype
van een gebeurtenisobject ioError
.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | false |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
errorID | Een referentienummer dat aan de specifieke fout is gekoppeld (alleen AIR). |
target | Het netwerkobject dat de invoer-/uitvoerfout ondervindt. |
text | Tekst die moet worden weergegeven als foutbericht. |
Verwante API-elementen
open | Gebeurtenis |
flash.events.Event
eigenschap Event.type =
flash.events.Event.OPEN
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wordt verzonden wanneer de downloadbewerking begint na een aanroep van de methode URLLoader.load()
.
Event.OPEN
definieert de waarde van de eigenschap type
van een open
-gebeurtenisobject.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | false |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
target | Het netwerkobject dat de verbinding heeft geopend. |
Verwante API-elementen
progress | Gebeurtenis |
flash.events.ProgressEvent
eigenschap ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wordt verzonden wanneer gegevens tijdens de downloadbewerking worden ontvangen.
Let op dat in het geval van een object URLLoader de gegevens pas toegankelijk zijn nadat alle gegevens volledig zijn ontvangen. ProgressEvent fungeert daarom slechts als melding van de voortgang van de download. Wanneer u toegang wilt tot de gegevens voordat deze volledig zijn gedownload, gebruikt u het object AVURLStream.
Definieert de waarde van de eigenschaptype
van een gebeurtenisobject progress
.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | false |
bytesLoaded | Het aantal items of bytes dat wordt geladen wanneer de listener de gebeurtenis verwerkt. |
bytesTotal | Het totale aantal items of bytes dat uiteindelijk wordt geladen wanneer het laadproces is voltooid. |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
target | Het object dat de voortgang rapporteert. |
Verwante API-elementen
securityError | Gebeurtenis |
flash.events.SecurityErrorEvent
eigenschap SecurityErrorEvent.type =
flash.events.SecurityErrorEvent.SECURITY_ERROR
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wordt verzonden wanneer een aanroep naar URLLoader.load() probeert gegevens te laden van een server buiten de beveiligingssandbox. Wordt ook verzonden wanneer een aanroep van URLLoader.load()
probeert een SWZ-bestand te laden en het certificaat ongeldig is of de digest-tekenreeks niet overeenkomt met de component.
SecurityErrorEvent.SECURITY_ERROR
definieert de waarde van de eigenschap type
van een gebeurtenisobject securityError
.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | false |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
target | Het netwerkobject dat de beveiligingsfout rapporteert. |
text | Tekst die moet worden weergegeven als foutbericht. |
Verwante API-elementen
Wed Jun 13 2018, 11:42 AM Z