| Paket | flash.media |
| Klass | public class MediaPromise |
| Arv | MediaPromise  EventDispatcher Object |
| Implementerar | IFilePromise |
| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 2.5 |
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
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 | ||
| 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 | |
Stänger datakällan. | MediaPromise | ||
|
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 | |
Öppnar den underliggande datakällan och returnerar den IDataInput-instans som gör att du kan läsa den. | MediaPromise | ||
|
Anger om den angivna egenskapen finns och är uppräkningsbar. | Object | |
|
Tar bort en avlyssnare från EventDispatcher-objektet. | EventDispatcher | |
Används av miljön för att rapportera fel. | MediaPromise | ||
|
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 | ||
| Ett MediaPromise-objekt skickar en close-händelse när den underliggande dataströmmen har stängts. | MediaPromise | |||
| Ett MediaPromise-objekt skickar en complete-händelse när alla data har lästs. | MediaPromise | |||
| [utsändningshändelse] Skickas när Flash Player eller AIR förlorar operativsystemfokus och blir inaktivt. | EventDispatcher | ||
| Ett MediaPromise-objekt skickar en ioError-händelse när ett fel påträffas vid läsning av den underliggande dataströmmen. | MediaPromise | |||
| Ett MediaPromise-objekt skickar progress-händelser efterhand som data blir tillgängliga. | MediaPromise | |||
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 |
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():StringRelaterade API-element
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():Stringclose | () | 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.
IDataInput |
Relaterade API-element
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.
|
close | Händelse |
flash.events.Eventegenskap 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 |
flash.events.Eventegenskap 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 |
flash.events.IOErrorEventegenskap 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 |
flash.events.ProgressEventegenskap 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.
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. |
Tue Jun 12 2018, 01:40 PM Z