| Pakiet | flash.system |
| Klasa | public class SystemUpdater |
| Dziedziczenie | SystemUpdater  EventDispatcher Object |
| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 10.1 |
Program Flash Player informuje o konieczności aktualizacji modułu Adobe Access, wywołując zdarzenie NetStatusEvent. Zdarzenie zawiera właściwość code z wartością DRM.UpdateNeeded. Do aktualizacji modułu Adobe Access nie jest wymagana zgoda użytkownika. Należy nasłuchiwać aktualizacji i zainicjować ją, wywołując update("DRM").
Program Flash Player informuje o konieczności aktualizacji odtwarzacza, wywołując zdarzenie StatusEvent, z kilkoma możliwymi wartościami właściwości code (patrz zdarzenie status). W przypadku aktualizacji odtwarzacza wymagana jest zgoda użytkownika. Należy nasłuchiwać zdarzenia i udostępnić użytkownikowi opcję aktualizacji. Użytkownik musi się zgodzić na aktualizację i zainicjować ją, np. poprzez kliknięcie przycisku w interfejsie użytkownika. Aktualizację odtwarzacza można zainicjować bezpośrednio w kodzie ActionScript, wywołując update("SYSTEM").
Uwaga: obiekt SystemUpdater jest obsługiwany na wszystkich platformach stacjonarnych.
Powiązane elementy interfejsu API
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne| Metoda | Zdefiniowane przez | ||
|---|---|---|---|
Konstruktor. | SystemUpdater | ||
 | 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 | |
Anuluje aktywną aktualizację. | SystemUpdater | ||
|
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 | |
|
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 | |
Rozpoczyna aktualizację określonego typu. | SystemUpdater | ||
|
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ływane, gdy aktualizacja odtwarzacza zostanie anulowana przez użytkownika. | SystemUpdater | |||
| Wywoływane po zakończeniu aktualizacji. | SystemUpdater | |||
| [zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny. | EventDispatcher | ||
| Wywoływane w przypadku błędu we/wy. | SystemUpdater | |||
| Wywoływane po rozpoczęciu aktualizacji. | SystemUpdater | |||
| Wywoływane w celu wskazania postępu pobierania. | SystemUpdater | |||
| Wywoływane po napotkaniu błędu zabezpieczeń. | SystemUpdater | |||
| Wywoływane w razie niepowodzenia aktualizacji. | SystemUpdater | |||
SystemUpdater | () | Konstruktor |
public function SystemUpdater()| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 10.1 |
Konstruktor.
cancel | () | metoda |
public function cancel():void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 10.1 |
Anuluje aktywną aktualizację.
update | () | metoda |
public function update(type:String):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 10.1 |
Rozpoczyna aktualizację określonego typu. Typy aktualizacji określa jedna ze stałych string zdefiniowanych w klasie SystemUpdaterType. Na wszystkich przeglądarkach jednocześnie może odbywać się tylko jedna aktualizacja.
Po rozpoczęciu aktualizacji należy nasłuchiwać zdarzeń zdefiniowanych w tej klasie. Następujące zdarzenia oznaczają koniec aktualizacji i umożliwiają wykonanie nowej aktualizacji lub próby aktualizacji, co realizuje funkcja update():
completecancelsecurityErrorioErrorstatus
Parametry
type:String |
Powiązane elementy interfejsu API
cancel | Zdarzenie |
flash.events.Eventwłaściwość Event.type =
flash.events.Event.CANCEL| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 10.1 |
Wywoływane, gdy aktualizacja odtwarzacza zostanie anulowana przez użytkownika. To zdarzenie jest wywoływane tylko wówczas, gdy zostanie zażądana aktualizacja typu SystemUpdaterType.SYSTEM, a użytkownik dokona anulowania aktualizacji.
Event.CANCEL definiuje wartość właściwości type obiektu zdarzenia cancel.
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 | Odwołanie do obiektu, w którym operacja jest anulowana. |
complete | Zdarzenie |
flash.events.Eventwłaściwość Event.type =
flash.events.Event.COMPLETE| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 10.1 |
Wywoływane po zakończeniu aktualizacji.
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. |
ioError | Zdarzenie |
flash.events.IOErrorEventwłaściwość IOErrorEvent.type =
flash.events.IOErrorEvent.IO_ERROR| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 10.1 |
Wywoływane w przypadku błędu we/wy. Na przykład: jednym błędem, który może wywołać to zdarzenie jest utrata połączenia z Internetem.
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. |
open | Zdarzenie |
flash.events.Eventwłaściwość Event.type =
flash.events.Event.OPEN| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 10.1 |
Wywoływane po rozpoczęciu aktualizacji. Aktualizacja jest zakończona, jeśli zostało wysłane zdarzenie „complete”, lub jeśli zostało wysłane zdarzenie IOErrorEvent, SecurityErrorEvent albo StatusEvent.
StałaEvent.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. |
progress | Zdarzenie |
flash.events.ProgressEventwłaściwość ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 10.1 |
Wywoływane w celu wskazania postępu pobierania. To zdarzenie przypomina zdarzenie progress w klasach Loader i URLLoader.
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. |
securityError | Zdarzenie |
flash.events.SecurityErrorEventwłaściwość SecurityErrorEvent.type =
flash.events.SecurityErrorEvent.SECURITY_ERROR| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 10.1 |
Wywoływane po napotkaniu błędu zabezpieczeń. Na przykład: błędem zabezpieczeń, który może wywołać to zdarzenie jest próba przeprowadzenia aktualizacji przez odtwarzacz, gdy na aktualizację nie zezwala reguła zabezpieczeń.
StałaSecurityErrorEvent.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. |
status | Zdarzenie |
flash.events.StatusEventwłaściwość StatusEvent.type =
flash.events.StatusEvent.STATUS| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 10.1 |
Wywoływane w razie niepowodzenia aktualizacji. Aktualizacja może się zakończyć niepowodzeniem z następujących powodów:
- Obiekt wywołujący działa na nieobsługiwanej platformie lub architekturze. W takim przypadku właściwość
codema wartość „DRM.UpdateFailedNotSupported”, a właściwośćlevelma wartość „error”. - Żądanego pakietu aktualizacji nie można znaleźć na serwerze. W takim przypadku właściwość
codema wartość „DRM.UpdateFailedNotCurrentlyAvailable”, a właściwośćlevelma wartość „error”. - Moduł Adobe Access nie został zainstalowany. Ten błąd przypomina kod „DRM.UpdateNeeded”, który jest wywoływany przez zdarzenie NetStatusEvent. Jednak w tym przypadku najpierw należy pobrać nowszą wersję programu Flash Player. W takim przypadku właściwość
codema wartość „DRM.UpdateNeededButIncompatible”, a właściwośćlevelma wartość „error”. W celu zaktualizowania programu Flash Player należy wywołać metodęSystemUpdater.update(SystemUpdaterType.SYSTEM). - Nie można pobrać nowego modułu DRM. W takim przypadku właściwość
codema wartość „DRM.UpdateFailed”, a właściwośćlevelma wartość „error”.
type obiektu zdarzenia status.
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ć. |
code | Opis stanu obiektu. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
level | Kategoria komunikatu, np. "status", "warning" lub "error". |
target | Obiekt informujący o swoim stanie. |
Tue Jun 12 2018, 12:06 PM Z