Package | fl.rsl |
Classe | public class RSLPreloader |
Héritage | RSLPreloader EventDispatcher Object |
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS5 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
RSLEvent.RSL_LOAD_COMPLETE
, RSLErrorEvent.RSL_LOAD_FAILED
ou RSLEvent.RSL_PROGRESS
) pour indiquer l’état de chargement des fichiers RSL.
Eléments de l’API associés
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 | ||
debugWaitTime : int
Définissez cette valeur sur le nombre de millisecondes à attendre avant le téléchargement du premier fichier RSL. | RSLPreloader | ||
numRSLInfos : int [lecture seule]
Nombre d’occurrences ajoutées via RSLInfo addRSLInfo(). | RSLPreloader |
Méthode | Défini par | ||
---|---|---|---|
RSLPreloader(mainTimeline:MovieClip = null)
Constructeur. | RSLPreloader | ||
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 | ||
Ajoute un enregistrement RSLInfo descriptif à un fichier SWF ou SWZ en cours de téléchargement. | RSLPreloader | ||
Distribue un événement dans le flux d’événements. | EventDispatcher | ||
Récupère l’enregistrement RSLInfo ajouté via addRSLInfo() à l’index spécifié. | RSLPreloader | ||
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 | ||
La méthode loadContent est appelée à partir de l’image 2 du fichier d’enveloppe SWF lorsque le nom d’une classe de contenu est fourni à la méthode start(). | RSLPreloader | ||
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 | ||
Commence le téléchargement des fichiers RSL. | RSLPreloader | ||
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 | ||
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 | |||
[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é par RSLPreloader lorsque le téléchargement de tous les fichiers RSL est terminé. | RSLPreloader | |||
Distribué par RSLPreloader lorsque le téléchargement de tous les fichiers RSL est terminé et qu’un ou plusieurs fichiers n’ont pas été téléchargés correctement. | RSLPreloader | |||
Distribué par RSLPreloader pour indiquer la progression du téléchargement des fichiers RSL. | RSLPreloader |
debugWaitTime | propriété |
debugWaitTime:int
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS5 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
Définissez cette valeur sur le nombre de millisecondes à attendre avant le téléchargement du premier fichier RSL. Cette propriété est un moyen de simuler l’expérience de l’utilisateur final et de tester la boucle de préchargement. Elle est particulièrement utile pour tester les fichiers RSL signés mis en cache (fichiers SWZ) en vue de déterminer un retard de chargement sans vider la mémoire cache des fichiers SWZ. Désactivez tout code définissant cette valeur sur une valeur supérieure à 0 avant le déploiement. Utilisez une constante de configuration de débogage (telle que CONFIG::DEBUG
) pour appeler le code. Une autre suggestion est de définir le retard sur une valeur suffisamment élevée, telle que 5 000 (ce qui équivaut à 5 secondes), comme un rappel pour supprimer le code de débogage. Pour les occurrences de RSLLoader qui sont générées automatiquement par l’environnement de création, il est possible de déterminer le délai en définissant une méthode setRSLPreloader(value:RSLPreloader):void
dans le fichier SWF de l’animation de chargement ou dans le code du scénario principal.
import fl.rsl.RSLPreloader; function setRSLPreloader(preloader:RSLPreloader):void { preloader.debugWaitTime = 10000; }
La valeur par défaut est 0.
Implémentation
public function get debugWaitTime():int
public function set debugWaitTime(value:int):void
numRSLInfos | propriété |
numRSLInfos:int
[lecture seule] Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS5 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
Nombre d’occurrences ajoutées via addRSLInfo()
.
for(var i:int = 0; i < myPreloader.numRSLInfos; i++) { trace('rsl ' + i); var urls:Array = myPreloader.getRSLInfoAt(i).rslURLs; for(var j:int = 0; j < urls.length; j++) { trace(' url: ' + urls[j]); } }
Implémentation
public function get numRSLInfos():int
Eléments de l’API associés
RSLPreloader | () | Constructeur |
public function RSLPreloader(mainTimeline:MovieClip = null)
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS5 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
Constructeur. Lorsque l’environnement de création génère du code automatiquement pour précharger des fichiers SWZ, ce constructeur est transmis dans la classe du scénario principal en tant qu’argument. Il n’est généralement pas utilisé dans les blocs de code de l’utilisateur final.
ParamètresmainTimeline:MovieClip (default = null )
|
addRSLInfo | () | méthode |
public function addRSLInfo(info:RSLInfo):void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS5 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
Ajoute un enregistrement RSLInfo descriptif à un fichier SWF ou SWZ en cours de téléchargement.
import fl.rsl.RSLInfo; var info:RSLInfo = new RSLInfo(); info.addEntry('rsl.swf'); myPreloader.addRSLInfo(info); myPreloader.start();
Paramètres
info:RSLInfo |
getRSLInfoAt | () | méthode |
public function getRSLInfoAt(index:int):RSLInfo
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS5 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
Récupère l’enregistrement RSLInfo ajouté via addRSLInfo()
à l’index spécifié. L’index correspond à l’ordre dans lequel les enregistrements ont été ajoutés via addRSLInfo()
.
for (var i:int = 0; i < myPreloader.numRSLInfos; i++) { trace('rsl ' + i); var urls:Array = myPreloader.getRSLInfoAt(i).rslURLs; for (var j:int = 0; j < urls.length; j++) { trace(' url: ' + urls[j]); } }
Paramètres
index:int |
RSLInfo |
Eléments de l’API associés
loadContent | () | méthode |
public function loadContent():void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS5 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
La méthode loadContent est appelée à partir de l’image 2 du fichier d’enveloppe SWF lorsque le nom d’une classe de contenu est fourni à la méthode start(). Elle n’est généralement pas utilisée dans les blocs de code de l’utilisateur final.
Eléments de l’API associés
start | () | méthode |
public function start(preloaderAnimClass:Class = null, contentClassName:String = null):void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS5 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
Commence le téléchargement des fichiers RSL. Cette fonction ne doit pas être appelée tant que tous les enregistrements RSLInfo n’ont pas été ajoutés via addRSLInfo()
. Deux arguments facultatifs peuvent être utilisés lorsque l’environnement de création génère du code automatiquement. Le premier est une sous-classe de ByteArray permettant de charger une animation SWF de préchargement. Le deuxième est le nom d’une sous-classe de ByteArray pour le fichier SWF de contenu. Ces arguments ne sont généralement pas utilisés dans les blocs de code de l’utilisateur final.
Paramètres
preloaderAnimClass:Class (default = null )
| |
contentClassName:String (default = null )
|
Eléments de l’API associés
rslLoadComplete | Evénement |
fl.events.RSLEvent
propriété RSLEvent.type =
fl.events.RSLEvent.RSL_LOAD_COMPLETE
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS5 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
Distribué par RSLPreloader lorsque le téléchargement de tous les fichiers RSL est terminé.
Evénement distribué parRSLPreloader
lorsque le téléchargement de tous les fichiers RSL est terminé. Les propriétés bytesLoaded
et bytesTotal
ont toujours pour valeur 0 pour ce type d’événement. En cas de préchargement avec une boucle d’événement personnalisé, le contenu de l’utilisateur DOIT écouter cet événement pour savoir quand quitter la boucle d’animation de chargement.
Les propriétés de cet événement sont les suivantes :
Propriété | Valeur |
---|---|
bubbles | true |
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 | Occurrence de DisplayObject ajoutée à la liste d’affichage. La propriété target ne correspond pas toujours à l’objet de la liste d’affichage qui est associé à l’écouteur d’événement. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d’affichage qui traite actuellement l’événement. |
rslsLoaded | Nombre de fichiers qui ont été téléchargés correctement. |
rslsFailed | Nombre de fichiers dont le téléchargement a échoué. |
rslsTotal | Nombre total de fichiers correctement téléchargés ou non. |
bytesLoaded | Nombre total d’octets téléchargés dans les fichiers correctement téléchargés. |
bytesTotal | Nombre total d’octets téléchargés dans les fichiers téléchargés, correctement ou non. |
import fl.events.RSLEvent; myPreloader.addEventListener(RSLEvent.RSL_LOAD_COMPLETE, loadComplete); function loadComplete(e:RSLEvent) { gotoAndPlay('startOfContent'); }
rslLoadFailed | Evénement |
fl.events.RSLErrorEvent
propriété RSLErrorEvent.type =
fl.events.RSLErrorEvent.RSL_LOAD_FAILED
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS5 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
Distribué par RSLPreloader lorsque le téléchargement de tous les fichiers RSL est terminé et qu’un ou plusieurs fichiers n’ont pas été téléchargés correctement.
Erreur distribuée parRSLPreloader
lorsque le téléchargement de tous les fichiers RSL est terminé et qu’un ou plusieurs fichiers n’ont pas été téléchargés correctement. En cas de préchargement avec une boucle d’événement personnalisé, le contenu de l’utilisateur DOIT écouter cet événement pour savoir quand quitter la boucle d’animation de chargement.
Les propriétés de cet événement sont les suivantes :
Propriété | Valeur |
---|---|
bubbles | true |
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 | Occurrence de DisplayObject ajoutée à la liste d’affichage. La propriété target ne correspond pas toujours à l’objet de la liste d’affichage qui est associé à l’écouteur d’événement. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d’affichage qui traite actuellement l’événement. |
rslsLoaded | Nombre de fichiers qui ont été téléchargés correctement. |
rslsFailed | Nombre de fichiers dont le téléchargement a échoué. |
rslsTotal | Nombre total de fichiers correctement téléchargés ou non. |
failedURLs | Tableau de fichiers dont le téléchargement a échoué. |
import fl.events.RSLErrorEvent; myPreloader.addEventListener(RSLErrorEvent.RSL_LOAD_FAILED, rslLoadFailedHandler); function rslLoadFailedHandler(e:RSLErrorEvent) { gotoAndPlay('rslLoadFailure'); }
rslProgress | Evénement |
fl.events.RSLEvent
propriété RSLEvent.type =
fl.events.RSLEvent.RSL_PROGRESS
Version du langage: | ActionScript 3.0 |
Version du produit: | Flash CS5 |
Versions du moteur d’exécution: | Flash Player 10.1, AIR 2 |
Distribué par RSLPreloader pour indiquer la progression du téléchargement des fichiers RSL.
Evénement distribué parRSLPreloader
pour indiquer la progression du téléchargement des fichiers RSL. Il s’agit du seul type d’événement pour lequel les propriétés bytesLoaded
et bytesTotal
ne sont pas égales à zéro.
Les propriétés de cet événement sont les suivantes :
Propriété | Valeur |
---|---|
bubbles | true |
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 | Occurrence de DisplayObject ajoutée à la liste d’affichage. La propriété target ne correspond pas toujours à l’objet de la liste d’affichage qui est associé à l’écouteur d’événement. Utilisez la propriété currentTarget pour accéder à l’objet de la liste d’affichage qui traite actuellement l’événement. |
rslsLoaded | Nombre de fichiers qui ont été téléchargés correctement. |
rslsFailed | Nombre de fichiers dont le téléchargement a échoué. |
rslsTotal | Nombre total de fichiers correctement téléchargés ou non. |
bytesLoaded | Nombre total d’octets téléchargés dans les fichiers correctement téléchargés. |
bytesTotal | Nombre total d’octets téléchargés dans les fichiers téléchargés, correctement ou non. |
import fl.events.RSLEvent; myPreloader.addEventListener(RSLEvent.RSL_PROGRESS, progressHandler); function progressHandler(e:RSLEvent) { trace('rslsLoaded = ' + e.rslsLoaded); trace('rslsFailed = ' + e.rslsFailed); trace('rslsTotal = ' + e.rslsTotal); trace('bytesLoaded = ' + e.bytesLoaded); trace('bytesTotal = ' + e.bytesTotal); }
Tue Jun 12 2018, 09:30 AM Z