ProLoader  - AS3 Flash

Zawiera główny obiekt wyświetlany pliku SWF lub plik obrazu (JPG, PNG lub GIF), który został załadowany przy pomocy metod load() lub loadBytes().

Zwraca obiekt ProLoaderInfo odpowiadający aktualnie wczytywanemu obiektowi. Obiekty ProLoaderInfo są współdzielone przez obiekt ProLoader i obiekt wczytanej zawartości. Obiekt ProLoaderInfo udostępnia informacje o postępie wczytywania oraz dane statystyczne wczytywanego pliku.

Zdarzenia związane z wczytywaniem są wywoływane przez obiekt ProLoaderInfo, do którego odnosi się właściwość contentLoaderInfo obiektu ProLoader. Właściwość contentLoaderInfo jest ustawiana na prawidłowy obiekt ProLoaderInfo jeszcze przed wczytaniem zawartości, co pozwala na dodawanie detektorów zdarzeń do obiektu przed wczytywaniem.

Do wykrywania nieprzechwyconych błędów wywołanych we wczytanym pliku SWF należy używać właściwości ProLoader.uncaughtErrorEvents, a nie właściwości ProLoader.contentLoaderInfo.uncaughtErrorEvents.

Uwaga: Właściwość contentLoaderInfo zwraca obiekt ProLoaderInfo. Klasa ProLoaderInfo nie jest podklasą klasy LoaderInfo, dlatego nie pozwala stosować niejawnego rzutowania na klasę nadrzędną. Z tego powodu należy pamiętać o zmianie deklaracji typu LoaderInfo na ProLoaderInfo.

Obiekt, który wywołuje zdarzenie uncaughtError, gdy w kodzie pliku SWF tego obiektu ProLoader wystąpi nieobsłużony błąd. Sytuacja taka ma miejsce, gdy błąd zostanie wywołany poza blokiem try..catch lub gdy zostanie wywołany obiekt zdarzenia ErrorEvent, dla którego nie zarejestrowano żadnych detektorów.

Ta właściwość jest tworzona po zakończeniu wczytywania pliku przez ten obiekt. Do tego czasu właściwość uncaughtErrorEvents jest równa null. W projektach opartych tylko na języku ActionScript dostęp do tej właściwości można uzyskać podczas wykonywania funkcji konstruktora klasy głównej pliku SWF lub po jej wykonaniu.

Uzyskanie dostępu do tej właściwości obiektu ProLoader w odtwarzaczu, który nie obsługuje tej właściwości, powoduje błąd. Zwraca obiekt EventDispatcher, a nie UncaughtErrorEvents, aby uniknąć generowania błędów w nieobsługiwanych odtwarzaczach.

Powiązane elementy interfejsu API

Tworzy obiekt ProLoader, który umożliwia wczytywanie plików w formatach SWF, JPEG, GIF i PNG. Należy wywołać metodę load() w celu wczytania zasobu jako elementu potomnego wystąpienia klasy ProLoader. Następnie można dodać obiekt ProLoader do listy wyświetlania, używając na przykład metody addChild() wystąpienia klasy DisplayObjectContainer. Zasób zostanie wyświetlony na stole montażowym po wczytaniu.

Wystąpienia klasy ProLoader można także użyć w trybie określanym jako „poza listą” — bez dodawania wystąpienia do kontenera obiektów ekranowych na liście wyświetlania. W tym trybie wystąpienie klasy Loader może służyc do wczytywania pliku SWF zawierającego dodatkowe moduły aplikacji.

W celu wykrycia momentu zakończenia wczytywania pliku SWF można użyć zdarzeń obiektu ProLoaderInfo skojarzonego z właściwością contentLoaderInfo obiektu ProLoader. W tym momencie kod znajdujący się w pliku modułu SWF może zostać wykonany w celu zainicjowania i uruchomienia modułu. W trybie poza listą wystąpienie klasy ProLoader pozwala także wczytać plik SWF zawierający składniki lub zasoby multimedialne. Również w takiej sytuacji dzięki powiadomieniom o zdarzeniach obiektu ProLoaderInfo można wykrywać znaczniki, których wczytywanie zostało zakończone. W tym momencie aplikacja może zacząć korzystać ze składników i zasobów multimedialnych w bibliotece pliku SWF przez utworzenie wystąpień klas języka ActionScript 3.0, które reprezentują te składniki i zasoby.

W celu określenia stanu obiektu ProLoader należy monitorować następujące zdarzenia skojarzone z właściwością contentLoaderInfo obiektu ProLoaderInfo:

• Zdarzenie open jest wywoływane przy rozpoczęciu ładowania.
• Zdarzenie ioError lub securityError jest wywoływane, w sytuacji gdy plik nie może być załadowany lub przy wystąpieniu błędu w trakcie ładowania.
• Zdarzenie progress jest wywoływane ciągle w trakcie ładowania pliku.
• Zdarzenie complete jest wywoływane w momencie zakończenia wczytywania pliku, ale przed udostępnieniem metod i właściwości wczytanego klipu filmowego. Jeśli plik SWF używa wstępnego wczytywania RSL, to zdarzenie jest wywoływane po zakończeniu tej operacji. W tym momencie właściwość content pozwala uzyskać dostęp do rzeczywistej zawartości.
• Zdarzenie init jest wywoływane po udostępnieniu właściwości i metod załadowanego pliku SWF, co umożliwia jego manipulację. Zdarzenie jest wywoływane przed procedurą obsługi zdarzenia complete. Przy strumieniowaniu plików SWF zdarzenie init może pojawić się znacznie wcześniej niż zdarzenie complete. W większości przypadków należy korzystać z modułu obsługi zdarzenia init. Jeśli plik SWF używa wstępnego wczytywania RSL, to zdarzenie jest wywoływane po zakończeniu tej operacji. W tym momencie właściwość content pozwala uzyskać dostęp do rzeczywistej zawartości.

Powiązane elementy interfejsu API

Anuluje działanie metody load(), która jest obecnie aktywna dla wystąpienia klasy ProLoader.

Wczytuje plik SWF, JPEG, PNG, JPEG progresywny lub GIF bez animacji do obiektu potomnego tego obiektu ProLoader. W przypadku wczytywania animowanego pliku GIF wyświetlana jest tylko pierwsza klatka. Obiekt ProLoader może zawierać tylko jeden element potomny, dlatego kolejne żądanie load() kończy poprzednie żądanie (jeśli nadal oczekuje na wykonanie) i rozpoczyna nowe wczytywanie.

Uwaga: W środowisku AIR 1.5 i programie Flash Player 10 maksymalna szerokość i wysokość ładowanego obrazu wynosi 8191 pikseli, a łączna liczba pikseli nie może przekroczyć 16 777 215. (A zatem, jeśli ładowany obraz ma szerokość 8,191 pikseli, nie może być wyższy niż 2048 pikseli). W prorgamie Flash Player 9 i wcześniejszych wersjach oraz w środowisku AIR 1.1 i wcześniejszych wersjach ograniczenie wysokości i szerokości wynosiło 2880 pikseli.

Plik SWF lub obraz wczytany do obiektu ProLoader dziedziczy właściwości położenia, obrotu i skali macierzystych obiektów ekranowych obiektu ProLoader.

Należy stosować metodę unload() do usuwania filmów lub obrazów załadowanych tą metodą, lub do anulowania operacji ładowania będących w trakcie wykonywania.

Istnieje możliwość zablokowania używania tej metody przez plik SWF. W tym celu należy ustawić parametr allowNetworking znaczników object oraz embed na stronie HTML zawierającej zawartość SWF.

Korzystając z tej metody, należy uwzględnić model zabezpieczeń programu Flash Player, który został przedstawiony w opisie klasy ProLoader.

W programie Flash Player 10 i nowszych wersjach, jeśli użyty zostanie wieloczęściowy nagłówek Content-Type (np. "multipart/form-data"), w którym przesyłane są pliki (wskazywane przez parametr "filename" w nagłówku "content-disposition" w treści operacji POST), wówczas operacja POST podlega regułom zabezpieczeń zastosowanym do wysyłania plików:

• Operację POST należy wykonać w odpowiedzi na działanie zainicjowane przez użytkownika, np. kliknięcie myszy lub naciśnięcie klawisza.
• Jeśli operacja POST jest operacją międzydomenową (cel operacji POST nie znajduje się na tym samym serwerze, co plik SWF, który wysyła żądanie POST), docelowy serwer musi dostarczyć plik reguł URL, który zezwoli na międzydomenowy dostęp.

Dla dowolnego wieloczęściowego nagłówka Content-Type również składnia musi być poprawna (zgodnie ze standardem RFC2046). Jeśli składnia okaże się niepoprawna, operacja POST będzie podlegać regułom zabezpieczeń stosowanym do wysyłania plików.

Więcej informacji na temat zabezpieczeń zawiera odpowiedni temat w Centrum programistów programu Flash Player w kategorii Bezpieczeństwo.

Parametry

Powiązane elementy interfejsu API

Wczytuje dane binarne przechowywane w obiekcie ByteArray.

Metoda loadBytes() jest asynchroniczna. Przed uzyskaniem dostępu do właściwości załadowanego obiektu należy poczekać na zdarzenie "init".

Korzystając z tej metody, należy uwzględnić model zabezpieczeń programu Flash Player, który został przedstawiony w opisie klasy ProLoader.

Parametry

Powiązane elementy interfejsu API

Wczytuje wystąpienie klasy IFilePromise za pośrednictwem parametru promise. Dla typu parametru promise jest używana klasa nadrzędna Object, a nie IFilePromise. Ma to na celu uniknięcie występowania błędów w innych odtwarzaczach.

Metoda loadFilePromise przyjmuje obiekt IFilePromise i wczytuje dane binarne. Jeśli dane są w strumieniu progresywnym, na przykład jest to materiał wideo, program czeka na zdarzenia „init” lub „progress” przed uzyskaniem dostępu do właściwości wczytanego obiektu. Jeśli tak nie jest, program czeka na zdarzenie „complete”, aby uzyskać pewność, że dane zostały wczytane do końca.

Korzystając z tej metody, należy uwzględnić model zabezpieczeń programu Flash Player, który został przedstawiony w opisie klasy ProLoader.

Parametry

Powiązane elementy interfejsu API

Usuwa element potomny tego obiektu ProLoader, który został wczytany za pomocą metody load(). Właściwość property skojarzonego obiektu ProLoaderInfo jest zerowana do wartości null. Element potomny nie zawsze jest niszczony, gdyż mogą się do niego odnosić inne obiekty. Przestaje jednak być elementem potomnym obiektu ProLoader.

W ramach najlepszej praktyki przed usunięciem załadowanego podrzędnego pliku SWF koniecznie należ zamknąć wszelkie strumienie w obiektach tego pliku, jak na przykład LocalConnection, NetConnection, NetStream oraz Sound. W innym przypadku audio w podrzędnym pliku SWF może być wciąż odgrywane, mimo iż plik ten został już usunięty. W celu zamknięcia strumieni w potomnym pliku SWF należy dodać detektor zdarzeń do potomka, który nasłuchuje zdarzenia unload. Gdy obiekt macierzysty wywołuje metodę ProLoader.unload(), wówczas do elementu potomnego jest wysyłane zdarzenieunload. Poniższy kod ilustruje sposób realizacji tych działań.

function closeAllStreams(evt:Event) { 
    myNetStream.close();
    mySound.close();
    myNetConnection.close();
    myLocalConnection.close();
}

myMovieClip.loaderInfo.addEventListener(Event.UNLOAD, closeAllStreams);

Powiązane elementy interfejsu API