SystemUpdater

Package	flash.system
Classe	public class SystemUpdater
Héritage	SystemUpdater EventDispatcher Object

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 10.1

La classe SystemUpdater permet de mettre à jour les modules de Flash Player, tels que le module DRM pour Adobe Access, ainsi que Flash Player lui-même. Les modules disponibles sont répertoriés dans la classe SystemUpdaterType.

Flash Player identifie la nécessité de mise à jour d’un module Adobe Access en distribuant un événement NetStatusEvent. L’événement possède une propriété code dont la valeur est "DRM.UpdateNeeded". Pour mettre à jour le module Adobe Access, l’autorisation de l’utilisateur n’est pas requise. Ecoutez l’événement et lancez la mise à jour en appelant update("DRM").

Flash Player identifie la nécessité de mise à jour du lecteur en distribuant un événement StatusEvent avec plusieurs valeurs de la propriété code (voir l’événement status). Pour mettre à jour le lecteur, l’autorisation de l’utilisateur n’est pas requise. Ecoutez l’événement et présentez à l’utilisateur l’option de mise à jour. L’utilisateur doit accepter et lancer la mise à jour actuelle, par exemple en cliquant sur un bouton dans l’interface utilisateur. Vous pouvez alors lancer la mise à jour du lecteur directement dans ActionScript en appelant update("SYSTEM").

Remarque : l’API de SystemUpdater est prise en charge sur toutes les plates-formes de bureau.

Eléments de l’API associés

flash.system.SystemUpdaterType

Propriétés publiques

Masquer les propriétés publiques héritées

Afficher les propriétés publiques héritées

	Propriété		Défini par
		constructor : Object Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.	Object

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		SystemUpdater() Constructeur.	SystemUpdater
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement.	EventDispatcher
		cancel():void Annule la mise à jour en cours.	SystemUpdater
		dispatchEvent(event:Event):Boolean Distribue un événement dans le flux d’événements.	EventDispatcher
		hasEventListener(type:String):Boolean Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d’un objet est définie.	Object
		isPrototypeOf(theClass:Object):Boolean Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre.	Object
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Supprime un écouteur de l’objet EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		toLocaleString():String Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.	Object
		toString():String Renvoie la représentation sous forme de chaîne de l’objet spécifié.	Object
		update(type:String):void Commence la mise à jour d’un type donné.	SystemUpdater
		valueOf():Object Renvoie la valeur primitive de l’objet spécifié.	Object
		willTrigger(type:String):Boolean Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié.	EventDispatcher

Evénements

Cliquez pour plus d’informations sur les événements

Masquer les événements hérités

Afficher les événements hérités

	Synthèse	Défini par
activate	[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active.	EventDispatcher
cancel	Distribué lorsque l’utilisateur annule une mise à jour du lecteur.	SystemUpdater
complete	Distribué lorsque la mise à jour se termine.	SystemUpdater
deactivate	[Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive.	EventDispatcher
ioError	Distribué lorsqu’une erreur d’E/S se produit.	SystemUpdater
open	Distribué lorsqu’une mise à jour commence.	SystemUpdater
progress	Distribué pour indiquer la progression du téléchargement.	SystemUpdater
securityError	Distribué lorsqu’une erreur de sécurité est détectée.	SystemUpdater
status	Distribué lorsque la mise à jour échoue.	SystemUpdater

Détails du constructeur

()

Constructeur

public function SystemUpdater()

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 10.1

Constructeur.

Détails de la méthode

cancel

()

méthode

public function cancel():void

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 10.1

Annule la mise à jour en cours.

update

()

méthode

public function update(type:String):void

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 10.1

Commence la mise à jour d’un type donné. Les types de mise à jour sont l’une des constantes de chaîne définies dans la classe SystemUpdaterType. Seule une mise à jour à la fois est autorisée sur l’ensemble des navigateurs.

Lorsque la mise à jour commence, écoutez les événements définis dans cette classe. Les événements suivants indiquent la fin d’une mise à jour et permettent de lancer une nouvelle mise à jour ou de poursuivre une tentative de mise à jour, à l’instar d’un appel de la fonction update() :

complete
cancel
securityError
ioError
status

Paramètres

type:String

Eléments de l’API associés

flash.system.SystemUpdaterType

Détails de l’événement

cancel

Evénement

Type d’objet d’événement: flash.events.Event
propriété Event.type = flash.events.Event.CANCEL

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 10.1

Distribué lorsque l’utilisateur annule une mise à jour du lecteur. Cet événement est distribué uniquement si une mise à jour de type SystemUpdaterType.System est sollicitée et si l’utilisateur annule la mise à jour.

La constante Event.CANCEL définit la valeur de la propriété type d’un objet événement cancel.

Les propriétés de cet événement sont les suivantes :

Propriété	Valeur
`bubbles`	`false`
`cancelable`	`false` ; il n’existe aucun comportement par défaut à annuler.
`currentTarget`	L’objet qui traite activement l’objet Event avec un écouteur d’événements.
`target`	Référence à l’objet pour lequel l’opération est annulée.

complete

Evénement

Type d’objet d’événement: flash.events.Event
propriété Event.type = flash.events.Event.COMPLETE

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 10.1

Distribué lorsque la mise à jour se termine.

La constante Event.COMPLETE définit la valeur de la propriété type d’un objet événement complete.

Les propriétés de cet événement sont les suivantes :

Propriété	Valeur
`bubbles`	`false`
`cancelable`	`false` ; il n’existe aucun comportement par défaut à annuler.
`currentTarget`	L’objet qui traite activement l’objet Event avec un écouteur d’événements.
`target`	Objet réseau dont le chargement est terminé.

ioError

Evénement

Type d’objet d’événement: flash.events.IOErrorEvent
propriété IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 10.1

Distribué lorsqu’une erreur d’E/S se produit. Par exemple, une erreur peut entraîner cet événement en cas de perte de la connexion à Internet.

Définit la valeur de la propriété type d’un objet d’événement ioError.

Les propriétés de cet événement sont les suivantes :

Propriété	Valeur
`bubbles`	`false`
`cancelable`	`false` ; il n’existe aucun comportement par défaut à annuler.
`currentTarget`	L’objet qui traite activement l’objet Event avec un écouteur d’événements.
`errorID`	Un numéro de référence associé à l’erreur spécifique (AIR uniquement).
`target`	Objet réseau sur lequel l’erreur d’entrée/sortie s’est produite.
`text`	Texte à afficher en tant que message d’erreur.

open

Evénement

Type d’objet d’événement: flash.events.Event
propriété Event.type = flash.events.Event.OPEN

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 10.1

Distribué lorsqu’une mise à jour commence. La mise à jour est terminée lorsqu’un événement « complete » est envoyé, ou lorsqu’un événement IOErrorEvent, SecurityErrorEvent ou StatusEvent est envoyé.

La constante Event.OPEN définit la valeur de la propriété type d’un objet événement open.

Les propriétés de cet événement sont les suivantes :

Propriété	Valeur
`bubbles`	`false`
`cancelable`	`false` ; il n’existe aucun comportement par défaut à annuler.
`currentTarget`	L’objet qui traite activement l’objet Event avec un écouteur d’événements.
`target`	Objet réseau qui a ouvert une connexion.

progress

Evénement

Type d’objet d’événement: flash.events.ProgressEvent
propriété ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 10.1

Distribué pour indiquer la progression du téléchargement. Cet événement est similaire à l’événement progress dans les classes Loader et URLLoader.

Définit la valeur de la propriété type d’un objet événement progress.

Les propriétés de cet événement sont les suivantes :

Propriété	Valeur
`bubbles`	`false`
`bytesLoaded`	Nombre d’éléments ou d’octets chargés lors du traitement de l’événement par l’écouteur.
`bytesTotal`	Nombre total d’éléments ou d’octets qui seront chargés si le processus de chargement aboutit.
`cancelable`	`false` ; il n’existe aucun comportement par défaut à annuler.
`currentTarget`	L’objet qui traite activement l’objet Event avec un écouteur d’événements.
`target`	Objet indiquant la progression.

securityError

Evénement

Type d’objet d’événement: flash.events.SecurityErrorEvent
propriété SecurityErrorEvent.type = flash.events.SecurityErrorEvent.SECURITY_ERROR

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 10.1

Distribué lorsqu’une erreur de sécurité est détectée. Par exemple, une erreur de sécurité peut entraîner cet événement si le lecteur tente d’effectuer une mise à jour alors que la stratégie de sécurité ne le permet pas.

La constante SecurityErrorEvent.SECURITY_ERROR définit la valeur de la propriété type d’un objet événement securityError.

Les propriétés de cet événement sont les suivantes :

Propriété	Valeur
`bubbles`	`false`
`cancelable`	`false` ; il n’existe aucun comportement par défaut à annuler.
`currentTarget`	L’objet qui traite activement l’objet Event avec un écouteur d’événements.
`target`	Objet réseau signalant l’erreur de sécurité
`text`	Texte à afficher en tant que message d’erreur.

status

Evénement

Type d’objet d’événement: flash.events.StatusEvent
propriété StatusEvent.type = flash.events.StatusEvent.STATUS

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 10.1

Distribué lorsque la mise à jour échoue. Une mise à jour peut échouer pour l’une des raisons suivantes :

L’appelant est exécuté sur une plate-forme ou une architecture non prise en charge. Dans ce cas, la valeur de la propriété code est "DRM.UpdateFailedNotSupported" et la valeur de la propriété level est "error".
Le package de mises à jour sollicité ne peut pas se trouver sur le serveur. Dans ce cas, la valeur de la propriété code est "DRM.UpdateFailedNotCurrentlyAvailable" et la valeur de la propriété level est "error".
Le module Adobe Access n’est pas installé. Cette erreur est similaire au code "DRM.UpdateNeeded", distribué par NetStatusEvent. Le cas échéant, vous devez cependant télécharger en premier lieu une version plus récente de Flash Player. Dans ce cas, la valeur de la propriété code est "DRM.UpdateNeededButIncompatible" et la valeur de la propriété level est "error". Pour effectuer une mise à jour de Flash Player, appelez SystemUpdater.update(SystemUpdaterType.SYSTEM).
Le téléchargement du nouveau module DRM a échoué. Dans ce cas, la valeur de la propriété code est "DRM.UpdateFailed" et la valeur de la propriété level est "error".

Définit la valeur de la propriété type d’un objet événement status.

Les propriétés de cet événement sont les suivantes :

Propriété	Valeur
`bubbles`	`false`
`cancelable`	`false` ; il n’existe aucun comportement par défaut à annuler.
`code`	Description de l’état de l’objet.
`currentTarget`	L’objet qui traite activement l’objet Event avec un écouteur d’événements.
`level`	Catégorie du message, telle que `"status"`, `"warning"` ou `"error"`.
`target`	Objet publiant son état.

Informations juridiques | Politique de confidentialité en ligne

SystemUpdater - AS3

Classes x

SystemUpdater

cancel

update

cancel

complete

ioError

open

progress

securityError

status