Pakiet | flash.media |
Klasa | public class AVURLLoader |
Dziedziczenie | AVURLLoader URLLoader EventDispatcher Object |
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Obiekt URLLoader pobiera wszystkie dane z określonego adresu URL, zanim staną się dostępne dla kodu w aplikacjach. Wysyła powiadomienia o postępie pobierania, które można monitorować za pomocą właściwości bytesLoaded
i bytesTotal
, a także za pomocą wywoływanych zdarzeń.
Podczas ładowania bardzo dużych plików wideo, np. plików FLV, mogą pojawić się błędy informujące o braku pamięci.
W przypadku użycia tej klasy w treści aplikacji programu Flash Player lub środowiska AIR w obszarze izolowanym zabezpieczeń aplikacji należy uwzględnić następujący model zabezpieczeń:
- Plik SWF w lokalnym obszarze izolowanym z dostępem do systemu plików nie może wczytywać danych z, i dostarczać danych do, zasobu znajdującego się w obszarze izolowanym sieci.
- Domyślnie wywołujący plik SWF oraz ładowany URL muszą być w tej samej domenie. Na przykład plik SWF na stronie www.adobe.com może ładować dane jedynie ze źródeł, które również znajdują się na stronie www.adobe.com. Aby ładować dane z różnych domen, należy umieścić plik reguł URL na serwerze przechowującym dane.
Więcej informacji na temat zabezpieczeń zawiera odpowiedni temat w Centrum programistów programu Flash Player w kategorii Bezpieczeństwo.
Powiązane elementy interfejsu API
Właściwość | Zdefiniowane przez | ||
---|---|---|---|
bytesLoaded : uint = 0
Ukazuje liczbę bajtów, które zostały pobrane od rozpoczęcia operacji ładowania. | URLLoader | ||
bytesTotal : uint = 0
Ukazuje całkowitą liczbę bajtów pobranych danych. | URLLoader | ||
constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | ||
cookieHeader : String [tylko do zapisu] | AVURLLoader | ||
data : *
Dane uzyskane w wyniku ładowania. | URLLoader | ||
dataFormat : String = "text"
Decyduje o tym, czy pobierane dane mają postać tekstu (URLLoaderDataFormat.TEXT), surowych danych binarnych (URLLoaderDataFormat.BINARY), czy też zmiennych zakodowanych jako adresy URL (URLLoaderDataFormat.VARIABLES). | URLLoader |
Metoda | Zdefiniowane przez | ||
---|---|---|---|
AVURLLoader(request:URLRequest = null)
Tworzy nowy obiekt URLLoader. | AVURLLoader | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [przesłanianie] | AVURLLoader | ||
[przesłanianie]
Kończy trwającą operację wczytywania. | AVURLLoader | ||
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 | ||
[przesłanianie]
Wysyła dane i wczytuje je spod określonego adresu URL. | AVURLLoader | ||
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 | ||
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 | |||
Wywoływana, gdy wszystkie odebrane dane zostały zdekodowane i związane z właściwością danych obiektu URLLoader. | AVURLLoader | |||
[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny. | EventDispatcher | |||
Wywoływane, jeśli wywołanie metody load() skutkuje próbą uzyskania dostępu do danych za pomocą protokołu HTTP i aplikacja Adobe AIR ma możliwość wykrycia i zwrócenia kodu stanu żądania. | AVURLLoader | |||
Wywoływane, jeśli wywołanie URLLoader.load() skutkuje próbą dostępu do danych za pośrednictwem protokołu HTTP. | AVURLLoader | |||
Wywoływane, gdy wywołanie metody URLLoader.load() skutkuje błędem krytycznym, który kończy pobieranie danych. | AVURLLoader | |||
Wywoływana, gdy operacja pobierania rozpoczyna się od wywołania metody URLLoader.load(). | AVURLLoader | |||
Wywoływane w trakcie stopniowego ładowania danych. | AVURLLoader | |||
Wywoływana, jeśli wywołanie metody URLLoader.load() skutkuje próbą pobrania danych z serwera na zewnątrz obszaru izolowanego. | AVURLLoader |
cookieHeader | właściwość |
AVURLLoader | () | Konstruktor |
public function AVURLLoader(request:URLRequest = null)
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Tworzy nowy obiekt URLLoader.
Parametryrequest:URLRequest (default = null ) — Obiekt URLRequest określający adresy URL do pobrania. Jeśli ten parametr zostanie pominięty, żadna operacja load nie zostanie rozpoczęta. Jeśli zostanie określony, operacja load rozpocznie się natychmiastowo (aby uzyskać więcej informacji, należy zapoznać się z sekcją load ).
|
Powiązane elementy interfejsu API
addEventListener | () | metoda |
override public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Parametry
type:String | |
listener:Function | |
useCapture:Boolean (default = false )
| |
priority:int (default = 0 )
| |
useWeakReference:Boolean (default = false )
|
close | () | metoda |
override public function close():void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Kończy trwającą operację ładowania. Wszystkie operacje load wykonywane w danym momencie zostaną natychmiast zakończone. Jeśli żaden adres URL nie jest strumieniowany, zgłoszony zostanie błąd niepoprawnego strumienia.
load | () | metoda |
override public function load(request:URLRequest):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wysyła dane i ładuje je spod określonego adresu URL. W zależności od wartości przekazanej do właściwości dataFormat
odebranymi danymi mogą być tekst, nieprzetworzone dane binarne lub zmienne zakodowane w postaci URL. Należy zauważyć, że wartością domyślną właściwości dataFormat
jest text. Jeśli dane mają być wysyłane do określonego adresu URL, należy ustawić właściwość data
w obiekcie URLRequest.
Uwaga: jeśli ładowany plik zawiera znaki, które nie są znakami ASCII (co zdarza się w wielu językach innych niż angielski), zalecane jest zapisanie pliku z kodowaniem w systemie UTF-8 lub UTF-16.
Plik SWF w lokalnym obszarze izolowanym z dostępem do systemu plików nie może wczytywać danych z, i dostarczać danych do, zasobu znajdującego się w obszarze izolowanym sieci.
Domyślnie wywołujący plik SWF oraz ładowany URL muszą być w tej samej domenie. Na przykład plik SWF na stronie www.adobe.com może ładować dane jedynie ze źródeł, które również znajdują się na stronie www.adobe.com. Aby ładować dane z różnych domen, należy umieścić plik reguł URL na serwerze przechowującym dane.
Nie można połączyć się z portem, który zazwyczaj jest zastrzeżony. Pełną listę zablokowanych portów zawiera sekcja „Ograniczanie sieciowych interfejsów API” w publikacji ActionScript 3.0 — podręcznik dla programistów.
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 standardami 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
request:URLRequest — Obiekt URLRequest określający adresy URL do pobrania.
|
Zdarzenia
complete: — Wywoływane po pomyślnym wczytaniu danych.
| |
httpStatus: — Jeśli dostęp próbowano uzyskać za pomocą protokołu HTTP i bieżące środowisko programu Flash Player obsługuje pobieranie kodów stanu, istnieje możliwość odebrania tych zdarzeń poza zdarzeniami complete i error .
| |
ioError: — Operacja load nie mogła zostać ukończona.
| |
progress: — Wywoływane w trakcie stopniowego wczytywania danych.
| |
securityError: — Operacja load usiłowała pobrać dane z serwera na zewnątrz obszaru izolowanego. Można obejść ten problem używając pliku reguł na serwerze.
| |
securityError: — Operacja load usiłowała załadować plik SWZ (składnik platformy Adobe), ale certyfikat jest nieważny lub skrót jest niezgodny ze składnikiem.
| |
open: — Wywoływane po rozpoczęciu ładowania.
| |
httpResponseStatus: — Wywoływane, jeśli wywołanie metody load() skutkuje próbą uzyskania dostępu do danych za pomocą protokołu HTTP i aplikacja Adobe AIR ma możliwość wykrycia i zwrócenia kodu stanu żądania.
|
Zgłasza
ArgumentError — Obiekty URLRequest.requestHeader mogą nie zawierać pewnych niedozwolonych nagłówków żądań HTTP. Aby uzyskać więcej informacji na ten temat, należy zapoznać się z opisem klasy URLRequestHeader.
| |
MemoryError — Ten błąd może wystąpić z następujących przyczyn: 1) program Flash Player lub środowisko AIR nie może przekonwertować parametru URLRequest.data z kodowania UTF8 na MBCS. Ten błąd ma zastosowanie, gdy obiekt URLRequest przekazany do metody load() został ustawiony, aby przetwarzać operację GET , i jeśli właściwość System.useCodePage ma wartość true . 2) Program Flash Player lub środowisko AIR nie może zaalokować pamięci dla danych operacji POST . Ten błąd ma zastosowanie, gdy obiekt URLRequest przekazany do metody load został ustawiony, aby przetwarzać operację POST .
| |
SecurityError — Niezaufane pliki lokalne mogą nie mieć możliwości komunikowania się z Internetem. Można to obejść przez zaklasyfikowanie tego pliku jako lokalnego pliku z dostępem do sieci lub pliku zaufanego.
| |
SecurityError — Podejmowana jest próba połączenia się z portem, który zazwyczaj jest zastrzeżony. Pełną listę zablokowanych portów zawiera sekcja „Ograniczanie sieciowych interfejsów API” w publikacji ActionScript 3.0 — Podręcznik programistów.
| |
TypeError — Wartością przekazanego parametru request lub właściwością URLRequest.url obiektu URLRequest jest null .
|
Powiązane elementy interfejsu API
URLRequest.requestHeaders
URLRequest.data
URLRequest.digest
complete | Zdarzenie |
flash.events.Event
właściwość Event.type =
flash.events.Event.COMPLETE
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wywoływane, gdy wszystkie odebrane dane zostały zdekodowane i związane z właściwością danych obiektu URLLoader. Dostęp do odebranych danych można uzyskać po wywołaniu tego zdarzenia.
StałaEvent.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. |
Powiązane elementy interfejsu API
httpResponseStatus | Zdarzenie |
flash.events.HTTPStatusEvent
właściwość HTTPStatusEvent.type =
flash.events.HTTPStatusEvent.HTTP_RESPONSE_STATUS
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, AIR 1.0, Flash Lite 4 |
Wywoływane, jeśli wywołanie metody load() skutkuje próbą uzyskania dostępu do danych za pomocą protokołu HTTP i aplikacja Adobe AIR ma możliwość wykrycia i zwrócenia kodu stanu żądania.
W przeciwieństwie do zdarzeniahttpStatus
, zdarzenie httpResponseStatus
jest dostarczane przed danymi odpowiedzi. Ponadto zdarzenia httpResponseStatus
zawiera wartości właściwości responseHeaders
i responseURL
(niezdefiniowane w przypadku zdarzenia httpStatus
). Należy zauważyć, że ewentualne zdarzenie httpResponseStatus
zostanie wysłane przed (i oprócz) wszelkich zdarzeń ukończenia
lubbłędu
.
Stała HTTPStatusEvent.HTTP_RESPONSE_STATUS
definiuje wartość właściwości type
obiektu zdarzenia httpResponseStatus
.
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ń. |
responseURL | Adres URL, z którego została zwrócona odpowiedź. |
responseHeaders | Nagłówki zwróconej odpowiedzi w postaci tablicy obiektów URLRequestHeader. |
status | Zwrócony przez serwer kod stanu HTTP. |
redirected | Czy odpowiedź jest wynikiem przekierowania. |
target | Obiekt sieciowy odbierający kod stanu HTTP. |
Powiązane elementy interfejsu API
httpStatus | Zdarzenie |
flash.events.HTTPStatusEvent
właściwość HTTPStatusEvent.type =
flash.events.HTTPStatusEvent.HTTP_STATUS
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wywoływane, jeśli wywołanie URLLoader.load() skutkuje próbą dostępu do danych za pośrednictwem protokołu HTTP. W przypadku treści działającej w programie Flash Player to zdarzenie jest wywoływane tylko wtedy, gdy bieżące środowisko Flash Player jest w stanie wykryć i zwrócić kod statusu dla żądania. (Niektóre środowiska przeglądarek mogą nie być w stanie zapewnić tych informacji). Należy zauważyć, że ewentualne zdarzenie httpStatus
zostanie wysłane przed (i oprócz) wszelkich zdarzeń complete
luberror
.
HTTPStatusEvent.HTTP_STATUS
definiuje wartość type
właściwości obiektu zdarzenia httpStatus
.
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ń. |
status | Zwrócony przez serwer kod stanu HTTP. |
target | Obiekt sieciowy odbierający kod stanu HTTP. |
Powiązane elementy interfejsu API
ioError | Zdarzenie |
flash.events.IOErrorEvent
właściwość IOErrorEvent.type =
flash.events.IOErrorEvent.IO_ERROR
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wywoływane, gdy wywołanie metody URLLoader.load() skutkuje błędem krytycznym, który kończy pobieranie danych.
Definiuje wartość właściwościtype
obiektu zdarzenia ioError
.
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ń. |
errorID | Numer referencyjny skojarzony z konkretnym błędem (tylko w środowisku AIR). |
target | Obiekt sieciowy, w którym wystąpił błąd wejścia/wyjścia. |
text | Tekst, który ma być wyświetlany w charakterze komunikatu o błędzie. |
Powiązane elementy interfejsu API
open | Zdarzenie |
flash.events.Event
właściwość Event.type =
flash.events.Event.OPEN
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wywoływane, gdy operacja pobierania rozpoczyna się od wywołania metody URLLoader.load()
Event.OPEN
definiuje wartość właściwości type
obiektu zdarzenia open
.
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óry otworzył połączenie. |
Powiązane elementy interfejsu API
progress | Zdarzenie |
flash.events.ProgressEvent
właściwość ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wywoływane w trakcie stopniowego wczytywania danych.
Należy zauważyć, że korzystając z obiektu URLLoader, nie jest możliwe uzyskanie dostępu do danych, dopóki nie zostaną one całkowicie odebrane. Dlatego zdarzenie progress służy jedynie do powiadamiania o postępie pobierania. Aby uzyskać dostęp do danych przed ich całkowitym pobraniem, należy użyć obiektu AVURLStream.
Definiuje wartość właściwościtype
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. |
Powiązane elementy interfejsu API
securityError | Zdarzenie |
flash.events.SecurityErrorEvent
właściwość SecurityErrorEvent.type =
flash.events.SecurityErrorEvent.SECURITY_ERROR
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wywoływane, jeśli wywołanie metody URLLoader.load() skutkuje próbą pobrania danych z serwera na zewnątrz obszaru izolowanego. Wywoływane również, gdy wywołanie metody URLLoader.load()
skutkuje próbą załadowania pliku SWZ, a certyfikat jest nieważny lub skrót jest niezgodny ze składnikiem.
SecurityErrorEvent.SECURITY_ERROR
definiuje wartość właściwości type
obiektu zdarzenia securityError
.
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 zgłaszający błąd zabezpieczeń. |
text | Tekst, który ma być wyświetlany w charakterze komunikatu o błędzie. |
Powiązane elementy interfejsu API
Tue Jun 12 2018, 12:06 PM Z