SystemUpdater

Paket	flash.system
Klass	public class SystemUpdater
Arv	SystemUpdater EventDispatcher Object

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 10.1

Med klassen SystemUpdater kan du uppdatera moduler för Flash Player, till exempel DRM-modulen för Adobe Access eller själva Flash Player. De tillgängliga modulerna anges i klassen SystemUpdaterType.

Flash Player identifierar att en uppdatering av Adobe-Access-modulen krävs genom att skicka en NetStatusEvent-händelse. Händelsen har en code-egenskap med värdet "DRM.UpdateNeeded". För uppdateringar av Adobe Access-modulen behövs ingen tillåtelse från användaren. Lyssna efter händelsen och initiera uppdateringen genom att anropa update("DRM").

Flash Player identifierar att en uppdatering av spelaren krävs genom att skicka en StatusEvent-händelse med flera möjliga värden för code-egenskapen (se händelsen status). Användaren måste ge tillstånd för uppdateringar av spelaren. Lyssna efter händelsen och ge användaren en möjlighet att uppdatera. Användaren måste samtycka till uppdateringen och initiera uppdateringen genom att t.ex. klicka på en knapp i användargränssnittet. Du kan sedan initiera uppdateringen av spelaren direkt i ActionScript genom att anropa update("SYSTEM").

Obs! API:n SystemUpdater stöds på alla skrivbordsplattformar.

Relaterade API-element

flash.system.SystemUpdaterType

Publika egenskaper

Dölj ärvda publika egenskaper

Visa ärvda publika egenskaper

	Egenskap		Definieras med
		constructor : Object En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans.	Object

Publika metoder

Dölj ärvda publika metoder

Visa ärvda publika metoder

	Metod		Definieras med
		SystemUpdater() Konstruktor.	SystemUpdater
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registrerar ett händelseavlyssnarobjekt för ett EventDispatcher-objekt så att avlyssnaren får meddelanden om händelser.	EventDispatcher
		cancel():void Avbryter en aktiv uppdatering.	SystemUpdater
		dispatchEvent(event:Event):Boolean Skickar en händelse till händelseflödet.	EventDispatcher
		hasEventListener(type:String):Boolean Kontrollerar om EventDispatcher-objektet har några avlyssnare registrerade för en viss typ av händelse.	EventDispatcher
		hasOwnProperty(name:String):Boolean Anger om det finns en egenskap angiven för ett objekt.	Object
		isPrototypeOf(theClass:Object):Boolean Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter.	Object
		propertyIsEnumerable(name:String):Boolean Anger om den angivna egenskapen finns och är uppräkningsbar.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Tar bort en avlyssnare från EventDispatcher-objektet.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Anger tillgänglighet för en dynamisk egenskap för slingåtgärder.	Object
		toLocaleString():String Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner.	Object
		toString():String Returnerar det angivna objektets strängbeteckning.	Object
		update(type:String):void Startar en uppdatering av en viss typ.	SystemUpdater
		valueOf():Object Returnerar det angivna objektets primitiva värde.	Object
		willTrigger(type:String):Boolean Kontrollerar om en händelseavlyssnare är registrerad för det här EventDispatcher-objektet eller något av dess överordnade objekt för den angivna händelsetypen.	EventDispatcher

Händelser

Klicka för mer information om händelser

Dölj ärvda händelser

Visa ärvda händelser

	Sammanfattning	Definieras med
activate	[utsändningshändelse] Skickas när Flash Player eller AIR får operativsystemfokus och blir aktivt.	EventDispatcher
cancel	Skickas när en uppdatering av själva spelaren avbryts av användaren.	SystemUpdater
complete	Skickas när uppdateringen slutförs.	SystemUpdater
deactivate	[utsändningshändelse] Skickas när Flash Player eller AIR förlorar operativsystemfokus och blir inaktivt.	EventDispatcher
ioError	Skickas när ett I/O-fel inträffar.	SystemUpdater
open	Skickas när en uppdatering startar.	SystemUpdater
progress	Skickas för att visa hämtningens förlopp.	SystemUpdater
securityError	Skickas när ett säkerhetsfel inträffar.	SystemUpdater
status	Skickas när uppdateringen misslyckas.	SystemUpdater

Konstruktordetaljer

()

Konstruktor

public function SystemUpdater()

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 10.1

Konstruktor.

Metoddetaljer

cancel

()

metod

public function cancel():void

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 10.1

Avbryter en aktiv uppdatering.

update

()

metod

public function update(type:String):void

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 10.1

Startar en uppdatering av en viss typ. Uppdateringstyper är en av strängkonstanterna som definieras i klassen SystemUpdaterType. Endast en uppdatering tillåts i taget i alla webbläsare.

Lyssna efter händelser som definieras i klassen när uppdateringen startar. Följande händelser anger att en uppdatering är slutförd och att en ny uppdatering eller ett försök till uppdatering kan utföras, precis som när funktionen update() anropas:

complete
cancel
securityError
ioError
status

Parametrar

type:String

Relaterade API-element

flash.system.SystemUpdaterType

Händelsedetaljer

cancel

Händelse

Typ av händelseobjekt: flash.events.Event
egenskap Event.type = flash.events.Event.CANCEL

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 10.1

Skickas när en uppdatering av själva spelaren avbryts av användaren. Händelsen skickas bara när en uppdatering av typen SystemUpdaterType.SYSTEM begärs och användaren avbryter uppdateringen.

Event.CANCEL-konstanten definierar värdet på type-egenskapen i ett cancel-händelseobjekt.

Den här händelsen har följande egenskaper:

Egenskap	Värde
`bubbles`	`false`
`cancelable`	`false`; det finns inget standardbeteende att avbryta.
`currentTarget`	Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
`target`	En referens till det objekt vars åtgärd avbryts.

complete

Händelse

Typ av händelseobjekt: flash.events.Event
egenskap Event.type = flash.events.Event.COMPLETE

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 10.1

Skickas när uppdateringen slutförs.

Event.COMPLETE-konstanten definierar värdet på type-egenskapen i ett complete-händelseobjekt.

Den här händelsen har följande egenskaper:

Egenskap	Värde
`bubbles`	`false`
`cancelable`	`false`; det finns inget standardbeteende att avbryta.
`currentTarget`	Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
`target`	Det nätverksobjekt som har lästs in.

ioError

Händelse

Typ av händelseobjekt: flash.events.IOErrorEvent
egenskap IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 10.1

Skickas när ett I/O-fel inträffar. Ett fel som kan orsaka händelsen är t.ex. att Internetuppkopplingen bryts.

Definierar värdet för ett ioError-händelseobjekts type-egenskap.

Den här händelsen har följande egenskaper:

Egenskap	Värde
`bubbles`	`false`
`cancelable`	`false`; det finns inget standardbeteende att avbryta.
`currentTarget`	Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
`errorID`	Ett referensnummer som associeras med det specifika felet (enbart AIR).
`target`	Objektet är med om ett in-/utdatafel.
`text`	Text som visas som felmeddelande.

open

Händelse

Typ av händelseobjekt: flash.events.Event
egenskap Event.type = flash.events.Event.OPEN

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 10.1

Skickas när en uppdatering startar. Uppdateringen är klar när en 'complete'-händelse skickas eller när IOErrorEvent, SecurityErrorEvent eller StatusEvent skickas.

Event.OPEN-konstanten definierar värdet på type-egenskapen i ett open-händelseobjekt.

Den här händelsen har följande egenskaper:

Egenskap	Värde
`bubbles`	`false`
`cancelable`	`false`; det finns inget standardbeteende att avbryta.
`currentTarget`	Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
`target`	Det nätverksobjekt som har öppnat en anslutning.

progress

Händelse

Typ av händelseobjekt: flash.events.ProgressEvent
egenskap ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 10.1

Skickas för att visa hämtningens förlopp. Denna händelse motsvarar händelsen progress i klasserna Loader och URLLoader.

Definierar värdet för ett progress-händelseobjekts type-egenskap.

Den här händelsen har följande egenskaper:

Egenskap	Värde
`bubbles`	`false`
`bytesLoaded`	Antalet objekt eller byte som har lästs in när avlyssnaren bearbetar händelsen.
`bytesTotal`	Det totala antalet objekt eller byte som kommer att ha lästs in om inläsningen lyckas.
`cancelable`	`false`; det finns inget standardbeteende att avbryta.
`currentTarget`	Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
`target`	Objektet rapporterar förlopp.

securityError

Händelse

Typ av händelseobjekt: flash.events.SecurityErrorEvent
egenskap SecurityErrorEvent.type = flash.events.SecurityErrorEvent.SECURITY_ERROR

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 10.1

Skickas när ett säkerhetsfel inträffar. Ett säkerhetsfel som kan utlösa händelsen är t.ex. om spelaren försöker göra en uppdatering när en uppdatering inte tillåts av säkerhetsprinciperna.

Konstanten SecurityErrorEvent.SECURITY_ERROR definierar värdet för ett securityError-händelseobjekts type-egenskap.

Den här händelsen har följande egenskaper:

Egenskap	Värde
`bubbles`	`false`
`cancelable`	`false`; det finns inget standardbeteende att avbryta.
`currentTarget`	Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
`target`	Nätverksobjektet rapporterar säkerhetsfelet.
`text`	Text som visas som felmeddelande.

status

Händelse

Typ av händelseobjekt: flash.events.StatusEvent
egenskap StatusEvent.type = flash.events.StatusEvent.STATUS

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 10.1

Skickas när uppdateringen misslyckas. En uppdatering kan misslyckas på grund av följande:

Den anropande har en plattform eller arkitektur som inte stöds. I sådana fall är värdet för code-egenskapen "DRM.UpdateFailedNotSupported" och värdet för level-egenskapen är "error".
Det begärda uppdateringspaketet kan inte hittas på servern. I sådana fall är värdet för code-egenskapen "DRM.UpdateFailedNotCurrentlyAvailable" och värdet för level-egenskapen är "error".
Adobe Access-modulen är inte installerad. Detta fel liknar koden "DRM.UpdateNeeded" som skickas av NetStatusEvent. I det här fallet måste dock en senare version av Flash Player hämtas först. I sådana fall är värdet för code-egenskapen "DRM.UpdateNeededButIncompatible" och värdet för level-egenskapen är "error". Uppdatera Flash Player genom att anropa SystemUpdater.update(SystemUpdaterType.SYSTEM).
Den nya DRM-modulen kunde inte hämtas. I sådana fall är värdet för code-egenskapen "DRM.UpdateFailed" och värdet för level-egenskapen är "error".

Definierar värdet för ett status-händelseobjekts type-egenskap.

Den här händelsen har följande egenskaper:

Egenskap	Värde
`bubbles`	`false`
`cancelable`	`false`; det finns inget standardbeteende att avbryta.
`kod`	En beskrivning av objektets status.
`currentTarget`	Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
`nivå`	Meddelandets kategori, till exempel `"status"`, `"warning"` eller `"error"`.
`target`	Objektet rapporterar status.

Juridiska meddelanden | Onlinesekretesspolicy

SystemUpdater - AS3

Klasser x

SystemUpdater

cancel

update

cancel

complete

ioError

open

progress

securityError

status