SystemUpdater

Paket	flash.system
Klasse	public class SystemUpdater
Vererbung	SystemUpdater EventDispatcher Object

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 10.1

Mit der SystemUpdater-Klasse können Sie Flash Player-Module aktualisieren, zum Beispiel das DRM-Modul für Adobe Access, sowie Flash Player selbst. Verfügbare Module sind in der SystemUpdaterType-Klasse aufgeführt.

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

flash.system.SystemUpdaterType

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		SystemUpdater() 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
		cancel():void Bricht ein aktives Update ab.	SystemUpdater
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	EventDispatcher
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		update(type:String):void Beginnt mit einem Update eines gegebenen Typs.	SystemUpdater
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object
		willTrigger(type:String):Boolean Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.	EventDispatcher

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

Vererbte Ereignisse ausblenden

Vererbte Ereignisse anzeigen

	Übersicht	Definiert von
activate	[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.	EventDispatcher
cancel	Wird abgesetzt, wenn ein Update des Players vom Benutzer abgebrochen wird.	SystemUpdater
complete	Wird abgesetzt, wenn das Update abgeschlossen ist.	SystemUpdater
deactivate	[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.	EventDispatcher
ioError	Wird beim Auftreten eines E/A-Fehlers abgesetzt.	SystemUpdater
open	Wird abgesetzt, wenn ein Update beginnt.	SystemUpdater
progress	Wird abgesetzt, um den Fortschritt des Downloads anzuzeigen.	SystemUpdater
securityError	Wird beim Auftreten eines Sicherheitsfehlers abgesetzt.	SystemUpdater
status	Wird abgesetzt, wenn der Download fehlschlägt.	SystemUpdater

Konstruktordetails

()

Konstruktor

public function SystemUpdater()

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 10.1

Konstruktor.

Methodendetails

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

flash.system.SystemUpdaterType

Ereignisdetails

cancel

Ereignis

Ereignisobjekttyp: 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.

Die 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

Ereignisobjekttyp: 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.

Die Event.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

Ereignisobjekttyp: 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 Eigenschaft type 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

Ereignisobjekttyp: 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.

Die Event.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

Ereignisobjekttyp: 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.

Definiert den Wert der Eigenschaft 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

Ereignisobjekttyp: 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 Konstante SecurityErrorEvent.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

Ereignisobjekttyp: 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 die level-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 die level-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 die level-Eigenschaft hat den Wert „error“. Um ein Update von Flash Player auszuführen, rufen Sie SystemUpdater.update(SystemUpdaterType.SYSTEM) auf.
Das neue DRM-Modul konnte nicht heruntergeladen werden. In diesem Fall hat die code-Eigenschaft den Wert „DRM.UpdateFailed“ und die level-Eigenschaft hat den Wert „error“.

Definiert den Wert der Eigenschaft 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.

Rechtliche Hinweise | Onlinedatenschutzerklärung

SystemUpdater - AS3

Klassen x

SystemUpdater

cancel

update

cancel

complete

ioError

open

progress

securityError

status