ActionScript® 3.0 — dokumentacja dla platformy Adobe® Flash®
Strona główna  |  Ukryj listę pakietów i klas |  Pakiety  |  Klasy  |  Nowości  |  Indeks  |  Dodatki  |  Dlaczego język angielski?
Filtry: Pobieranie danych z serwera...
Pobieranie danych z serwera...
flash.media 

MediaPromise  - AS3

Pakietflash.media
Klasapublic class MediaPromise
DziedziczenieMediaPromise Inheritance EventDispatcher Inheritance Object
Implementuje IFilePromise

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 2.5

Klasa MediaPromise oznacza przyrzeczenie dostarczenia obiektu multimedialnego.

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

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

Właściwości publiczne
 WłaściwośćZdefiniowane przez
 Inheritedconstructor : 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
Metody publiczne
 MetodaZdefiniowane przez
 Inherited
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
  
    close():void
Zamyka źródło danych.
MediaPromise
 Inherited
dispatchEvent(event:Event):Boolean
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń.
EventDispatcher
 Inherited
hasEventListener(type:String):Boolean
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń.
EventDispatcher
 Inherited
hasOwnProperty(name:String):Boolean
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość.
Object
 Inherited
isPrototypeOf(theClass:Object):Boolean
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr.
Object
  
    open():IDataInput
Otwiera pierwotne źródło danych i zwraca wystąpienie klasy IDataInput, umożliwiając odczyt źródła.
MediaPromise
 Inherited
propertyIsEnumerable(name:String):Boolean
Wskazuje, czy określona właściwość istnieje i jest przeliczalna.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Usuwa detektor z obiektu EventDispatcher.
EventDispatcher
  
    reportError(e:ErrorEvent):void
Używane przez środowisko wykonawcze do zgłaszania błędów.
MediaPromise
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
Ustawia dostępność właściwości dynamicznej używanej w pętlach.
Object
 Inherited
toLocaleString():String
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych.
Object
 Inherited
toString():String
Zwraca ciąg reprezentujący określony obiekt.
Object
 Inherited
valueOf():Object
Zwraca pierwotną wartość dla określonego obiektu.
Object
 Inherited
willTrigger(type:String):Boolean
Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych.
EventDispatcher
Zdarzenia
Kliknij, aby uzyskać więcej informacji o zdarzeniach
 Zdarzenie Podsumowanie Zdefiniowane przez
 Inherited
activate
[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja środowiska wykonawczego AIR uzyskuje fokus w systemie operacyjnym i przechodzi w stan aktywny.EventDispatcher
  
    close
Obiekt MediaPromise wywołuje zdarzenie „close” po zamknięciu pierwotnego strumienia danych.MediaPromise
  
    complete
Obiekt MediaPromise wywołuje zdarzenie „complete”, gdy wszystkie dane są odczytane.MediaPromise
 Inherited
deactivate
[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny.EventDispatcher
  
    ioError
Obiekt MediaPromise wywołuje zdarzenie ioError w przypadku wystąpienia błędu podczas odczytu pierwotnego strumienia danych.MediaPromise
  
    progress
Obiekt MediaPromise wywołuje zdarzenia „progress” w miarę udostępnienia danych.MediaPromise
Szczegół właściwości
    

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ść 
isAsync:Boolean  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 2.5

Wskazuje, czy pierwotne źródło danych jest asynchroniczne czy synchroniczne.



Implementacja
    public function get isAsync():Boolean
    

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():String

Powiązane elementy interfejsu API

MediaType
    

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():String
Szczegół metody

    close

()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.

Zwraca
IDataInput

Powiązane elementy interfejsu API

Loader.loadFilePromise()

    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.

Szczegół zdarzenia
    

close

 Zdarzenie
Typ obiektu zdarzenia: flash.events.Event
wł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.

Stała 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ść
bubblesfalse
cancelablefalse; nie ma domyślnego zachowania, które można byłoby anulować.
currentTargetObiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
targetObiekt, którego połączenie zostało zamknięte.
    

complete

 Zdarzenie  
Typ obiektu zdarzenia: flash.events.Event
wł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.

Stała 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ść
bubblesfalse
cancelablefalse; nie ma domyślnego zachowania, które można byłoby anulować.
currentTargetObiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
targetObiekt sieciowy, którego ładowanie zostało ukończone.
    

ioError

 Zdarzenie  
Typ obiektu zdarzenia: flash.events.IOErrorEvent
wł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  
Typ obiektu zdarzenia: flash.events.ProgressEvent
wł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.

Definiuje wartość właściwości type obiektu zdarzenia progress.

To zdarzenie ma następujące właściwości:

WłaściwośćWartość
bubblesfalse
bytesLoadedLiczba 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.
cancelablefalse; nie ma domyślnego zachowania, które można byłoby anulować.
currentTargetObiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
targetObiekt informujący o postępie.



© 2015 Adobe Systems Incorporated. All rights reserved.
Tue Jun 12 2018, 12:06 PM Z
 

 

Informacje prawne | Zasady prywatności online
[ X ]Dlaczego język angielski?
Treść dokumentacji języka ActionScript 3.0 wyświetlana w języku angielskim

Niektóre części dokumentacji języka ActionScript 3.0 nie są przetłumaczone na poszczególne języki. Gdy element nie jest przetłumaczony na dany język, jest wyświetlany tekst angielski. Na przykład opis klasy ga.controls.HelpBox nie jest przetłumaczony na żaden dodatkowy język. Z tego powodu polska wersja dokumentacji zawiera opis klasy ga.controls.HelpBox w języku angielskim.