MediaPromise - Adobe ActionScript® 3 (AS3 ) API-Referenz

Paket	flash.media
Klasse	public class MediaPromise
Vererbung	MediaPromise EventDispatcher Object
Implementiert	IFilePromise

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 2.5

Die MediaPromise-Klasse repräsentiert die Zusage, ein Medienobjekt bereitzustellen.

Die data-Eigenschaft eines MediaEvent-Objekts ist eine MediaPromise-Instanz. Sie können die MediaPromise-Methoden verwenden, um auf das zugesagte Medienobjekt zuzugreifen. Die unterstützten Medienformate sind Standbilder und Videos.

Sie können MediaPromise-Objekte nicht erstellen. Der Aufruf von new MediaPromise() generiert einen Laufzeitfehler.

Verwandte API-Elemente

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

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		file : File [schreibgeschützt] Die File-Instanz, die das Medienobjekt repräsentiert, falls eines vorhanden ist.	MediaPromise
		isAsync : Boolean [schreibgeschützt] Gibt an, ob die zugrunde liegende Datenquelle asynchron oder synchron ist.	MediaPromise
		mediaType : String [schreibgeschützt] Der allgemeine Medientyp, entweder Bild oder Video.	MediaPromise
		relativePath : String [schreibgeschützt] Der Dateiname des Medienobjekts, falls eines vorhanden ist.	MediaPromise

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.	EventDispatcher
		close():void Schließt die Datenquelle.	MediaPromise
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	EventDispatcher
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		open():IDataInput Öffnet die zugrunde liegende Datenquelle und gibt die IDataInput-Instanz zurück, mit der sie gelesen werden kann.	MediaPromise
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	EventDispatcher
		reportError(e:ErrorEvent):void Wird von der Laufzeitumgebung verwendet, um Fehler zu melden.	MediaPromise
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object
		willTrigger(type:String):Boolean Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.	EventDispatcher

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

Vererbte Ereignisse ausblenden

Vererbte Ereignisse anzeigen

	Übersicht	Definiert von
activate	[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.	EventDispatcher
close	Ein MediaPromise-Objekt setzt ein close-Ereignis ab, wenn der zugrunde liegende Datenstream geschlossen wurde.	MediaPromise
complete	Ein MediaPromise-Objekt setzt ein complete-Ereignis ab, wenn alle Daten gelesen wurden.	MediaPromise
deactivate	[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.	EventDispatcher
ioError	Ein MediaPromise-Objekt setzt ein ioError-Ereignis ab, wenn beim Lesen des zugrunde liegenden Datenstreams ein Fehler auftritt.	MediaPromise
progress	Ein MediaPromise-Objekt setzt progress-Ereignisse ab, wenn die Daten verfügbar werden.	MediaPromise

Eigenschaftendetails

file	Eigenschaft

file:File [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 2.5

Die File-Instanz, die das Medienobjekt repräsentiert, falls eines vorhanden ist.

Die Eigenschaft verweist auf ein File-Objekt, wenn die zugrunde liegende Datenquelle dateibasiert ist und die Datei für die Anwendung zugänglich ist. Andernfalls ist die Eigenschaft null.

Implementierung
public function get file():File

isAsync

Eigenschaft

isAsync:Boolean [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 2.5

Gibt an, ob die zugrunde liegende Datenquelle asynchron oder synchron ist.

Implementierung
public function get isAsync():Boolean

mediaType

Eigenschaft

mediaType:String [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 2.5

Der allgemeine Medientyp, entweder Bild oder Video.

Die Konstanten in der MediaType-Klasse definieren mögliche Werte für diese Eigenschaft:

MediaType.IMAGE
MediaType.VIDEO

Implementierung
public function get mediaType():String

Verwandte API-Elemente

MediaType

relativePath

Eigenschaft

relativePath:String [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 2.5

Der Dateiname des Medienobjekts, falls eines vorhanden ist.

Ein Dateiname ist verfügbar, wenn die zugrunde liegende Datenquelle dateibasiert ist und die Datei für die Anwendung zugänglich ist. Andernfalls ist die Eigenschaft null.

Implementierung
public function get relativePath():String

Methodendetails

close

()

Methode

public function close():void

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 2.5

Schließt die Datenquelle.

open

()

Methode

public function open():IDataInput

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 2.5

Öffnet die zugrunde liegende Datenquelle und gibt die IDataInput-Instanz zurück, mit der sie gelesen werden kann.

Wenn die zugrunde liegende Datenquelle asynchron ist, setzt das MediaPromise-Objekt progress- und complete-Ereignisse ab, um anzuzeigen, ob Daten zum Lesen verfügbar sind. Wenn die Datenquelle synchron ist, sind alle Daten sofort verfügbar, weshalb diese Ereignisse nicht abgesetzt werden.

Hinweis: Sie können ein MediaPromise-Objekt mit der loadFilePromise()-Methode der Loader-Klasse laden, anstatt die Daten manuell zu lesen.

Rückgabewerte

IDataInput

Verwandte API-Elemente

Loader.loadFilePromise()

reportError

()

Methode

public function reportError(e:ErrorEvent):void

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 2.5

Wird von der Laufzeitumgebung verwendet, um Fehler zu melden.

Anwendungscode sollte diese Methode nicht aufrufen.

Parameter

e:ErrorEvent — Das abzusetzende Fehlerereignis.

Ereignisdetails

close

Ereignis

Ereignisobjekttyp: flash.events.Event
Eigenschaft Event.type = flash.events.Event.CLOSE

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 2.5

Ein MediaPromise-Objekt setzt ein close-Ereignis ab, wenn der zugrunde liegende Datenstream geschlossen wurde.

Die Event.CLOSE-Konstante definiert den Wert der type-Eigenschaft eines close-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Eigenschaft	Wert
`bubbles`	`false`
`cancelable`	`false`. Es gibt kein Standardverhalten, das abgebrochen werden kann.
`currentTarget`	Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
`target`	Das Objekt, dessen Verbindung geschlossen wurde.

complete

Ereignis

Ereignisobjekttyp: flash.events.Event
Eigenschaft Event.type = flash.events.Event.COMPLETE

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 2.5

Ein MediaPromise-Objekt setzt ein complete-Ereignis ab, wenn alle Daten gelesen wurden. Das Ereignis zeigt an, dass im zugrunde liegenden Stream keine weiteren Daten verfügbar sind.

Ein complete-Ereignis wird nicht von einer synchronen Datenquelle abgesetzt.

Die Event.COMPLETE-Konstante definiert den Wert der type-Eigenschaft eines complete-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Eigenschaft	Wert
`bubbles`	`false`
`cancelable`	`false`. Es gibt kein Standardverhalten, das abgebrochen werden kann.
`currentTarget`	Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
`target`	Das Netzwerkobjekt, dessen Ladevorgang beendet ist.

ioError

Ereignis

Ereignisobjekttyp: flash.events.IOErrorEvent
Eigenschaft IOErrorEvent.type = flash.events.IOErrorEvent.IOERROR

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 2.5

Ein MediaPromise-Objekt setzt ein ioError-Ereignis ab, wenn beim Lesen des zugrunde liegenden Datenstreams ein Fehler auftritt. Nachdem dieses Ereignis abgesetzt wurde, können keine Daten mehr gelesen werden.

progress

Ereignis

Ereignisobjekttyp: flash.events.ProgressEvent
Eigenschaft ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 2.5

Ein MediaPromise-Objekt setzt progress-Ereignisse ab, wenn die Daten verfügbar werden.

Die bytesTotal-Eigenschaft aller progress-Ereignisse mit Ausnahme des letzten hat den Wert 0. Wenn alle Daten sofort verfügbar sind, werden keine progress-Ereignisse abgesetzt. Von synchronen Datenquellen werden keine progress-Ereignisse abgesetzt.

Definiert den Wert der Eigenschaft type eines progress-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Eigenschaft	Wert
`bubbles`	`false`
`bytesLoaded`	Die Anzahl der geladenen Elemente oder Byte zu dem Zeitpunkt, zu dem der Listener das Ereignis verarbeitet.
`bytesTotal`	Die Gesamtanzahl der Elemente oder Byte, die bei einem erfolgreichen Ladevorgang schließlich geladen werden.
`cancelable`	`false`. Es gibt kein Standardverhalten, das abgebrochen werden kann.
`currentTarget`	Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
`target`	Das Objekt, dessen Fortschritt protokolliert wird.

Rechtliche Hinweise | Onlinedatenschutzerklärung

MediaPromise - AS3

Paketex

Sprachelemente

Anhänge

Paket flash.media

file

isAsync

mediaType

relativePath

close

open

reportError

close

complete

ioError

progress