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

Paket	flash.media
Klass	public class MediaPromise
Arv	MediaPromise EventDispatcher Object
Implementerar	IFilePromise

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 2.5

Klassen MediaPromise representerar ett löfte att leverera ett medieobjekt.

Egenskapen data i ett MediaEvent-objekt är en MediaPromise-instans. Du kan använda MediaPromise-metoder för att få tillgång till det utlovade medieobjektet. Medieformat som stöds är bl.a. stillbilder och video.

Du kan inte skapa ett MediaPromise-objekt. Anrop till new MediaPromise() genererar ett körningsfel.

Relaterade API-element

MediaEvent
IFilePromise
Loader.LoadFilePromise()
IDataInput
CameraRoll.browseForImage()
CameraUI

Publika egenskaper

Dölj ärvda publika egenskaper

Visa ärvda publika egenskaper

	Egenskap		Definieras med
		constructor : Object En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans.	Object
		file : File [skrivskyddad] Den File-instans som representerar medieobjektet, om det finns ett sådant.	MediaPromise
		isAsync : Boolean [skrivskyddad] Rapporterar om den underliggande datakällan är asynkron eller synkron.	MediaPromise
		mediaType : String [skrivskyddad] Mediets allmänna typ, antingen bild eller video.	MediaPromise
		relativePath : String [skrivskyddad] Medieobjektets filnamn, om det finns ett sådant.	MediaPromise

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 datakällan.	MediaPromise
		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
		open():IDataInput Öppnar den underliggande datakällan och returnerar den IDataInput-instans som gör att du kan läsa den.	MediaPromise
		propertyIsEnumerable(name:String):Boolean Anger om den angivna egenskapen finns och är uppräkningsbar.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Tar bort en avlyssnare från EventDispatcher-objektet.	EventDispatcher
		reportError(e:ErrorEvent):void Används av miljön för att rapportera fel.	MediaPromise
		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
close	Ett MediaPromise-objekt skickar en close-händelse när den underliggande dataströmmen har stängts.	MediaPromise
complete	Ett MediaPromise-objekt skickar en complete-händelse när alla data har lästs.	MediaPromise
deactivate	[utsändningshändelse] Skickas när Flash Player eller AIR förlorar operativsystemfokus och blir inaktivt.	EventDispatcher
ioError	Ett MediaPromise-objekt skickar en ioError-händelse när ett fel påträffas vid läsning av den underliggande dataströmmen.	MediaPromise
progress	Ett MediaPromise-objekt skickar progress-händelser efterhand som data blir tillgängliga.	MediaPromise

Egenskapsdetaljer

file

egenskap

file:File [skrivskyddad]

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 2.5

Den File-instans som representerar medieobjektet, om det finns ett sådant.

Den här egenskapen refererar till ett File-objekt om den underliggande datakällan är filbaserad och filen är tillgänglig för programmet. I annat fall är egenskapen null.

Implementering
public function get file():File

isAsync

egenskap

isAsync:Boolean [skrivskyddad]

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 2.5

Rapporterar om den underliggande datakällan är asynkron eller synkron.

Implementering
public function get isAsync():Boolean

mediaType

egenskap

mediaType:String [skrivskyddad]

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 2.5

Mediets allmänna typ, antingen bild eller video.

Konstanterna i klassen MediaType definierar möjliga värden för den här egenskapen:

MediaType.IMAGE
MediaType.VIDEO

Implementering
public function get mediaType():String

Relaterade API-element

MediaType

relativePath

egenskap

relativePath:String [skrivskyddad]

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 2.5

Medieobjektets filnamn, om det finns ett sådant.

Ett filnamn är tillgängligt om den underliggande datakällan är filbaserad och filen är tillgänglig för programmet. I annat fall är egenskapen null.

Implementering
public function get relativePath():String

Metoddetaljer

close

()

metod

public function close():void

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 2.5

Stänger datakällan.

open

()

metod

public function open():IDataInput

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 2.5

Öppnar den underliggande datakällan och returnerar den IDataInput-instans som gör att du kan läsa den.

Om den underliggande datakällan är asynkron skickar MediaPromise-objektet progress- och complete-händelser för att ange om det finns tillgängliga data att läsa. Om datakällan är synkron är alla data tillgängliga direkt och de här händelserna skickas inte.

Obs! Du kan läsa in ett MediaPromise-objekt med metoden loadFilePromise() i klassen Loader i stället för att läsa data manuellt.

Returnerar

IDataInput

Relaterade API-element

Loader.loadFilePromise()

reportError

()

metod

public function reportError(e:ErrorEvent):void

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 2.5

Används av miljön för att rapportera fel.

Programkod bör inte anropa den här metoden.

Parametrar

e:ErrorEvent — Den felhändelse som ska skickas.

Händelsedetaljer

close

Händelse

Typ av händelseobjekt: flash.events.Event
egenskap Event.type = flash.events.Event.CLOSE

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 2.5

Ett MediaPromise-objekt skickar en close-händelse när den underliggande dataströmmen har stängts.

Event.CLOSE-konstanten definierar värdet på type-egenskapen i ett close-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 objekt vars anslutning har stängts.

complete

Händelse

Typ av händelseobjekt: flash.events.Event
egenskap Event.type = flash.events.Event.COMPLETE

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 2.5

Ett MediaPromise-objekt skickar en complete-händelse när alla data har lästs. Händelsen anger att det inte finns fler data tillgängliga i den underliggande strömmen.

En synkron datakälla skickar ingen complete-händelse.

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.

ioError

Händelse

Typ av händelseobjekt: flash.events.IOErrorEvent
egenskap IOErrorEvent.type = flash.events.IOErrorEvent.IOERROR

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 2.5

Ett MediaPromise-objekt skickar en ioError-händelse när ett fel påträffas vid läsning av den underliggande dataströmmen. När den här händelsen har skickats kan inga fler data läsas.

progress

Händelse

Typ av händelseobjekt: flash.events.ProgressEvent
egenskap ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 2.5

Ett MediaPromise-objekt skickar progress-händelser efterhand som data blir tillgängliga.

Egenskapen bytesTotal för alla progress-händelser utom den sista har värdet 0. Om alla data är tillgängliga direkt kan inga progress-händelser skickas. Synkrona datakällor skickar inga progress-händelser.

Definierar värdet för ett progress-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.

Juridiska meddelanden | Onlinesekretesspolicy

MediaPromise - AS3

Paketx

Språkelement

Bilagor

Paket flash.media

file

isAsync

mediaType

relativePath

close

open

reportError

close

complete

ioError

progress