| Package | flash.media |
| Classe | public class AVURLLoader |
| Héritage | AVURLLoader  URLLoader EventDispatcher Object |
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Un objet URLLoader télécharge toutes les données d’une URL avant de les mettre à disposition du code dans les applications. Il fournit des notifications sur la progression du téléchargement, que vous pouvez connaître en surveillant les propriétés bytesLoaded et bytesTotal, ainsi que les événements distribués.
Dans le cas de chargements de fichiers vidéo très volumineux, tels que des FLV, des erreurs de mémoire insuffisante peuvent se produire.
Lorsque vous employez cette classe dans Flash Player et dans le contenu de l’application AIR d’un sandbox de sécurité autre que celui de l’application, tenez compte du modèle de sécurité suivant :
- Un fichier SWF du sandbox local avec système de fichiers risque de ne pas charger des données depuis une ressource située dans le sandbox réseau, ni lui en fournir.
- Par défaut, le fichier SWF appelant et l’URL chargée doivent se trouver dans le même domaine. Par exemple, un fichier SWF à l’adresse www.adobe.com peut charger uniquement des données provenant de sources situées aussi à l’adresse www.adobe.com. Pour charger des données à partir d’un autre domaine, placez un fichier de régulation d’URL sur le serveur hébergeant les données.
Pour plus d’informations concernant la sécurité, voir la rubrique du Pôle de développement Adobe Flash Player : Sécurité (disponible en anglais uniquement).
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| Propriété | Défini par | ||
|---|---|---|---|
 | bytesLoaded : uint = 0
Indique le nombre d’octets chargés jusqu’ici au cours du chargement. | URLLoader | |
| bytesTotal : uint = 0
Indique le nombre total d’octets dans les données téléchargées. | URLLoader | |
| constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| cookieHeader : String [écriture seule] | AVURLLoader | ||
| data : *
Données reçues par le biais de l’opération de chargement. | URLLoader | |
| dataFormat : String = "text"
Contrôle si les données téléchargées sont reçues sous forme de texte (URLLoaderDataFormat.TEXT), de données binaires brutes (URLLoaderDataFormat.BINARY) ou de variables de code URL (URLLoaderDataFormat.VARIABLES). | URLLoader | |
| Méthode | Défini par | ||
|---|---|---|---|
AVURLLoader(request:URLRequest = null)
Crée un objet URLLoader. | AVURLLoader | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [override] | AVURLLoader | ||
[override]
Ferme l’opération de chargement en cours. | AVURLLoader | ||
|
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 | |
[override]
Envoie et charge les données à partir de l’URL spécifiée. | AVURLLoader | ||
|
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 | |
|
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é après le décodage de toutes les données reçues et leur placement dans la propriété data de l’objet URLLoader. | AVURLLoader | |||
| [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é si un appel de la méthode load() tente d’accéder aux données via HTTP, et si Adobe AIR est capable de détecter et de renvoyer le code d’état de la requête. | AVURLLoader | |||
| Distribué si un appel de la méthode URLLoader.load() tente d’accéder aux données via HTTP. | AVURLLoader | |||
| Distribué si un appel de la méthode URLLoader.load() provoque une erreur fatale qui met fin au téléchargement. | AVURLLoader | |||
| Distribué lorsque l’opération de téléchargement commence suite à un appel de la méthode URLLoader.load(). | AVURLLoader | |||
| Distribué à la réception des données au fur et à mesure du téléchargement. | AVURLLoader | |||
| Distribué si un appel de la méthode URLLoader.load() tente de charger des données d’un serveur en dehors d’un sandbox de sécurité. | AVURLLoader | |||
cookieHeader | propriété |
AVURLLoader | () | Constructeur |
public function AVURLLoader(request:URLRequest = null)| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Crée un objet URLLoader.
Paramètresrequest:URLRequest (default = null)load pour plus d’informations).
|
Eléments de l’API associés
addEventListener | () | méthode |
override public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):voidParamètres
type:String | |
listener:Function | |
useCapture:Boolean (default = false) | |
priority:int (default = 0) | |
useWeakReference:Boolean (default = false) |
close | () | méthode |
override public function close():void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ferme l’opération de chargement en cours. Toute opération de chargement en cours prend immédiatement fin. Si aucune URL n’est en cours de transmission, une erreur de flux non valide est renvoyée.
load | () | méthode |
override public function load(request:URLRequest):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Envoie et charge les données à partir de l’URL spécifiée. Les données peuvent être reçues sous forme de texte, de données binaires brutes ou de variables d’URL codées, selon la valeur définie pour la propriété dataFormat. Vous remarquerez que la valeur par défaut de la propriété dataFormat correspond à text. Si vous souhaitez envoyer des données à l’URL spécifiée, définissez la propriété data dans l’objet URLRequest.
Remarque : si un fichier en cours de chargement contient des caractères non-ASCII (comme dans les langues autres que l’anglais), nous vous recommandons d’enregistrer le fichier avec codage UTF-8 ou UTF-16, plutôt que sous un format non-Unicode, ASCII par exemple.
Un fichier SWF du sandbox local avec système de fichiers risque de ne pas charger des données depuis une ressource située dans le sandbox réseau, ni lui en fournir.
Par défaut, le fichier SWF appelant et l’URL chargée doivent se trouver dans le même domaine. Par exemple, un fichier SWF à l’adresse www.adobe.com peut charger uniquement des données provenant de sources situées aussi à l’adresse www.adobe.com. Pour charger des données à partir d’un autre domaine, placez un fichier de régulation d’URL sur le serveur hébergeant les données.
Vous ne pouvez pas vous connecter aux ports généralement réservés. Pour obtenir une liste complète des ports bloqués, voir la rubrique « Restriction des API de réseau » dans le Guide du développeur d’ActionScript 3.0.
Dans Flash Player versions 10 et ultérieures, si vous utilisez un Content-Type en plusieurs parties (par exemple « multipart/form-data ») qui contient un chargement (indiqué par un paramètre « filename » dans un en-tête « content-disposition » au sein du corps POST), l’opération POST est soumise aux règles de sécurité appliquées aux chargements :
- L’opération POST doit être effectuée en réponse à l’action d’un utilisateur, comme un clic de souris ou la pression d’une touche.
- Si l’opération POST se fait entre plusieurs domaines (la cible POST ne se trouve pas sur le même serveur que le fichier SWF qui envoie la demande POST), le serveur cible doit fournir un fichier de régulation d’URL qui permette l’accès interdomaines.
Par ailleurs, la syntaxe de tous les Content-Type en plusieurs parties doit être correcte (selon la norme RFC2046). Si la syntaxe s’avère incorrecte, l’opération POST est soumise aux règles de sécurité appliquées aux chargements.
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).
Paramètres
request:URLRequest — Objet URLRequest indiquant l’URL à télécharger.
|
Evénements
complete: — Distribué après le chargement effectif de données.
| |
httpStatus: — Si l’accès s’effectue via HTTP et que l’environnement Flash Player actuel permet l’obtention des codes d’état, il se peut que vous receviez ces événements en plus des événements complete ou error.
| |
ioError: — L’opération de chargement n’a pu se terminer.
| |
progress: — Distribué à la réception des données au fur et à mesure du téléchargement.
| |
securityError: — Une opération de chargement a tenté d’extraire des données à partir d’un serveur situé en dehors du sandbox de sécurité de l’appelant. Vous pouvez contourner le problème en utilisant un fichier de régulation au niveau du serveur.
| |
securityError: — Une opération de chargement a tenté de charger un fichier SWZ (un composant de la plateforme Adobe), mais le certificat n’est pas valide ou le digest ne correspond pas au composant.
| |
open: — Distribué au commencement d’une opération de chargement.
| |
httpResponseStatus: — Distribué si un appel de la méthode load() tente d’accéder aux données via HTTP et si Adobe AIR est capable de détecter et de renvoyer le code d’état de la requête.
|
Valeur émise
ArgumentError — Les objets URLRequest.requestHeader ne devraient pas contenir certains en-têtes de requête HTTP interdits. Pour plus d’informations, voir la description de la classe URLRequestHeader.
| |
MemoryError — Cette erreur peut se produire pour les raisons suivantes : 1) Flash Player ou Adobe AIR ne peut pas convertir le paramètre URLRequest.data du format UTF8 au format MBCS. Cette erreur est concernée si l’objet URLRequest transmis à la méthode load() est configuré pour exécuter une opération GET et si System.useCodePage est réglé sur true. 2) Flash Player ou Adobe AIR ne peut pas allouer de mémoire aux données POST. Cette erreur est concernée si l’objet URLRequest transmis à load est configuré pour exécuter une opération POST.
| |
SecurityError — Les fichiers non approuvés au niveau local ne peuvent pas communiquer avec Internet. Pour contourner ce problème, reclassifiez le fichier en tant que fichier local avec accès au réseau ou en tant que fichier approuvé.
| |
SecurityError — Si vous tentez de vous connecter à un port généralement réservé. Pour obtenir une liste complète des ports bloqués, voir la rubrique « Restriction des API de réseau » dans le Guide du développeur d’ActionScript 3.0.
| |
TypeError — La valeur du paramètre de requête ou de la propriété URLRequest.url de l’objet URLRequest transmis est null.
|
Eléments de l’API associés
URLRequest.requestHeaders
URLRequest.data
URLRequest.digest
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 9, Flash Lite 4 |
Distribué après le décodage de toutes les données reçues et leur placement dans la propriété data de l’objet URLLoader. Il est possible d’accéder aux données reçues une fois cet événement distribué.
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é. |
Eléments de l’API associés
httpResponseStatus | Evénement |
flash.events.HTTPStatusEventpropriété HTTPStatusEvent.type =
flash.events.HTTPStatusEvent.HTTP_RESPONSE_STATUS| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, AIR 1.0, Flash Lite 4 |
Distribué si un appel de la méthode load() tente d’accéder aux données via HTTP, et si Adobe AIR est capable de détecter et de renvoyer le code d’état de la requête.
Contrairement à l’événementhttpStatus, l’événement httpResponseStatus est renvoyé avant toute donnée de réponse. De plus, l’événement httpResponseStatus inclut des valeurs pour les propriétés responseHeaders et responseURL (qui ne sont pas définies pour un événement httpStatus. Notez que httpResponseStatus (le cas échéant) est envoyé avant (et en complément de) tout événement complete ou error.
La constante HTTPStatusEvent.HTTP_RESPONSE_STATUS définit la valeur de la propriété type d’un objet événement httpResponseStatus.
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. |
responseURL | L’URL de laquelle la réponse a été renvoyée. |
responseHeaders | Les en-têtes de réponse que la réponse a renvoyés, sous la forme d’un tableau d’objets URLRequestHeader. |
status | Le code d’état HTTP renvoyé par le serveur. |
redirected | Indique si la réponse est le résultat d’une redirection. |
target | L’objet réseau recevant un code d’état HTTP. |
Eléments de l’API associés
httpStatus | Evénement |
flash.events.HTTPStatusEventpropriété HTTPStatusEvent.type =
flash.events.HTTPStatusEvent.HTTP_STATUS| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Distribué si un appel de la méthode URLLoader.load() tente d’accéder aux données via HTTP. Dans le cas de contenu s’exécutant dans Flash Player, cet événement n’est distribué que si l’environnement Flash Player actif est capable de détecter et de renvoyer le code d’état de la requête (certains environnements de navigateur ne sont pas capables de fournir cette information). Vous remarquerez que l’événement httpStatus (le cas échéant) est envoyé avant (et en complément de) tout événement complete ou error.
HTTPStatusEvent.HTTP_STATUS définit la valeur de la propriété type d’un objet événement httpStatus.
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. |
status | Le code d’état HTTP renvoyé par le serveur. |
target | L’objet réseau recevant un code d’état HTTP. |
Eléments de l’API associés
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 9, Flash Lite 4 |
Distribué si un appel de la méthode URLLoader.load() provoque une erreur fatale qui met fin au téléchargement.
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. |
Eléments de l’API associés
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 9, Flash Lite 4 |
Distribué lorsque l’opération de téléchargement commence suite à un appel de la méthode URLLoader.load().
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. |
Eléments de l’API associés
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 9, Flash Lite 4 |
Distribué à la réception des données au fur et à mesure du téléchargement.
Notez qu’avec un objet URLLoader, il est impossible d’accéder aux données avant la fin de leur téléchargement. L’événement progress indique donc uniquement la progression du téléchargement. Pour accéder aux données avant la fin du téléchargement, utilisez un objet AVURLStream.
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. |
Eléments de l’API associés
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 9, Flash Lite 4 |
Distribué si un appel de la méthode URLLoader.load() tente de charger des données d’un serveur en dehors d’un sandbox de sécurité. Egalement distribué si un appel de la méthode URLLoader.load() tente de charger un fichier SWZ, si le certificat n’est pas valide ou si la chaîne digest ne correspond pas au composant.
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. |
Eléments de l’API associés
Tue Jun 12 2018, 09:30 AM Z