ProLoaderInfo  - AS3 Flash

Version ActionScript du fichier SWF chargé. La version du langage est spécifiée par le biais des énumérations de la classe ActionScriptVersion, telles que ActionScriptVersion.ACTIONSCRIPT2 et ActionScriptVersion.ACTIONSCRIPT3.

Remarque : cette propriété possède toujours la valeur ActionScriptVersion.ACTIONSCRIPT2 ou ActionScriptVersion.ACTIONSCRIPT3. ActionScript 1.0 et 2.0 correspondent tous deux à ActionScriptVersion.ACTIONSCRIPT2 (version 2.0). Cette propriété se contente de distinguer ActionScript 1.0 et 2.0 d’ActionScript 3.0.

Eléments de l’API associés

Lorsqu’un fichier SWF externe est chargé, toutes les définitions ActionScript 3.0 que contient la classe chargée sont enregistrées dans la propriété applicationDomain.

L’ensemble du code d’un fichier SWF est défini de sorte à exister dans un domaine d’application. Votre application principale s’exécute dans le domaine d’application en cours. Le domaine du système contient tous les domaines d’application, y compris le domaine actuel et toutes les classes utilisées par Flash Player ou Adobe AIR.

A l’exception du domaine du système, tous les domaines d’application sont associés à un domaine du parent. Le domaine du parent de la propriété applicationDomain de votre application principale est le domaine système. Les classes chargées ne sont définies que si leur parent ne les définit pas encore. Vous ne pouvez pas remplacer une définition de classe chargée par une définition plus récente.

Pour obtenir des exemples d’utilisation de domaines d’application, voir le chapitre « Environnement du système client » du Guide du développeur d’ActionScript 3.0.

Eléments de l’API associés

Octets associés à un objet ProLoaderInfo.

Eléments de l’API associés

Nombre d’octets chargés pour le média. Lorsque ce nombre atteint la valeur de bytesTotal, tous les octets sont chargés.

Eléments de l’API associés

Avant que l’objet ProLoader correspondant à cet objet ne distribue le premier événement progress, bytesTotal est défini sur 0. Après que l’objet ProLoader a distribué le premier événement progress, bytesTotal indique le nombre réel d’octets à télécharger.

Eléments de l’API associés

Exprime la relation de confiance qui lie le contenu (l’enfant) à l’objet ProLoader (le parent). Renvoie true si l’enfant a autorisé l’accès du parent, false dans le cas contraire. Cette propriété est définie sur true si l’objet enfant a appelé la méthode allowDomain() pour accorder une autorisation d’accès au domaine parent, ou si un fichier de régulation d’URL chargé dans le domaine enfant accorde une autorisation d’accès au domaine parent. Si l’enfant et le parent appartiennent au même domaine, cette propriété est réglée sur true.

Pour plus d’informations concernant la sécurité, voir la rubrique du Pôle de développement Flash Player : Sécurité (disponible en anglais uniquement).

Eléments de l’API associés

Objet pouvant être défini par le code du contenu chargé pour exposer des propriétés et des méthodes auxquelles le code dans le sandbox de l’objet ProLoader peut accéder. Ce pont de sandboxpermet au contenu d’un domaine qui n’est pas un domaine d’application de bénéficier d’un accès contrôlé aux scripts dans le sandbox de l’application AIR, et vice-versa. Le pont de sandbox sert de passerelle entre les sandboxes, fournissant une interaction explicite entre les sandboxes de sécurité de l’application et les autres.

Eléments de l’API associés

Objet chargé associé à cet objet ProLoaderInfo.

Eléments de l’API associés

Type MIME du fichier chargé. Le paramètre est défini sur null si le pourcentage chargé du fichier est insuffisant pour déterminer le type. La liste suivante répertorie les valeurs gérées :

• "application/x-shockwave-flash"
• "image/jpeg"
• "image/gif"
• "image/png"

Eléments de l’API associés

Cadence nominale, en images par seconde, du fichier SWF chargé. Cette valeur correspond souvent, mais pas nécessairement, à un entier.

Elle peut être différente de la cadence utilisée. Flash Player ou Adobe AIR utilise la même cadence pour tous les fichiers SWF chargés. Cette valeur est déterminée par la cadence nominale du fichier SWF principal. De même, la cadence principale risque de ne pas pouvoir être atteinte, selon le matériel, la synchronisation du son, et d’autres facteurs.

Eléments de l’API associés

Hauteur nominale du fichier chargé. Elle peut être différente de la hauteur réelle du contenu affiché, car le contenu chargé ou ses objets d’affichage parent risquent d’avoir été redimensionnés.

Eléments de l’API associés

Indique si la propriété ProLoaderInfo.url a été tronquée. Lorsque la valeur isURLInaccessible est définie sur true, la valeur ProLoaderInfo.url correspond uniquement au domaine de l’URL finale à partir de laquelle le contenu a été chargé. Par exemple, la propriété est tronquée si le contenu est chargé à partir de http://www.adobe.com/assets/hello.swf, et la propriété ProLoaderInfo.url a la valeur http://www.adobe.com. La valeur isURLInaccessible est définie sur true uniquement lorsque toutes les affirmations suivantes sont également vraies :

• Une redirection HTTP s’est produite lors du chargement du contenu.
• Le fichier SWF qui appelle ProLoader.load() provient d’un domaine différent de celui de l’URL finale du contenu.
• Le fichier SWF qui appelle ProLoader.load() n’est pas autorisé à accéder au contenu. L’autorisation d’accéder au contenu s’obtient de la même façon que l’autorisation d’accéder à BitmapData.draw() : appelez Security.allowDomain() pour accéder à un fichier SWF (ou pour le contenu des fichiers non SWF, créez un fichier de régulation et utilisez la propriété LoaderContext.checkPolicyFile).

Remarque : la propriété isURLInaccessible a été ajoutée à Flash Player 10.1 et AIR 2.0. Toutefois, cette propriété est disponible pour les fichiers SWF de toutes les versions lorsque le moteur d’exécution de Flash la prend en charge. Ainsi, l’utilisation de certains outils de création en « mode strict » entraîne une erreur de compilation. Pour contourner cette erreur, utilisez la syntaxe indirecte myLoaderInfo["isURLInaccessible"] ou désactivez le mode strict. Si vous utilisez Flash Professional CS5 ou le kit SDK Flex version 4.1, vous pouvez utiliser et compiler cette API pour les moteurs d’exécution publiés avant Flash Player 10.1 et AIR 2.

Pour le contenu de l’application dans AIR, la valeur de cette propriété est toujours false.

Eléments de l’API associés

Objet ProLoader associé à cet objet ProLoaderInfo. Si cet objet ProLoaderInfo figure dans la propriété loaderInfo de l’occurrence de la classe principale du fichier SWF, il n’est associé à aucun objet ProLoader.

Eléments de l’API associés

URL du fichier SWF qui a initié le chargement du média décrit par l’objet ProLoaderInfo. Pour l’occurrence de la classe principale du fichier SWF, cette URL correspond à l’URL du fichier SWF.

Eléments de l’API associés

Objet contenant des paires nom-valeur qui représentent les paramètres fournis au fichier SWF chargé.

L’utilisation d’une boucle for-in vous permet d’extraire tous les noms et toutes les valeurs de l’objet parameters.

Les deux sources de paramètres sont : la chaîne de requête que contient l’URL du fichier SWF principal et la valeur du paramètre HTML FlashVars (qui n’affecte que le fichier SWF principal).

La propriété parameters remplace la technique ActionScript 1.0 et 2.0 qui consistait à utiliser des paramètres de fichier SWF en tant que propriétés du scénario principal.

La valeur de la propriété parameters est null pour les objets ProLoader qui contiennent des fichiers SWF faisant appel à ActionScript 1.0 ou 2.0. Elle est différente de null pour les objets ProLoader qui contiennent des fichiers SWF ayant recours à ActionScript 3.0.

Eléments de l’API associés

Exprime la relation de confiance qui lie l’objet ProLoader (le parent) au contenu (l’enfant). Renvoie true si le parent a autorisé l’accès de l’enfant, false dans le cas contraire. Cette propriété est définie sur true si l’objet parent a appelé la méthode allowDomain() pour accorder une autorisation d’accès au domaine enfant, ou si un fichier de régulation d’URL chargé dans le domaine parent accorde une autorisation d’accès au domaine enfant. Si l’enfant et le parent appartiennent au même domaine, cette propriété est réglée sur true.

Pour plus d’informations concernant la sécurité, voir la rubrique du Pôle de développement Flash Player : Sécurité (disponible en anglais uniquement).

Eléments de l’API associés

Objet pouvant être défini par le code dans le sandbox de l’objet ProLoader pour exposer les propriétés et les méthodes auxquelles le code du contenu chargé peut accéder. Ce pont de sandboxpermet au contenu d’un domaine qui n’est pas un domaine d’application de bénéficier d’un accès contrôlé aux scripts dans le sandbox de l’application AIR, et vice-versa. Le pont de sandbox sert de passerelle entre les sandboxes, fournissant une interaction explicite entre les sandboxes de sécurité de l’application et les autres.

Eléments de l’API associés

Exprime la relation entre les domaines de l’objet loader et du contenu : true s’ils proviennent du même domaine ; false dans tous les autres cas.

Eléments de l’API associés

Des problèmes de temporisation lors du chargement du contenu provoquent le préchargement du fichier RSL ; il est donc recommandé d’attendre la réception de l’événement init pour ajouter des écouteurs d’événement à l’objet sharedEvents, ou pour les rajouter une fois l’événement init reçu.

Eléments de l’API associés

Version du format du fichier SWF chargé. Le format du fichier est spécifié par le biais des énumérations de la classe SWFVersion, telles que SWFVersion.FLASH7 et SWFVersion.FLASH9.

Eléments de l’API associés

URL du média en cours de chargement.

Avant la distribution du premier événement progress par l’objet ProLoader correspondant à cet objet ProLoaderInfo, la valeur de la propriété url risque de refléter uniquement l’URL initiale spécifiée par l’appel de la méthode load() de l’objet ProLoader. Après la distribution du premier événement progress, la propriété url reflète l’URL finale du média, suite à la résolution de toute redirection et URL relative.

Dans certains cas, la valeur de la propriété url est tronquée. Voir la propriété isURLInaccessible pour plus d’informations.

Largeur nominale du contenu chargé. Elle peut être différente de la largeur réelle du contenu affiché, car le contenu chargé ou ses objets d’affichage parent risquent d’avoir été redimensionnés.

Eléments de l’API associés