| 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 |
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
Masquer les propriétés publiques héritées
Afficher les propriétés publiques héritées| Méthode | Défini par | ||
|---|---|---|---|
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 | |
Annule la mise à jour en cours. | SystemUpdater | ||
|
Distribue un événement dans le flux d’événements. | EventDispatcher | |
|
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | |
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
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 | |
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | |
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
|
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | |
Commence la mise à jour d’un type donné. | SystemUpdater | ||
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
|
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énement | Synthèse | Défini par | ||
|---|---|---|---|---|
| [Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active. | EventDispatcher | ||
| Distribué lorsque l’utilisateur annule une mise à jour du lecteur. | SystemUpdater | |||
| Distribué lorsque la mise à jour se termine. | SystemUpdater | |||
| [Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive. | EventDispatcher | ||
| Distribué lorsqu’une erreur d’E/S se produit. | SystemUpdater | |||
| Distribué lorsqu’une mise à jour commence. | SystemUpdater | |||
| Distribué pour indiquer la progression du téléchargement. | SystemUpdater | |||
| Distribué lorsqu’une erreur de sécurité est détectée. | SystemUpdater | |||
| Distribué lorsque la mise à jour échoue. | SystemUpdater | |||
SystemUpdater | () | Constructeur |
public function SystemUpdater()| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 10.1 |
Constructeur.
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() :
completecancelsecurityErrorioErrorstatus
Paramètres
type:String |
Eléments de l’API associés
cancel | Evénement |
flash.events.Eventproprié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.
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 |
flash.events.Eventproprié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 constanteEvent.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 |
flash.events.IOErrorEventproprié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 |
flash.events.Eventproprié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 constanteEvent.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 |
flash.events.ProgressEventproprié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.
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 |
flash.events.SecurityErrorEventproprié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 constanteSecurityErrorEvent.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 |
flash.events.StatusEventproprié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é
codeest "DRM.UpdateFailedNotSupported" et la valeur de la propriétélevelest "error". - Le package de mises à jour sollicité ne peut pas se trouver sur le serveur. Dans ce cas, la valeur de la propriété
codeest "DRM.UpdateFailedNotCurrentlyAvailable" et la valeur de la propriétélevelest "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é
codeest "DRM.UpdateNeededButIncompatible" et la valeur de la propriétélevelest "error". Pour effectuer une mise à jour de Flash Player, appelezSystemUpdater.update(SystemUpdaterType.SYSTEM). - Le téléchargement du nouveau module DRM a échoué. Dans ce cas, la valeur de la propriété
codeest "DRM.UpdateFailed" et la valeur de la propriétélevelest "error".
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. |
Tue Jun 12 2018, 09:30 AM Z