| Paket | flash.media |
| Klasse | public class MediaPromise |
| Vererbung | MediaPromise  EventDispatcher Object |
| Implementiert | IFilePromise |
| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 2.5 |
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
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 | ||
| 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 | |
Schließt die Datenquelle. | MediaPromise | ||
|
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | |
|
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | |
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
Öffnet die zugrunde liegende Datenquelle und gibt die IDataInput-Instanz zurück, mit der sie gelesen werden kann. | MediaPromise | ||
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
|
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | |
Wird von der Laufzeitumgebung verwendet, um Fehler zu melden. | MediaPromise | ||
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
|
Gibt das angegebene Objekt als String zurück. | Object | |
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
|
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher | |
| Ereignis | Übersicht | Definiert von | ||
|---|---|---|---|---|
| [broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird. | EventDispatcher | ||
| Ein MediaPromise-Objekt setzt ein close-Ereignis ab, wenn der zugrunde liegende Datenstream geschlossen wurde. | MediaPromise | |||
| Ein MediaPromise-Objekt setzt ein complete-Ereignis ab, wenn alle Daten gelesen wurden. | MediaPromise | |||
| [broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird. | EventDispatcher | ||
| Ein MediaPromise-Objekt setzt ein ioError-Ereignis ab, wenn beim Lesen des zugrunde liegenden Datenstreams ein Fehler auftritt. | MediaPromise | |||
| Ein MediaPromise-Objekt setzt progress-Ereignisse ab, wenn die Daten verfügbar werden. | MediaPromise | |||
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 |
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():StringVerwandte API-Elemente
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():Stringclose | () | 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.
IDataInput |
Verwandte API-Elemente
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.
|
close | Ereignis |
flash.events.EventEigenschaft 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.
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 |
flash.events.EventEigenschaft 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.
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 |
flash.events.IOErrorEventEigenschaft 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 |
flash.events.ProgressEventEigenschaft 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.
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. |
Tue Jun 12 2018, 10:04 AM Z