AVURLStream - API-referens för Adobe ActionScript® 3 (AS3 )

Paket	flash.media
Klass	public class AVURLStream
Arv	AVURLStream URLStream EventDispatcher Object

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9, Flash Lite 4

Klassen URLStream ger åtkomst till URL-nedladdning på låg nivå. Data blir omedelbart tillgängliga för programkoden allteftersom de laddas ned, i stället för att bli tillgängliga först när hela filen är klar, som med URLLoader. Med klassen URLStream kan du även stänga ett dataflöde innan nedladdningen är slutförd. Innehållet i filen som laddades ned är tillgängligt som binära rådata.

Läsåtgärderna i URLStream är inte blockerande. Detta innebär att du måste använda egenskapen bytesAvailable för att avgöra om det finns tillräckligt med data tillgängligt innan läsningen. Undantaget EOFError genereras om det inte finns tillräckligt med data.

Som standard kodas alla binära data i Big Endian-format, med den viktigaste databyten först.

De säkerhetsregler som används vid URL-nedladdning med klassen URLStream är identiska med de som används för URLLoader-objekt. Policyfiler kan laddas ned vid behov. Säkerhetsreglerna för lokala filer används och säkerhetsvarningar visas vid behov.

Relaterade API-element

URLLoader
URLRequest

Publika egenskaper

Dölj ärvda publika egenskaper

Visa ärvda publika egenskaper

	Egenskap		Definieras med
		bytesAvailable : uint [skrivskyddad] Returnerar antalet databyte som kan läsas i indatabufferten.	URLStream
		connected : Boolean [skrivskyddad] Anger om det här URLStream-objektet är anslutet.	URLStream
		constructor : Object En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans.	Object
		cookieHeader : String [lässkyddad]	AVURLStream
		endian : String Anger byteordningen för data.	URLStream
		objectEncoding : uint Styr vilken version av AMF (Action Message Format) som används när ett objekt skrivs eller läses.	URLStream

Publika metoder

Dölj ärvda publika metoder

Visa ärvda publika metoder

	Metod		Definieras med
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registrerar ett händelseavlyssnarobjekt för ett EventDispatcher-objekt så att avlyssnaren får meddelanden om händelser.	EventDispatcher
		close():void Stänger omedelbart dataflödet och avbryter nedladdningen.	URLStream
		dispatchEvent(event:Event):Boolean Skickar en händelse till händelseflödet.	EventDispatcher
		hasEventListener(type:String):Boolean Kontrollerar om EventDispatcher-objektet har några avlyssnare registrerade för en viss typ av händelse.	EventDispatcher
		hasOwnProperty(name:String):Boolean Anger om det finns en egenskap angiven för ett objekt.	Object
		isPrototypeOf(theClass:Object):Boolean Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter.	Object
		load(request:URLRequest):void [åsidosätt] Börjar ladda ned URL:en som anges i parametern begäran.	AVURLStream
		propertyIsEnumerable(name:String):Boolean Anger om den angivna egenskapen finns och är uppräkningsbar.	Object
		readBoolean():Boolean Läser ett booleskt värde från flödet.	URLStream
		readByte():int Läser en byte med tecken från flödet.	URLStream
		readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void Läser det antal databyte som anges av parametern length från flödet.	URLStream
		readDouble():Number Läser ett IEEE 754-flyttal med dubbel precision från flödet.	URLStream
		readFloat():Number Läser ett IEEE 754-flyttal med enkel precision från flödet.	URLStream
		readInt():int Läser ett 32-bitars heltal med tecken från flödet.	URLStream
		readMultiByte(length:uint, charSet:String):String Läser en multibyte-sträng med den angivna längden från byteströmmen med den angivna teckenuppsättningen.	URLStream
		readObject():* Läser ett objekt från socketen, kodat i serialiserat AMF-format (Action Message Format).	URLStream
		readShort():int Läser ett 16-bitars heltal med tecken från flödet.	URLStream
		readUnsignedByte():uint Läser en byte utan tecken från flödet.	URLStream
		readUnsignedInt():uint Läser ett 32-bitars heltal utan tecken från flödet.	URLStream
		readUnsignedShort():uint Läser ett 16-bitars heltal utan tecken från flödet.	URLStream
		readUTF():String Läser en UTF-8-sträng från flödet.	URLStream
		readUTFBytes(length:uint):String Läser en sekvens UTF-8-byte med den angivna längden length från flödet och returnerar en sträng.	URLStream
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Tar bort en avlyssnare från EventDispatcher-objektet.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Anger tillgänglighet för en dynamisk egenskap för slingåtgärder.	Object
		toLocaleString():String Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner.	Object
		toString():String Returnerar det angivna objektets strängbeteckning.	Object
		valueOf():Object Returnerar det angivna objektets primitiva värde.	Object
		willTrigger(type:String):Boolean 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ändelser

Klicka för mer information om händelser

Dölj ärvda händelser

Visa ärvda händelser

	Sammanfattning	Definieras med
activate	[utsändningshändelse] Skickas när Flash Player eller AIR får operativsystemfokus och blir aktivt.	EventDispatcher
complete	Skickas när alla data är inlästa.	URLStream
deactivate	[utsändningshändelse] Skickas när Flash Player eller AIR förlorar operativsystemfokus och blir inaktivt.	EventDispatcher
httpResponseStatus	Skickas om ett anrop till metoden URLStream.load() försöker få åtkomst till data via HTTP och Adobe AIR upptäcker och returnerar statuskoden för begäran.	URLStream
httpStatus	Skickas om ett anrop till URLStream.load() försöker få åtkomst till data via HTTP, och Flash Player eller Adobe AIR upptäcker och returnerar statuskoden för begäran.	URLStream
ioError	Skickas om ett in- eller utdatafel orsakar en misslyckad inläsningsåtgärd.	URLStream
open	Skickas när en inläsning initieras.	URLStream
progress	Skickas när data tas emot under nedladdningsförloppet.	URLStream
securityError	Skickas när ett anrop till URLStream.load() försöker läsa in data från en server utanför säkerhetssandlådan.	URLStream

Egenskapsdetaljer

cookieHeader

egenskap

cookieHeader:String [lässkyddad]

Implementering
public function set cookieHeader(value:String):void

Metoddetaljer

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

Börjar ladda ned URL:en som anges i parametern request.

Obs: Om en fil som läses in innehåller andra tecken än ASCII-tecken (finns i många icke-engelska språk) rekommenderas du att spara filen med UTF-8 eller UTF-16-kodning i stället för ett icke-Unicode-format som ASCII.

Om inläsningen misslyckas på en gång genereras ett I/O-fel eller säkerhetsfel och ett felmeddelande visas. I annat fall skickas händelsen open om URL-nedladdningen påbörjas eller så skickas en felhändelse om ett fel uppstår.

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.

I Flash Player kan du 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.

I Flash Player kan du förhindra att en SWF-fil använder denna metod genom inställningen av parametern allowNetworking för taggarna object och embed på HTML-sidan med SWF-innehållet.

Om du i Flash Player 10 och senare, och i AIR 1.5 och 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.

Dessa regler gäller också för AIR-innehåll i icke-programsandlådor. I Adobe AIR begränsas emellertid inte innehåll i programsandlådan (innehåll som installeras med AIR-programmet) av de här säkerhetsbegränsningarna.

Mer information om säkerhet finns i avsnittet Security på Flash Player Developer Center.

I AIR kan ett URLRequest-objekt registrera sig för statushändelsen httpResponse. Till skillnad från httpStatus-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.

Om det finns en httpResponseStatus-händelseavlyssnare, är svarsmeddelandets brödtext alltid skickat, och HTTP-statuskodsvar leder alltid till en complete-händelse. Detta gäller även om HTTP-svarsstatuskoden anger om åtgärden har lyckats eller misslyckats.

I AIR, om det inte finns någon httpResponseStatus-händelseavlyssnare, kan det här beteendet fungera annorlunda, beroende på SWF-versionen:

För SWF 9-innehåll skickas brödtexten i HTTP-svarsmeddelandet bara om HTTP-svarsstatuskoden anger att åtgärden har lyckats. Annars (om ett fel uppstår) skickas ingen brödtext och URLRequest-objektet skickar en IOError-händelse.
För SWF 10-innehåll skickas alltid brödtexten i HTTP-svarsmeddelandet. Om ett fel uppstår skickar URLRequest-objektet en IOError-händelse.

Parametrar

request:URLRequest — Ett URLRequest-objekt som anger vilket URL som ska laddas ned. Om värdet för den här parametern eller egenskapen URLRequest.url för URLRequest-objektet som skickas är null genereras ett null-pekarfel.

Händelser

	`complete:Event` — Skickas när alla data är inlästa. Om det finns en `httpResponseStatus`-händelseavlyssnare skickar URLRequest-objektet också en `complete`-händelse, oavsett om HTTP-svarskoden anger att åtgärden har lyckats eller misslyckats.

	`httpStatus:HTTPStatusEvent` — Om åtkomsten sker via HTTP, och den aktuella miljön stöder hämtning av statuskoder, kan dessa händelser skickas utöver eventuella `complete`- eller `error`-händelser.

	`httpResponseStatus:HTTPStatusEvent` — 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.

	`ioError:IOErrorEvent` — Det gick inte att slutföra inläsningen.

	`open:Event` — Skickas när en inläsning initieras.

	`securityError:SecurityErrorEvent` — 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.

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: Flash Player eller Adobe 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`. Flash Player eller Adobe 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 SWF-filer kanske inte kan kommunicera med Internet. Du kan lösa problemet genom att omklassificera SWF-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.

Juridiska meddelanden | Onlinesekretesspolicy

AVURLStream - AS3

Klasser x

cookieHeader

load