RSLInfo  - AS3 Flash

Określa liczbę bajtów załadowanych do tej pory łącznie dla wszystkich ładowanych plików. Ponieważ niektóre operacje pobierania mogą zakończyć się niepowodzeniem i zostać przełączone na rezerwowe adresy URL, wartość bytesLoaded może się z czasem zwiększać lub zmniejszać. Należy uwzględnić ten fakt przy realizacji pasków postępu, aby uniknąć efektu cofania się paska.

Określa łączną liczbę bajtów załadowanych do tej pory łącznie dla wszystkich ładowanych plików. Ponieważ niektóre operacje pobierania mogą zakończyć się niepowodzeniem i zostać przełączone na rezerwowe adresy URL, wartość bytesTotal może się z czasem zwiększać lub zmniejszać. Należy uwzględnić ten fakt przy realizacji pasków postępu, aby uniknąć efektu cofania się paska.

Zwraca wartość true, jeśli pobieranie zakończyło się pomyślnie, albo false, jeśli nie zostało jeszcze ukończone lub nie powiodło się.

Zwraca indeks adresu URL używanego w bieżącej próbie pobierania. Po odebraniu zdarzenia niepowodzenia ten indeks wskazuje na adres URL, spod którego nie powiodło się pobieranie. Indeks wskazuje pozycję w tablicach rslURLs i policyFileURLs. Przed rozpoczęciem pobierania indeks ma wartość -1. Po ukończeniu pobierania indeks jest równy długości tablic, dlatego zaleca się sprawdzenie zakresu przed użyciem tej wartości w celu uzyskania dostępu do elementu tablicy adresów URL.

         import fl.rsl.RSLInfo;
         var info:RSLInfo = new RSLInfo();
         info.addEventListener(IOErrorEvent.IO_ERROR, handleErr);
         function handleErr(e:Event) {
         trace('error: ' + e);
         trace('on download of url: ' + info.rslURLs[info.currentAttemptIndex]);
         }
         

Zwraca wartość true, jeśli pobieranie nie powiodło się, albo false, jeśli nie zostało jeszcze ukończone lub zakończyło się pomyślnie. Wartość failed nie jest ustawiana na true, jeśli pobieranie z jednego adresu URL nie powiodło się, ale istnieją dodatkowe rezerwowe adresy URL, z których można próbować pobrać plik.

Zwraca obiekt ładujący używany do pobierania pliku RSL. Może mieć wartość NULL. Instancja obiektu ładującego jest tworzona po wywołaniu metody load().

Zwraca tablicę adresów URL plików reguł dodanych za pomocą metody addEntry(). Tablicę tę należy traktować jak przeznaczoną tylko do odczytu. Wpisy należy dodawać za pomocą metody addEntry(). Bezpośrednia modyfikacja tablicy doprowadzi do nieprzewidzianych rezultatów.

         import fl.rsl.RSLInfo;
         var info:RSLInfo = new RSLInfo();
         for (var i:int = 0; i < info.policyFileURLs.length; i++) {
            trace('url: ' + info.policyFileURLs[i]);
         }
         

Powiązane elementy interfejsu API

Zwraca tablicę adresów URL plików RSL dodanych za pomocą metody addEntry(). Tablicę tę należy traktować jak przeznaczoną tylko do odczytu. Wpisy należy dodawać za pomocą metody addEntry(). Bezpośrednia modyfikacja tablicy doprowadzi do nieprzewidzianych rezultatów.

         import fl.rsl.RSLInfo;
         var info:RSLInfo = new RSLInfo();
         for (var i:int = 0; i < info.rslURLs.length; i++) {
            trace('url: ' + info.rslURLs[i]);
         }
         

Powiązane elementy interfejsu API

Konstruktor.

Dodaje szereg adresów URL (plików RSL i plików reguł). Kolejność dodawania adresów URL zależy od priorytetu ich pobierania. Najpierw podejmowana jest próba pobrania z pierwszego adresu URL; próba pobrania z drugiego adresu URL podejmowana jest dopiero po niepowodzeniu pobierania z pierwszego itd. Pliki strategii są dodawane tylko w przypadku pobrania pliku RSL z odpowiedniego adresu URL.

         import fl.rsl.RSLInfo;
         var info:RSLInfo = new RSLInfo();
         info.addEntry('rsl.swf');
         myPreloader.addRSLInfo(info);
         myPreloader.start();
         

Parametry

Rozpoczyna pobieranie pliku RSL. Najpierw podejmowana jest próba pobrania spod pierwszego adresu URL. Kolejne wpisy są testowane dopiero w wypadku niepowodzenia pobierania z poprzedniego adresu.