SystemUpdater

Pakket	flash.system
Klasse	public class SystemUpdater
Overerving	SystemUpdater EventDispatcher Object

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 10.1

Met de SystemUpdater-klasse kunt u modules van de Flash Player bijwerken, zoals de DRM-module voor Adobe Access en voor Flash Player zelf. Beschikbare modules worden vermeld in de klasse SystemUpdaterType.

Flash Player geeft de behoefte aan een update van de Adobe Access-module aan door een NetStatusEvent-gebeurtenis te verzenden. De eigenschap code van de gebeurtenis heeft de waarde "DRM.UpdateNeeded". Voor updates van de Adobe Access-module is geen toestemming van de gebruiker nodig. Luister of de gebeurtenis plaatsvindt en start de update door update ("DRM") aan te roepen.

Flash Player stelt door het verzenden van een StatusEvent-gebeurtenis vast of er een update moet worden uitgevoerd van de speler. De eigenschap code van deze gebeurtenis kan verschillende waarden hebben (zie de gebeurtenis status). Voor het uitvoeren van update van de speler is toestemming van de gebruiker nodig. Luister of de gebeurtenis plaatsvindt en geef de gebruiker de mogelijkheid een update van de speler uit te voeren. De gebruiker moet instemmen met de daadwerkelijke update en moet de update bijvoorbeeld starten door op een knop in de gebruikersinterface te klikken. U kunt het uitvoeren van de update van de speler vervolgens direct in ActionScript starten door update("SYSTEM") aan te roepen.

Opmerking: De API van SystemUpdater wordt ondersteund op alle desktopplatforms.

Verwante API-elementen

flash.system.SystemUpdaterType

Openbare eigenschappen

Overerfde openbare eigenschappen verbergen

Overerfde openbare eigenschappen weergeven

	Eigenschap		Gedefinieerd door
		constructor : Object Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie.	Object

Openbare methoden

Overerfde openbare methoden verbergen

Overerfde openbare methoden weergeven

	Methode		Gedefinieerd door
		SystemUpdater() Constructor.	SystemUpdater
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt.	EventDispatcher
		cancel():void Annuleert een actieve update.	SystemUpdater
		dispatchEvent(event:Event):Boolean Verzendt een gebeurtenis naar de gebeurtenisstroom.	EventDispatcher
		hasEventListener(type:String):Boolean Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis.	EventDispatcher
		hasOwnProperty(name:String):Boolean Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd.	Object
		isPrototypeOf(theClass:Object):Boolean Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven.	Object
		propertyIsEnumerable(name:String):Boolean Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Verwijdert een listener uit het object EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in.	Object
		toLocaleString():String Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies.	Object
		toString():String Retourneert een tekenreeksrepresentatie van het opgegeven object.	Object
		update(type:String):void Begint een update van een bepaald type.	SystemUpdater
		valueOf():Object Retourneert de primitieve waarde van het opgegeven object.	Object
		willTrigger(type:String):Boolean Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis.	EventDispatcher

Gebeurtenissen

Klik voor meer informatie over gebeurtenissen.

Overerfde gebeurtenissen verbergen

Overerfde gebeurtenissen weergeven

	Overzicht	Gedefinieerd door
activate	[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de besturingssysteemfocus krijgt en actief wordt.	EventDispatcher
cancel	Wordt verzonden wanneer een update van de speler zelf door de gebruiker wordt geannuleerd.	SystemUpdater
complete	Wordt verzonden wanneer de update is voltooid.	SystemUpdater
deactivate	[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de systeemfocus verliest en inactief wordt.	EventDispatcher
ioError	Wordt verzonden wanneer een I/O-fout optreedt.	SystemUpdater
open	Wordt verzonden wanneer een update begint.	SystemUpdater
progress	Wordt verzonden om de voortgang van het downloaden aan te geven.	SystemUpdater
securityError	Wordt verzonden wanneer er een beveiligingsfout optreedt.	SystemUpdater
status	Wordt verzonden wanneer de update is mislukt.	SystemUpdater

Constructordetails

()

Constructor

public function SystemUpdater()

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 10.1

Constructor.

Methodedetails

cancel

()

methode

public function cancel():void

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 10.1

Annuleert een actieve update.

update

()

methode

public function update(type:String):void

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 10.1

Begint een update van een bepaald type. Het updatetype is een van de stringconstanten die zijn gedefinieerd in de klasse SystemUpdaterType. Er kan voor alle browsers maar een update tegelijk worden uitgevoerd.

Nadat de update is begonnen, luistert u of de in deze klasse gedefinieerde gebeurtenissen plaatsvinden. Net als het aanroepen van de functie update(), geven de volgende gebeurtenissen het eind van een update aan en geven ze aan dat er een nieuwe update(poging) kan worden uitgevoerd:

complete
cancel
securityError
ioError
status

Parameters

type:String

Verwante API-elementen

flash.system.SystemUpdaterType

Gebeurtenisdetails

cancel

Gebeurtenis

Type gebeurtenisobject: flash.events.Event
eigenschap Event.type = flash.events.Event.CANCEL

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 10.1

Wordt verzonden wanneer een update van de speler zelf door de gebruiker wordt geannuleerd. Deze gebeurtenis wordt alleen verzonden wanneer er om een update van het type SystemUpdaterType.SYSTEM is gevraagd en de gebruiker de update annuleert.

De constante Event.CANCEL definieert de waarde van de eigenschap type van een cancel-gebeurtenisobject.

Deze gebeurtenis heeft de volgende eigenschappen:

Eigenschap	Waarde
`bubbles`	`false`
`cancelable`	`false`; er is geen standaardgedrag om te annuleren.
`currentTarget`	Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener.
`target`	Een verwijzing naar het object waarop de handeling wordt geannuleerd.

complete

Gebeurtenis

Type gebeurtenisobject: flash.events.Event
eigenschap Event.type = flash.events.Event.COMPLETE

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 10.1

Wordt verzonden wanneer de update is voltooid.

De constante Event.COMPLETE definieert de waarde van de eigenschap type van een complete-gebeurtenisobject.

Deze gebeurtenis heeft de volgende eigenschappen:

Eigenschap	Waarde
`bubbles`	`false`
`cancelable`	`false`; er is geen standaardgedrag om te annuleren.
`currentTarget`	Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener.
`target`	Het netwerkobject dat klaar is met laden.

ioError

Gebeurtenis

Type gebeurtenisobject: flash.events.IOErrorEvent
eigenschap IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 10.1

Wordt verzonden wanneer een I/O-fout optreedt. Deze gebeurtenis kan bijvoorbeeld worden veroorzaakt door een fout die optreedt als de internetverbinding plotseling wordt verbroken.

Definieert de waarde van de eigenschap type van een gebeurtenisobject ioError.

Deze gebeurtenis heeft de volgende eigenschappen:

Eigenschap	Waarde
`bubbles`	`false`
`cancelable`	`false`; er is geen standaardgedrag om te annuleren.
`currentTarget`	Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener.
`errorID`	Een referentienummer dat aan de specifieke fout is gekoppeld (alleen AIR).
`target`	Het netwerkobject dat de invoer-/uitvoerfout ondervindt.
`text`	Tekst die moet worden weergegeven als foutbericht.

open

Gebeurtenis

Type gebeurtenisobject: flash.events.Event
eigenschap Event.type = flash.events.Event.OPEN

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 10.1

Wordt verzonden wanneer een update begint. De update is voltooid wanneer een complete-gebeurtenis is verzonden of wanneer een IOErrorEvent, SecurityErrorEvent of StatusEvent is verzonden.

De constante Event.OPEN definieert de waarde van de eigenschap type van een open-gebeurtenisobject.

Deze gebeurtenis heeft de volgende eigenschappen:

Eigenschap	Waarde
`bubbles`	`false`
`cancelable`	`false`; er is geen standaardgedrag om te annuleren.
`currentTarget`	Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener.
`target`	Het netwerkobject dat de verbinding heeft geopend.

progress

Gebeurtenis

Type gebeurtenisobject: flash.events.ProgressEvent
eigenschap ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 10.1

Wordt verzonden om de voortgang van het downloaden aan te geven. Deze gebeurtenis is vergelijkbaar met de gebeurtenis progress in de klassen Loader en URLLoader.

Definieert de waarde van de eigenschap type van een gebeurtenisobject progress.

Deze gebeurtenis heeft de volgende eigenschappen:

Eigenschap	Waarde
`bubbles`	`false`
`bytesLoaded`	Het aantal items of bytes dat wordt geladen wanneer de listener de gebeurtenis verwerkt.
`bytesTotal`	Het totale aantal items of bytes dat uiteindelijk wordt geladen wanneer het laadproces is voltooid.
`cancelable`	`false`; er is geen standaardgedrag om te annuleren.
`currentTarget`	Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener.
`target`	Het object dat de voortgang rapporteert.

securityError

Gebeurtenis

Type gebeurtenisobject: flash.events.SecurityErrorEvent
eigenschap SecurityErrorEvent.type = flash.events.SecurityErrorEvent.SECURITY_ERROR

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 10.1

Wordt verzonden wanneer er een beveiligingsfout optreedt. Deze gebeurtenis kan bijvoorbeeld worden veroorzaakt door een beveiligingsfout die optreedt als er wordt geprobeerd een update van de speler uit te voeren terwijl dit niet wordt toegestaan door het beveiligingsbeleid.

De constante SecurityErrorEvent.SECURITY_ERROR definieert de waarde van de eigenschap type van een gebeurtenisobject securityError.

Deze gebeurtenis heeft de volgende eigenschappen:

Eigenschap	Waarde
`bubbles`	`false`
`cancelable`	`false`; er is geen standaardgedrag om te annuleren.
`currentTarget`	Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener.
`target`	Het netwerkobject dat de beveiligingsfout rapporteert.
`text`	Tekst die moet worden weergegeven als foutbericht.

status

Gebeurtenis

Type gebeurtenisobject: flash.events.StatusEvent
eigenschap StatusEvent.type = flash.events.StatusEvent.STATUS

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 10.1

Wordt verzonden wanneer de update is mislukt. Een update kan om een van de volgende redenen mislukken:

De aanroeper wordt uitgevoerd op een niet-ondersteund platform of in een niet-ondersteunde architectuur. De waarde van de eigenschap code is in dit geval "DRM.UpdateFailedNotSupported" en de waarde van de eigenschap level is "error".
Het gevraagde updatepakket kan niet op de server worden gevonden. De waarde van de eigenschap code is in dit geval "DRM.UpdateFailedNotCurrentlyAvailable" en de waarde van de eigenschap level is "error".
De Adobe Access-module is niet geïnstalleerd. Deze fout is vergelijkbaar met de code "DRM.UpdateNeeded", die wordt verzonden door NetStatusEvent. In dit geval moet er echter eerst een recentere versie van Flash Player worden gedownload. De waarde van de eigenschap code is in dit geval "DRM.UpdateNeededButIncompatible" en de waarde van de eigenschap level is "error". Roep SystemUpdater.update(SystemUpdaterType.SYSTEM) aan om een update van Flash Player uit te voeren.
De nieuwe DRM-module kan niet worden gedownload. De waarde van de eigenschap code is in dit geval "DRM.UpdateFailed" en de waarde van de eigenschap level is "error".

Definieert de waarde van de eigenschap type van een gebeurtenisobject status.

Deze gebeurtenis heeft de volgende eigenschappen:

Eigenschap	Waarde
`bubbles`	`false`
`cancelable`	`false`; er is geen standaardgedrag om te annuleren.
`code`	Beschrijving van de status van het object.
`currentTarget`	Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener.
`level`	De categorie van het bericht, zoals `"status"`, `"warning"` of `"error"`.
`target`	Het object dat zijn status rapporteert.

Juridische kennisgeving | Online privacybeleid

SystemUpdater - AS3

Klassen x

SystemUpdater

cancel

update

cancel

complete

ioError

open

progress

securityError

status