Paket | flash.system |
Klasse | public class SystemUpdater |
Vererbung | SystemUpdater EventDispatcher Object |
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 10.1 |
Flash Player identifiziert das Erfordernis eines Updates des Adobe Access-Moduls, indem ein NetStatusEvent-Ereignis abgesetzt wird. Das Ereignis hat eine code
-Eigenschaft mit dem Wert DRM.UpdateNeeded
. Für Updates des Adobe Access-Moduls ist keine Benutzerzustimmung erforderlich. Warten Sie auf das Ereignis und initiieren Sie das Update, indem Sie update("DRM")
aufrufen.
Flash Player identifiziert das Erfordernis eines Player-Updates, indem ein StatusEvent-Ereignis abgesetzt wird, mit verschiedenen möglichen Werten für die code
-Eigenschaft (siehe das status
-Ereignis). Für Updates des Players ist das Einverständnis des Benutzers erforderlich. Warten Sie auf das Ereignis und geben Sie dem Benutzer die Möglichkeit, das Update auszuführen. Der Benutzer muss dem Update zustimmen und es, zum Beispiel durch Klicken auf eine Schaltfläche, einleiten. Sie können das Update des Players dann direkt in ActionScript initiieren, indem Sie update("SYSTEM")
aufrufen.
Hinweis: Die SystemUpdater-API wird auf allen Desktopplattformen unterstützt.
Verwandte API-Elemente
Methode | Definiert von | ||
---|---|---|---|
Konstruktor. | SystemUpdater | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. | EventDispatcher | ||
Bricht ein aktives Update ab. | SystemUpdater | ||
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | ||
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt das angegebene Objekt als String zurück. | Object | ||
Beginnt mit einem Update eines gegebenen Typs. | SystemUpdater | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object | ||
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher |
Ereignis | Übersicht | Definiert von | ||
---|---|---|---|---|
[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird. | EventDispatcher | |||
Wird abgesetzt, wenn ein Update des Players vom Benutzer abgebrochen wird. | SystemUpdater | |||
Wird abgesetzt, wenn das Update abgeschlossen ist. | SystemUpdater | |||
[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird. | EventDispatcher | |||
Wird beim Auftreten eines E/A-Fehlers abgesetzt. | SystemUpdater | |||
Wird abgesetzt, wenn ein Update beginnt. | SystemUpdater | |||
Wird abgesetzt, um den Fortschritt des Downloads anzuzeigen. | SystemUpdater | |||
Wird beim Auftreten eines Sicherheitsfehlers abgesetzt. | SystemUpdater | |||
Wird abgesetzt, wenn der Download fehlschlägt. | SystemUpdater |
SystemUpdater | () | Konstruktor |
public function SystemUpdater()
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 10.1 |
Konstruktor.
cancel | () | Methode |
public function cancel():void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 10.1 |
Bricht ein aktives Update ab.
update | () | Methode |
public function update(type:String):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 10.1 |
Beginnt mit einem Update eines gegebenen Typs. Updatetypen sind in der SystemUpdaterType-Klasse definierte Stringkonstanten. In allen Browsern ist jeweils nur ein Update gleichzeitig zulässig.
Warten Sie nach Beginn des Updates auf die in dieser Klasse definierten Ereignisse. Die folgenden Ereignisse geben das Ende eines Updates an und lassen ein neues Update bzw. einen neuen Updateversuch zu, zum Beispiel durch Aufrufen der update()
-Funktion:
complete
cancel
securityError
ioError
status
Parameter
type:String |
Verwandte API-Elemente
cancel | Ereignis |
flash.events.Event
Eigenschaft Event.type =
flash.events.Event.CANCEL
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 10.1 |
Wird abgesetzt, wenn ein Update des Players vom Benutzer abgebrochen wird. Dieses Ereignis wird nur dann abgesetzt, wenn ein Update des Typs SystemUpdaterType.SYSTEM
angefordert wird und der Benutzer das Update abbricht.
Event.CANCEL
-Konstante definiert den Wert der type
-Eigenschaft eines cancel
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Ein Verweis auf das Objekt, dessen Operation abgebrochen wurde. |
complete | Ereignis |
flash.events.Event
Eigenschaft Event.type =
flash.events.Event.COMPLETE
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 10.1 |
Wird abgesetzt, wenn das Update abgeschlossen ist.
DieEvent.COMPLETE
-Konstante definiert den Wert der type
-Eigenschaft eines complete
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das Netzwerkobjekt, dessen Ladevorgang beendet ist. |
ioError | Ereignis |
flash.events.IOErrorEvent
Eigenschaft IOErrorEvent.type =
flash.events.IOErrorEvent.IO_ERROR
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 10.1 |
Wird beim Auftreten eines E/A-Fehlers abgesetzt. Ein Fehler, der dieses Ereignis auslösen kann, ist zum Beispiel eine unterbrochene Internetverbindung.
Definiert den Wert der Eigenschafttype
eines ioError
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
errorID | Die Referenznummer des spezifischen Fehlers (nur AIR). |
target | Das Netzwerkobjekt, bei dem der Eingabe/Ausgabe-Fehler auftritt. |
text | Der als Fehlermeldung anzuzeigende Text. |
open | Ereignis |
flash.events.Event
Eigenschaft Event.type =
flash.events.Event.OPEN
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 10.1 |
Wird abgesetzt, wenn ein Update beginnt. Das Update ist abgeschlossen, wenn ein „complete“-Ereignis gesendet wird, oder wenn ein IOErrorEvent, SecurityErrorEvent oder StatusEvent gesendet wird.
DieEvent.OPEN
-Konstante definiert den Wert der type
-Eigenschaft eines open
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das Netzwerkobjekt, über das eine Verbindung geöffnet wurde. |
progress | Ereignis |
flash.events.ProgressEvent
Eigenschaft ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 10.1 |
Wird abgesetzt, um den Fortschritt des Downloads anzuzeigen. Dieses Ereignis entspricht dem progress
-Ereignis in den Loader- und URLLoader-Klassen.
type
eines progress
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
bytesLoaded | Die Anzahl der geladenen Elemente oder Byte zu dem Zeitpunkt, zu dem der Listener das Ereignis verarbeitet. |
bytesTotal | Die Gesamtanzahl der Elemente oder Byte, die bei einem erfolgreichen Ladevorgang schließlich geladen werden. |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das Objekt, dessen Fortschritt protokolliert wird. |
securityError | Ereignis |
flash.events.SecurityErrorEvent
Eigenschaft SecurityErrorEvent.type =
flash.events.SecurityErrorEvent.SECURITY_ERROR
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 10.1 |
Wird beim Auftreten eines Sicherheitsfehlers abgesetzt. Ein Sicherheitsfehler, der diese Ereignis auslösen kann, tritt zum Beispiel auf, wenn der Player versucht, ein Update auszuführen, dies von der Sicherheitsrichtlinie jedoch nicht zugelassen wird.
Die KonstanteSecurityErrorEvent.SECURITY_ERROR
definiert den Wert der type
-Eigenschaft eines securityError
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das Netzwerkobjekt, das den Sicherheitsfehler ausgibt. |
text | Der als Fehlermeldung anzuzeigende Text. |
status | Ereignis |
flash.events.StatusEvent
Eigenschaft StatusEvent.type =
flash.events.StatusEvent.STATUS
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 10.1 |
Wird abgesetzt, wenn der Download fehlschlägt. Ein Update kann aus einem der folgenden Gründe fehlschlagen:
- Der Aufrufer wird auf einer nicht unterstützten Plattform oder Architektur ausgeführt. In diesem Fall hat die
code
-Eigenschaft den Wert „DRM.UpdateFailedNotSupported“ und dielevel
-Eigenschaft hat den Wert „error“. - Das angeforderte Updatepaket wurde auf dem Server nicht gefunden. In diesem Fall hat die
code
-Eigenschaft den Wert „DRM.UpdateFailedNotCurrentlyAvailable“ und dielevel
-Eigenschaft hat den Wert „error“. - Das Adobe Access-Modul ist nicht installiert. Dieser Fehler ähnelt dem „DRM.UpdateNeeded“-Code, der von NetStatusEvent abgesetzt wird. In diesem Fall muss jedoch zunächst eine neuere Version von Flash Player heruntergeladen werden. In diesem Fall hat die
code
-Eigenschaft den Wert „DRM.UpdateNeededButIncompatible“ und dielevel
-Eigenschaft hat den Wert „error“. Um ein Update von Flash Player auszuführen, rufen SieSystemUpdater.update(SystemUpdaterType.SYSTEM)
auf. - Das neue DRM-Modul konnte nicht heruntergeladen werden. In diesem Fall hat die
code
-Eigenschaft den Wert „DRM.UpdateFailed“ und dielevel
-Eigenschaft hat den Wert „error“.
type
eines status
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
code | Eine Beschreibung des Objektstatus. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
Ebene | Die Kategorie der Meldung, z. B. "status" , "warning" oder "error" . |
target | Das Objekt, dessen Status gemeldet wird. |
Tue Jun 12 2018, 10:04 AM Z