AVURLLoader

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

Klasa URLLoader pozwala pobierać dane spod adresu URL; można je pobierać w postaci tekstu, danych binarnych i zakodowanych zmiennych. Użyteczna do pobierania plików tekstowych, XML lub innych informacji w celu użycia w dynamicznej, sterowanej danymi aplikacji.

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

URLRequest
URLVariables
AVURLStream

Właściwości publiczne

Ukryj dziedziczone właściwości publiczne

Pokaż dziedziczone właściwości publiczne

	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

Metody publiczne

Ukryj dziedziczone metody publiczne

Pokaż dziedziczone metody publiczne

	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
		close():void [przesłanianie] Kończy trwającą operację wczytywania.	AVURLLoader
		dispatchEvent(event:Event):Boolean Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń.	EventDispatcher
		hasEventListener(type:String):Boolean Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń.	EventDispatcher
		hasOwnProperty(name:String):Boolean Wskazuje, czy dla obiektu zdefiniowano określoną właściwość.	Object
		isPrototypeOf(theClass:Object):Boolean Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr.	Object
		load(request:URLRequest):void [przesłanianie] Wysyła dane i wczytuje je spod określonego adresu URL.	AVURLLoader
		propertyIsEnumerable(name:String):Boolean Wskazuje, czy określona właściwość istnieje i jest przeliczalna.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Usuwa detektor z obiektu EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Ustawia dostępność właściwości dynamicznej używanej w pętlach.	Object
		toLocaleString():String Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych.	Object
		toString():String Zwraca ciąg reprezentujący określony obiekt.	Object
		valueOf():Object Zwraca pierwotną wartość dla określonego obiektu.	Object
		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

Ukryj zdarzenia dziedziczone

Pokaż zdarzenia dziedziczone

	Podsumowanie	Zdefiniowane przez
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
complete	Wywoływana, gdy wszystkie odebrane dane zostały zdekodowane i związane z właściwością danych obiektu URLLoader.	AVURLLoader
deactivate	[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny.	EventDispatcher
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.	AVURLLoader
httpStatus	Wywoływane, jeśli wywołanie URLLoader.load() skutkuje próbą dostępu do danych za pośrednictwem protokołu HTTP.	AVURLLoader
ioError	Wywoływane, gdy wywołanie metody URLLoader.load() skutkuje błędem krytycznym, który kończy pobieranie danych.	AVURLLoader
open	Wywoływana, gdy operacja pobierania rozpoczyna się od wywołania metody URLLoader.load().	AVURLLoader
progress	Wywoływane w trakcie stopniowego ładowania danych.	AVURLLoader
securityError	Wywoływana, jeśli wywołanie metody URLLoader.load() skutkuje próbą pobrania danych z serwera na zewnątrz obszaru izolowanego.	AVURLLoader

Szczegół właściwości

cookieHeader

właściwość

cookieHeader:String [tylko do zapisu]

Implementacja
public function set cookieHeader(value:String):void

Konstruktor Szczegół

()

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.

Parametry

request: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

URLLoader.load()

Szczegół metody

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:Event` — Wywoływane po pomyślnym wczytaniu danych.

	`httpStatus:HTTPStatusEvent` — 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:IOErrorEvent` — Operacja load nie mogła zostać ukończona.

	`progress:ProgressEvent` — Wywoływane w trakcie stopniowego wczytywania danych.

	`securityError:SecurityErrorEvent` — 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:SecurityErrorEvent` — 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:Event` — Wywoływane po rozpoczęciu ładowania.

	`httpResponseStatus:HTTPStatusEvent` — 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

URLRequestHeader
URLRequest.requestHeaders
URLRequest.data
URLRequest.digest

Szczegół zdarzenia

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 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ł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ść
`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

URLLoader.load()

httpResponseStatus

Zdarzenie

Typ obiektu zdarzenia: 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 zdarzenia httpStatus, 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

load()

httpStatus

Zdarzenie

Typ obiektu zdarzenia: 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.

Stała 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

URLLoader.load()

ioError

Zdarzenie

Typ obiektu zdarzenia: 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ści type 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

URLLoader.load()

open

Zdarzenie

Typ obiektu zdarzenia: 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()

Stała 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

URLLoader.load()

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 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ści type 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

URLLoader.load()

securityError

Zdarzenie

Typ obiektu zdarzenia: 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.

Stała 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

URLLoader.load()

Informacje prawne | Zasady prywatności online

AVURLLoader - AS3

Klasy x

cookieHeader

AVURLLoader

addEventListener

close

load

complete

httpResponseStatus

httpStatus

ioError

open

progress

securityError