SystemUpdater

Pacchetto	flash.system
Classe	public class SystemUpdater
Ereditarietà	SystemUpdater EventDispatcher Object

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 10.1

La classe SystemUpdater consente di aggiornare i moduli di Flash Player, ad esempio il modulo DRM per Adobe Access, così come il lettore Flash Player stesso. I moduli disponibili sono elencati nella classe SystemUpdaterType.

Flash Player identifica la necessità di aggiornare il modulo Adobe Access inviando un evento NetStatusEvent. L’evento ha una proprietà code con valore "DRM.UpdateNeeded". Per gli aggiornamenti del modulo Adobe Access, l’autorizzazione dell’utente non è richiesta. Intercettate l'evento e avviate l'aggiornamento chiamando update("DRM").

Flash Player identifica la necessità di aggiornare il lettore inviando un evento StatusEvent, con vari valori possibili della proprietà code (vedete l'evento status). Per gli aggiornamenti del lettore è necessaria l'autorizzazione dell'utente. Intercettate l'evento e visualizzate all'utente l'opzione di effettuare l'aggiornamento. L'utente deve acconsentire all'aggiornamento e avviarlo, ad esempio facendo clic su un pulsante nell'interfaccia utente. Potete quindi avviare l'aggiornamento del lettore direttamente in ActionScript chiamando update("SYSTEM").

Nota: l'API SystemUpdater è supportata in tutte le piattaforme desktop.

Elementi API correlati

flash.system.SystemUpdaterType

Proprietà pubbliche

Nascondi proprietà pubbliche ereditate

Mostra proprietà pubbliche ereditate

	Proprietà		Definito da
		constructor : Object Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.	Object

Metodi pubblici

Nascondi metodi pubblici ereditati

Mostra metodi pubblici ereditati

	Metodo		Definito da
		SystemUpdater() Funzione di costruzione.	SystemUpdater
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registra un oggetto listener di eventi con un oggetto EventDispatcher, in modo che il listener riceva la notifica di un evento.	EventDispatcher
		cancel():void Annulla un aggiornamento attivo.	SystemUpdater
		dispatchEvent(event:Event):Boolean Invia un evento nel flusso di eventi.	EventDispatcher
		hasEventListener(type:String):Boolean Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indica se per un oggetto è definita una proprietà specifica.	Object
		isPrototypeOf(theClass:Object):Boolean Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.	Object
		propertyIsEnumerable(name:String):Boolean Indica se la proprietà specificata esiste ed è enumerabile.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Rimuove un listener dall'oggetto EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.	Object
		toLocaleString():String Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.	Object
		toString():String Restituisce la rappresentazione in formato stringa dell'oggetto specificato.	Object
		update(type:String):void Inizia un aggiornamento di un tipo specifico.	SystemUpdater
		valueOf():Object Restituisce il valore di base dell'oggetto specificato.	Object
		willTrigger(type:String):Boolean Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato.	EventDispatcher

Eventi

Fate clic per visualizzare altre informazioni sugli eventi

Nascondi eventi ereditati

Mostra eventi ereditati

	Riepilogo	Definito da
activate	[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR ottiene lo stato di attivazione del sistema operativo ed entra nello stato attivo.	EventDispatcher
cancel	Inviato quando un aggiornamento del lettore stesso viene annullato dall'utente.	SystemUpdater
complete	Inviato quando l'aggiornamento viene completato.	SystemUpdater
deactivate	[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR perde l'attivazione del sistema operativo e sta entrando nello stato inattivo.	EventDispatcher
ioError	Inviato quando si verifica un errore I/O.	SystemUpdater
open	Inviato quando un aggiornamento ha inizio.	SystemUpdater
progress	Inviato per indicare l'avanzamento del download.	SystemUpdater
securityError	Inviato in caso di errore di sicurezza.	SystemUpdater
status	Inviato quando l'aggiornamento fallisce.	SystemUpdater

Descrizione della funzione di costruzione

()

Funzione di costruzione

public function SystemUpdater()

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 10.1

Funzione di costruzione.

Descrizione dei metodi

cancel

()

metodo

public function cancel():void

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 10.1

Annulla un aggiornamento attivo.

update

()

metodo

public function update(type:String):void

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 10.1

Inizia un aggiornamento di un tipo specifico. Il tipo di aggiornamento è una delle costanti stringa definite nella classe SystemUpdaterType. È consentito un solo aggiornamento alla volta su tutti i browser.

Dopo l'inizio dell'aggiornamento, intercettate gli eventi definiti in questa classe. I seguenti eventi indicano la fine di un aggiornamento e consentono l'esecuzione di un nuovo aggiornamento o tentativo di aggiornamento, così come una chiamata alla funzione update():

complete
cancel
securityError
ioError
status

Parametri

type:String

Elementi API correlati

flash.system.SystemUpdaterType

Descrizione degli eventi

cancel

Evento

Tipo di oggetto evento: flash.events.Event
proprietà Event.type = flash.events.Event.CANCEL

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 10.1

Inviato quando un aggiornamento del lettore stesso viene annullato dall'utente. Questo evento viene inviato solo quando è richiesto un aggiornamento del tipo SystemUpdaterType.SYSTEM e l'utente annulla l'aggiornamento.

La costante Event.CANCEL definisce il valore della proprietà type di un oggetto evento cancel.

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
`target`	Un riferimento all'oggetto sul quale viene annullata l'operazione.

complete

Evento

Tipo di oggetto evento: flash.events.Event
proprietà Event.type = flash.events.Event.COMPLETE

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 10.1

Inviato quando l'aggiornamento viene completato.

La costante Event.COMPLETE definisce il valore della proprietà type di un oggetto evento complete.

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
`target`	L'oggetto di rete che ha completato il caricamento.

ioError

Evento

Tipo di oggetto evento: flash.events.IOErrorEvent
proprietà IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 10.1

Inviato quando si verifica un errore I/O. Ad esempio, un errore che può causare questo evento è l'interruzione della connettività Internet.

Definisce il valore della proprietà type di un oggetto evento ioError.

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
`errorID`	Un numero di riferimento associato all'errore specifico (solo AIR).
`target`	L'oggetto di rete interessato dall'errore di input/output.
`text`	Testo da visualizzare come messaggio di errore.

open

Evento

Tipo di oggetto evento: flash.events.Event
proprietà Event.type = flash.events.Event.OPEN

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 10.1

Inviato quando un aggiornamento ha inizio. L'aggiornamento è completo quando viene inviato un evento 'complete' oppure quando viene inviato un evento IOErrorEvent, SecurityErrorEvent o StatusEvent.

La costante Event.OPEN definisce il valore della proprietà type di un oggetto evento open.

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
`target`	L'oggetto di rete che ha aperto una connessione.

progress

Evento

Tipo di oggetto evento: flash.events.ProgressEvent
proprietà ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 10.1

Inviato per indicare l'avanzamento del download. Questo evento equivale all'evento progress nelle classi Loader e URLLoader.

Definisce il valore della proprietà type di un oggetto evento progress.

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`bytesLoaded`	Il numero di elementi o di byte caricati nel momento in cui il listener elabora l'evento.
`bytesTotal`	Il numero totale di elementi o byte che vengono caricati se il processo di caricamento viene completato correttamente.
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
`target`	L'oggetto che riporta l'avanzamento.

securityError

Evento

Tipo di oggetto evento: flash.events.SecurityErrorEvent
proprietà SecurityErrorEvent.type = flash.events.SecurityErrorEvent.SECURITY_ERROR

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 10.1

Inviato in caso di errore di sicurezza. Ad esempio, un errore di sicurezza che può causare questo evento si verifica se il lettore tenta di eseguire un aggiornamento ma i criteri di sicurezza non lo consentono.

La costante SecurityErrorEvent.SECURITY_ERROR definisce il valore della proprietà type di un oggetto evento securityError.

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
`target`	L'oggetto di rete che riporta l'errore di sicurezza.
`text`	Testo da visualizzare come messaggio di errore.

status

Evento

Tipo di oggetto evento: flash.events.StatusEvent
proprietà StatusEvent.type = flash.events.StatusEvent.STATUS

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 10.1

Inviato quando l'aggiornamento fallisce. Un aggiornamento può dare esito negativo per uno dei motivi seguenti:

Il chiamante è in esecuzione su una piattaforma o architettura non supportata. In questo caso, il valore della proprietà code è "DRM.UpdateFailedNotSupported" e quello della proprietà level è "error".
Il pacchetto di aggiornamento richiesto non può essere situato sul server. In questo caso, il valore della proprietà code è "DRM.UpdateFailedNotCurrentlyAvailable" e quello della proprietà level è "error".
Il modulo Adobe Access non è installato. Questo errore è simile al codice "DRM.UpdateNeeded", che viene inviato da NetStatusEvent. Tuttavia, in questo caso, deve prima essere scaricata una versione più recente di Flash Player. In questo caso, il valore della proprietà code è "DRM.UpdateNeededButIncompatible" e quello della proprietà level è "error". Per eseguire un aggiornamento di Flash Player, chiamate SystemUpdater.update(SystemUpdaterType.SYSTEM).
Non è stato possibile scaricare il nuovo modulo DRM. In questo caso, il valore della proprietà code è "DRM.UpdateFailed" e quello della proprietà level è "error".

Definisce il valore della proprietà type di un oggetto evento status.

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`code`	Una descrizione dello stato dell'oggetto.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
`level`	La categoria del messaggio, ad esempio `"status"`, `"warning"` o `"error"`.
`target`	L'oggetto che riporta il proprio stato.

Note legali | Informativa sulla privacy online

SystemUpdater - AS3

Classi x

SystemUpdater

cancel

update

cancel

complete

ioError

open

progress

securityError

status