| Pakiet | flash.media |
| Klasa | public class MediaPromise |
| Dziedziczenie | MediaPromise  EventDispatcher Object |
| Implementuje | IFilePromise |
| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 2.5 |
Właściwość data obiektu MediaEvent jest wystąpieniem klasy MediaPromise. Używając metod klasy MediaPromise, można uzyskać dostęp do przyrzeczonego obiektu multimedialnego. Do obsługiwanych formatów multimedialnych należą obrazy nieruchome i wideo.
Nie można utworzyć obiektu MediaPromise. Wywołanie konstruktora new MediaPromise() powoduje błąd czasu wykonania.
Powiązane elementy interfejsu API
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne| Właściwość | Zdefiniowane przez | ||
|---|---|---|---|
 | constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | |
| file : File [tylko do odczytu]
Wystąpienie klasy File reprezentujące obiekt multimedialny (o ile istnieje). | MediaPromise | ||
| isAsync : Boolean [tylko do odczytu]
Wskazuje, czy pierwotne źródło danych jest asynchroniczne czy synchroniczne. | MediaPromise | ||
| mediaType : String [tylko do odczytu]
Ogólny typ multimedialny — obraz lub wideo. | MediaPromise | ||
| relativePath : String [tylko do odczytu]
Nazwa pliku obiektu multimedialnego (o ile istnieje). | MediaPromise | ||
| Metoda | Zdefiniowane przez | ||
|---|---|---|---|
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Rejestruje obiekt detektora zdarzeń w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu. | EventDispatcher | |
Zamyka źródło danych. | MediaPromise | ||
|
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń. | EventDispatcher | |
|
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń. | EventDispatcher | |
|
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | |
|
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | |
Otwiera pierwotne źródło danych i zwraca wystąpienie klasy IDataInput, umożliwiając odczyt źródła. | MediaPromise | ||
|
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | |
|
Usuwa detektor z obiektu EventDispatcher. | EventDispatcher | |
Używane przez środowisko wykonawcze do zgłaszania błędów. | MediaPromise | ||
|
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | |
|
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | |
|
Zwraca ciąg reprezentujący określony obiekt. | Object | |
|
Zwraca pierwotną wartość dla określonego obiektu. | Object | |
|
Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych. | EventDispatcher | |
| Zdarzenie | Podsumowanie | Zdefiniowane przez | ||
|---|---|---|---|---|
| [zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja środowiska wykonawczego AIR uzyskuje fokus w systemie operacyjnym i przechodzi w stan aktywny. | EventDispatcher | ||
| Obiekt MediaPromise wywołuje zdarzenie „close” po zamknięciu pierwotnego strumienia danych. | MediaPromise | |||
| Obiekt MediaPromise wywołuje zdarzenie „complete”, gdy wszystkie dane są odczytane. | MediaPromise | |||
| [zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny. | EventDispatcher | ||
| Obiekt MediaPromise wywołuje zdarzenie ioError w przypadku wystąpienia błędu podczas odczytu pierwotnego strumienia danych. | MediaPromise | |||
| Obiekt MediaPromise wywołuje zdarzenia „progress” w miarę udostępnienia danych. | MediaPromise | |||
file | właściwość |
file:File [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 2.5 |
Wystąpienie klasy File reprezentujące obiekt multimedialny (o ile istnieje).
Ta właściwość odnosi się do obiektu File, jeśli pierwotne źródło danych jest plikiem i aplikacja ma dostęp do tego pliku. Jeśli tak nie jest, ta właściwość przyjmuje wartość null.
Implementacja
public function get file():File isAsync | właściwość |
mediaType | właściwość |
mediaType:String [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 2.5 |
Ogólny typ multimedialny — obraz lub wideo.
Dopuszczalne wartości tej właściwości są zdefiniowane przez stałe w klasie MediaType:
- MediaType.IMAGE
- MediaType.VIDEO
Implementacja
public function get mediaType():StringPowiązane elementy interfejsu API
relativePath | właściwość |
relativePath:String [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 2.5 |
Nazwa pliku obiektu multimedialnego (o ile istnieje).
Nazwa pliku jest dostępna, jeśli pierwotne źródło danych jest plikowe i aplikacja ma dostęp do tego pliku. Jeśli tak nie jest, ta właściwość przyjmuje wartość null.
Implementacja
public function get relativePath():Stringclose | () | metoda |
public function close():void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 2.5 |
Zamyka źródło danych.
open | () | metoda |
public function open():IDataInput| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 2.5 |
Otwiera pierwotne źródło danych i zwraca wystąpienie klasy IDataInput, umożliwiając odczyt źródła.
Jeśli pierwotne źródło danych jest asynchroniczne, obiekt MediaPromise wywołuje zdarzenia progress i complete wskazujące, czy dane są dostępne do odczytu. Jeżeli źródło danych jest synchroniczne, wszystkie dane są dostępne natychmiast i te zdarzenia nie są wywoływane.
Uwaga: Zamiast ręcznie odczytywać dane, można wczytać obiekt MediaPromise przy użyciu metody loadFilePromise() klasy Loader.
IDataInput |
Powiązane elementy interfejsu API
reportError | () | metoda |
public function reportError(e:ErrorEvent):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 2.5 |
Używane przez środowisko wykonawcze do zgłaszania błędów.
Kod aplikacji nie powinien wywoływać tej metody.
Parametry
e:ErrorEvent — Zdarzenie „error” do wywołania.
|
close | Zdarzenie |
flash.events.Eventwłaściwość Event.type =
flash.events.Event.CLOSE| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 2.5 |
Obiekt MediaPromise wywołuje zdarzenie close po zamknięciu pierwotnego strumienia danych.
Event.CLOSE definiuje wartość właściwości type obiektu zdarzenia close.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
bubbles | false |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
target | Obiekt, którego połączenie zostało zamknięte. |
complete | Zdarzenie |
flash.events.Eventwłaściwość Event.type =
flash.events.Event.COMPLETE| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 2.5 |
Obiekt MediaPromise wywołuje zdarzenie complete, gdy wszystkie dane są odczytane. Zdarzenie to wskazuje, że nie ma więcej danych dostępnych w strumieniu pierwotnym.
Zdarzenie complete nie jest wywoływane przez asynchroniczne źródło danych.
Event.COMPLETE definiuje wartość właściwości type obiektu zdarzenia complete.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
bubbles | false |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
target | Obiekt sieciowy, którego ładowanie zostało ukończone. |
ioError | Zdarzenie |
flash.events.IOErrorEventwłaściwość IOErrorEvent.type =
flash.events.IOErrorEvent.IOERROR| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 2.5 |
Obiekt MediaPromise wywołuje zdarzenie ioError w przypadku wystąpienia błędu podczas odczytu pierwotnego strumienia danych. Po wywołaniu tego zdarzenia nie można odczytać więcej danych.
progress | Zdarzenie |
flash.events.ProgressEventwłaściwość ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 2.5 |
Obiekt MediaPromise wywołuje zdarzenia progress w miarę udostępnienia danych.
Właściwość bytesTotal ma wartość 0 dla wszystkich zdarzeń „progress” oprócz ostatniego. Jeśli wszystkie dane będą dostępne natychmiast, może nie zostać wywołane żadne zdarzenie progress. Asynchroniczne źródła danych nie wywołują żadnych zdarzeń progress.
type obiektu zdarzenia progress.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
bubbles | false |
bytesLoaded | Liczba elementów lub bajtów załadowanych w momencie, w którym detektor przetwarza zdarzenie. |
bytesTotal | Łączna liczba elementów lub bajtów, które zostaną ostatecznie załadowane w razie pomyślnego zakończenia operacji ładowania. |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
target | Obiekt informujący o postępie. |
Tue Jun 12 2018, 12:06 PM Z