Pakiet | fl.rsl |
Klasa | public class RSLPreloader |
Dziedziczenie | RSLPreloader EventDispatcher Object |
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS5 |
Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2 |
RSLEvent.RSL_LOAD_COMPLETE
, RSLErrorEvent.RSL_LOAD_FAILED
lub RSLEvent.RSL_PROGRESS
) informujące o statusie ładowania pliku RSL.
Powiązane elementy interfejsu API
Właściwość | Zdefiniowane przez | ||
---|---|---|---|
constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | ||
debugWaitTime : int
Należy ustawić tę wartość na czas oczekiwania (w milisekundach) przed rozpoczęciem pobierania pierwszego pliku RSL. | RSLPreloader | ||
numRSLInfos : int [tylko do odczytu]
Liczba instancji klasy RSLInfo dodanych za pomocą metody addRSLInfo(). | RSLPreloader |
Metoda | Zdefiniowane przez | ||
---|---|---|---|
RSLPreloader(mainTimeline:MovieClip = null)
Konstruktor. | RSLPreloader | ||
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 | ||
Dodaje opisowy rekord RSLInfo do pobieranego pliku SWF lub SWZ. | RSLPreloader | ||
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń. | EventDispatcher | ||
Odczytuje rekord RSLInfo dodany za pomocą metody addRSLInfo() w określonym indeksie. | RSLPreloader | ||
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 | ||
Metoda loadContent jest wywoływana z klatki 2 opakowującego pliku SWF, gdy nazwa klasy treści zostanie przekazana do metody start(). | RSLPreloader | ||
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | ||
Usuwa detektor z obiektu EventDispatcher. | EventDispatcher | ||
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | ||
Rozpoczyna pobieranie plików RSL. | RSLPreloader | ||
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 | |||
[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny. | EventDispatcher | |||
Wywoływane przez obiekt RSLPreloader po zakończeniu pobierania wszystkich plików RSL. | RSLPreloader | |||
Wywoływane przez obiekt RSLPreloader po zakończeniu pobierania wszystkich plików RSL, gdy w co najmniej jednym przypadku pobieranie nie powiodło się. | RSLPreloader | |||
Wywoływane przez obiekt RSLPreloader w celu przekazania informacji o postępie pobierania plików RSL. | RSLPreloader |
debugWaitTime | właściwość |
debugWaitTime:int
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS5 |
Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2 |
Należy ustawić tę wartość na czas oczekiwania (w milisekundach) przed rozpoczęciem pobierania pierwszego pliku RSL. W ten sposób można zasymulować działanie aplikacji z perspektywy użytkownika końcowego i przetestować pętlę ładowania wstępnego. Opisywana technika jest szczególne przydatna przy testowaniu podpisanych buforowanych plików RSL (plików SWZ), ponieważ umożliwia wbudowanie opóźnienia bez opróżniania pamięci podręcznej plików SWZ. Przed wdrożeniem aplikacji należy dezaktywować kod ustawiający opóźnienie większe od 0. W celu wywołania kodu należy użyć stałej konfiguracji debugowania (takiej jak CONFIG::DEBUG
). Inne rozwiązanie polega na ustawieniu stosunkowo DŁUGIEGO opóźnienia, np. 5000 (5 sekund), które będzie przypominać programiście o konieczności usunięcia kodu używanego do debugowania. W przypadku instancji klasy RSLLoader generowanych automatycznie przez narzędzie do tworzenia treści opóźnienie można ustawić, definiując metodę setRSLPreloader(value:RSLPreloader):void
w pliku SWF ładowania animacji lub w kodzie głównej osi czasu.
import fl.rsl.RSLPreloader; function setRSLPreloader(preloader:RSLPreloader):void { preloader.debugWaitTime = 10000; }
Wartością domyślną jest 0.
Implementacja
public function get debugWaitTime():int
public function set debugWaitTime(value:int):void
numRSLInfos | właściwość |
numRSLInfos:int
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS5 |
Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2 |
Liczba instancji klasy RSLInfo dodanych za pomocą metody addRSLInfo()
.
for(var i:int = 0; i < myPreloader.numRSLInfos; i++) { trace('rsl ' + i); var urls:Array = myPreloader.getRSLInfoAt(i).rslURLs; for(var j:int = 0; j < urls.length; j++) { trace(' url: ' + urls[j]); } }
Implementacja
public function get numRSLInfos():int
Powiązane elementy interfejsu API
RSLPreloader | () | Konstruktor |
public function RSLPreloader(mainTimeline:MovieClip = null)
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS5 |
Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2 |
Konstruktor. Gdy narzędzie do tworzenia treści automatycznie zapisuje kod we wstępnie ładowanych plikach SWZ, przekazuje jako argument główną klasę osi czasu. Taki argument nie jest z reguły przydatny w kodzie pisanym przez użytkownika.
ParametrymainTimeline:MovieClip (default = null )
|
addRSLInfo | () | metoda |
public function addRSLInfo(info:RSLInfo):void
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS5 |
Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2 |
Dodaje opisowy rekord RSLInfo do pobieranego pliku SWF lub SWZ.
import fl.rsl.RSLInfo; var info:RSLInfo = new RSLInfo(); info.addEntry('rsl.swf'); myPreloader.addRSLInfo(info); myPreloader.start();
Parametry
info:RSLInfo |
getRSLInfoAt | () | metoda |
public function getRSLInfoAt(index:int):RSLInfo
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS5 |
Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2 |
Odczytuje rekord RSLInfo dodany za pomocą metody addRSLInfo()
w określonym indeksie. Indeks odzwierciedlający kolejność dodawania rekordów za pomocą metody addRSLInfo()
.
for (var i:int = 0; i < myPreloader.numRSLInfos; i++) { trace('rsl ' + i); var urls:Array = myPreloader.getRSLInfoAt(i).rslURLs; for (var j:int = 0; j < urls.length; j++) { trace(' url: ' + urls[j]); } }
Parametry
index:int |
RSLInfo |
Powiązane elementy interfejsu API
loadContent | () | metoda |
public function loadContent():void
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS5 |
Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2 |
Metoda loadContent jest wywoływana z klatki 2 opakowującego pliku SWF, gdy nazwa klasy treści zostanie przekazana do metody start(). Z reguły nie jest używana w kodzie pisanym przez użytkownika.
Powiązane elementy interfejsu API
start | () | metoda |
public function start(preloaderAnimClass:Class = null, contentClassName:String = null):void
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS5 |
Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2 |
Rozpoczyna pobieranie plików RSL. Tej funkcji nie należy wywoływać, zanim wszystkie rekordy RSLInfo nie zostaną oddane za pomocą metody addRSLInfo()
. Gdy narzędzie do tworzenia treści automatycznie generuje kod, możliwe jest użycie dwóch argumentów opcjonalnych. Pierwszym jest podklasa ByteArray służąca do ładowania animacji w pliku SWF ładującym wstępnie treść. Drugim argumentem jest nazwa podklasy ByteArray dla pliku SWF treści. Te argumenty z reguły nie są używane w kodzie pisanym przez użytkownika.
Parametry
preloaderAnimClass:Class (default = null )
| |
contentClassName:String (default = null )
|
Powiązane elementy interfejsu API
rslLoadComplete | Zdarzenie |
fl.events.RSLEvent
właściwość RSLEvent.type =
fl.events.RSLEvent.RSL_LOAD_COMPLETE
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS5 |
Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2 |
Wywoływane przez obiekt RSLPreloader po zakończeniu pobierania wszystkich plików RSL.
Zdarzenie wywoływane przez obiektRSLPreloader
po pomyślnym zakończeniu pobierania wszystkich plików RSL. Dla zdarzeń tego typu właściwości bytesLoaded
i bytesTotal
są zawsze równe 0. W przypadku wstępnego ładowania przy użyciu niestandardowej pętli zdarzeń treść użytkownika MUSI wykrywać to zdarzenie, aby we właściwym momencie wyjść z pętli ładowania animacji.
To zdarzenie ma następujące właściwości:
Właściwość | Wartość |
---|---|
bubbles | true |
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 | Instancja klasy DisplayObject dodawana do listy wyświetlania. Obiekt target nie zawsze jest obiektem na liście wyświetlania, która zarejestrowała detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie. |
rslsLoaded | Liczba plików, które zostały pomyślnie pobrane. |
rslsFailed | Liczba plików, których pobieranie nie powiodło się. |
rslsTotal | Łączna liczba plików, które były pobierane, pomyślnie i niepomyślnie. |
bytesLoaded | Łączna liczba pobranych bajtów w plikach, które zostały pomyślnie pobrane. |
bytesTotal | Łączna liczba pobranych bajtów w plikach, których pobieranie zostało zakończone pomyślnie lub niepomyślnie. |
import fl.events.RSLEvent; myPreloader.addEventListener(RSLEvent.RSL_LOAD_COMPLETE, loadComplete); function loadComplete(e:RSLEvent) { gotoAndPlay('startOfContent'); }
rslLoadFailed | Zdarzenie |
fl.events.RSLErrorEvent
właściwość RSLErrorEvent.type =
fl.events.RSLErrorEvent.RSL_LOAD_FAILED
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS5 |
Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2 |
Wywoływane przez obiekt RSLPreloader po zakończeniu pobierania wszystkich plików RSL, gdy w co najmniej jednym przypadku pobieranie nie powiodło się.
Błąd wywoływany przez obiektRSLPreloader
, gdy pobieranie wszystkich plików RSL zostało zakończone, a pobieranie dla jednego lub większej liczby nie powiodło się. W przypadku wstępnego ładowania przy użyciu niestandardowej pętli zdarzeń treść użytkownika MUSI wykrywać to zdarzenie, aby we właściwym momencie wyjść z pętli ładowania animacji.
To zdarzenie ma następujące właściwości:
Właściwość | Wartość |
---|---|
bubbles | true |
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 | Instancja klasy DisplayObject dodawana do listy wyświetlania. Obiekt target nie zawsze jest obiektem na liście wyświetlania, która zarejestrowała detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie. |
rslsLoaded | Liczba plików, które zostały pomyślnie pobrane. |
rslsFailed | Liczba plików, których pobieranie nie powiodło się. |
rslsTotal | Łączna liczba plików, które były pobierane, pomyślnie i niepomyślnie. |
failedURLs | Tablica plików, których pobieranie nie powiodło się. |
import fl.events.RSLErrorEvent; myPreloader.addEventListener(RSLErrorEvent.RSL_LOAD_FAILED, rslLoadFailedHandler); function rslLoadFailedHandler(e:RSLErrorEvent) { gotoAndPlay('rslLoadFailure'); }
rslProgress | Zdarzenie |
fl.events.RSLEvent
właściwość RSLEvent.type =
fl.events.RSLEvent.RSL_PROGRESS
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | Flash CS5 |
Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2 |
Wywoływane przez obiekt RSLPreloader w celu przekazania informacji o postępie pobierania plików RSL.
Zdarzenie wywoływane przez obiektRSLPreloader
w celu wskazania postępu pobierania plików RSL. Jedyny typ zdarzenia, dla którego właściwości bytesLoaded
i bytesTotal
są niezerowe.
To zdarzenie ma następujące właściwości:
Właściwość | Wartość |
---|---|
bubbles | true |
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 | Instancja klasy DisplayObject dodawana do listy wyświetlania. Obiekt target nie zawsze jest obiektem na liście wyświetlania, która zarejestrowała detektor zdarzeń. Właściwość currentTarget umożliwia uzyskanie dostępu do obiektu na liście wyświetlania, który obecnie przetwarza zdarzenie. |
rslsLoaded | Liczba plików, które zostały pomyślnie pobrane. |
rslsFailed | Liczba plików, których pobieranie nie powiodło się. |
rslsTotal | Łączna liczba plików, które były pobierane, pomyślnie i niepomyślnie. |
bytesLoaded | Łączna liczba pobranych bajtów w plikach, które zostały pomyślnie pobrane. |
bytesTotal | Łączna liczba pobranych bajtów w plikach, których pobieranie zostało zakończone pomyślnie lub niepomyślnie. |
import fl.events.RSLEvent; myPreloader.addEventListener(RSLEvent.RSL_PROGRESS, progressHandler); function progressHandler(e:RSLEvent) { trace('rslsLoaded = ' + e.rslsLoaded); trace('rslsFailed = ' + e.rslsFailed); trace('rslsTotal = ' + e.rslsTotal); trace('bytesLoaded = ' + e.bytesLoaded); trace('bytesTotal = ' + e.bytesTotal); }
Tue Jun 12 2018, 12:06 PM Z