Indique l’objet sur lequel des méthodes de rappel sont appelées. L’objet par défaut correspond à this, la connexion locale en cours de création. Si vous réglez la propriété client sur un autre objet, les méthodes de rappel sont appelées sur celui-ci.

Voir aussi

Chaîne représentant le domaine de l'emplacement du fichier SWF actuel.

Dans les fichiers SWF publiés pour Flash Player 9 ou version ultérieure, la chaîne renvoyée est le domaine exact du fichier SWF actuel, y compris les sous-domaines. Par exemple, si le fichier SWF se trouve à l'adresse www.adobe.com, cette commande renvoie "www.adobe.com".

Si le fichier SWF actuel est un fichier local résidant sur l'ordinateur client, cette commande renvoie "localhost".

Les emplois les plus courants de cette propriété consistent à inclure le nom de domaine de l'objet LocalConnection d'envoi en tant que paramètre de la méthode que vous comptez appeler dans l'objet LocalConnection de réception, ou conjointement avec LocalConnection.allowDomain() pour accepter les commandes issues d'un domaine spécifique. Si vous autorisez uniquement la communication entre les objets LocalConnection appartenant au même domaine, vous n'aurez probablement pas besoin d'utiliser cette propriété.

Voir aussi

Crée un objet LocalConnection. Les objets LocalConnection vous permettent d’activer les communications entre différents fichiers SWF s’exécutant sur un même ordinateur client.

Voir aussi

Spécifie un ou plusieurs domaines qui peuvent envoyer des appels LocalConnection à cette occurrence de LocalConnection.

Vous ne pouvez pas utiliser cette méthode pour permettre aux fichiers SWF hébergés à l'aide d'un protocole sécurisé (HTTPS) d'autoriser un accès à partir de fichiers SWF hébergés avec des protocoles non sécurisés ; vous devez pour cela utiliser la méthode allowInsecureDomain().

Vous pouvez utiliser cette méthode pour faire en sorte qu'un fichier SWF enfant issu d'un domaine différent puisse effectuer des appels LocalConnection vers le fichier SWF parent, sans connaître le domaine final dont émanera le fichier SWF enfant. Cela peut se produire, par exemple, lorsque vous utilisez des redirections d'équilibrage de charge ou des serveurs tiers. Dans ce cas, vous pouvez utiliser la propriété url de l'objet LoaderInfo utilisé avec le chargement de sorte que le domaine s'utilise avec la méthode allowDomain(). Par exemple, si vous chargez un fichier SWF enfant à l'aide d'un objet Loader, à l'issue du chargement, vous pouvez vérifier la propriété contentLoaderInfo.url de l'objet Loader et analyser le domaine à travers la chaîne URL complète. Si vous procédez ainsi, veillez à attendre la fin du chargement du fichier SWF, car la valeur de la propriété contentLoaderInfo.url ne sera correcte et définitive qu'une fois le fichier entièrement chargé.

Le cas contraire peut aussi se présenter : vous pouvez créer un fichier SWF enfant qui souhaite accepter les appels LocalConnection émanant de son parent, mais qui ignore le domaine de ce dernier. Dans ce cas, mettez en œuvre cette méthode en vérifiant si l'argument de domaine correspond au domaine de la propriété loaderInfo.url dans le fichier SWF chargé. Encore une fois, vous devez analyser le domaine à partir de l'adresse URL complète de loaderInfo.url. Dans ce cas, il n'est pas nécessaire d'attendre la fin du chargement du fichier SWF parent ; le parent sera déjà chargé lorsque celui de l'enfant commencera.

Lorsque vous employez cette méthode, tenez compte du modèle de sécurité de Flash Player. Par défaut, un objet LocalConnection est associé au sandbox du fichier SWF qui l'a créé et les appels interdomaines des objets LocalConnection sont interdits, à moins que vous n’appeliez la méthode LocalConnection.allowDomain() dans le fichier SWF de réception.

Pour plus d'informations, consultez les références suivantes :

• Le chapitre relatif à la sécurité du manuel Programmation d'ActionScript 3.0 et les derniers commentaires disponibles dans LiveDocs
• Le Livre blanc sur la sécurité de Flash Player 9

Remarque : le format de la méthode allowDomain() n’est plus le même que dans ActionScript 1.0 et 2.0. Dans ces versions, allowDomain était une méthode de rappel que vous implémentiez. Dans ActionScript 3.0, allowDomain() est une méthode intégrée de LocalConnection que vous appelez. Le fonctionnement de la nouvelle version de allowDomain() est similaire à celui de flash.system.Security.allowDomain().

Paramètres

Voir aussi

Spécifie un ou plusieurs domaines qui peuvent envoyer des appels LocalConnection à cet objet LocalConnection.

Le fonctionnement des méthodes allowInsecureDomain() et allowDomain() est identique, mais la méthode allowInsecureDomain() permet en plus aux fichiers SWF de source non HTTPS d’envoyer des appels LocalConnection à des fichiers SWF de source HTTPS. Cette différence n’a d’importance que si vous appelez la méthode allowInsecureDomain() à partir d’un fichier SWF chargé via HTTPS. Vous devez appeler la méthode allowInsecureDomain() même si vous franchissez une limite non HTTPS/HTTPS au sein du même domaine. Par défaut, les appels de LocalConnection entre les fichiers SWF non HTTPS et HTTPS sont systématiquement interdits, même dans un même domaine.

L’appel de allowInsecureDomain() est déconseillé car il risque de compromettre la sécurité offerte par HTTPS. Lorsque vous chargez un fichier SWF via HTTPS, vous avez la quasi-certitude qu'il ne sera pas altéré pendant sa mise en circulation dans le réseau. Si vous autorisez ensuite un fichier SWF non HTTPS à effectuer des appels de LocalConnection vers le fichier SWF HTTPS, vous acceptez des appels en provenance d’un fichier SWF qui a pu être altéré pendant son transport. Vous devez donc redoubler de vigilance car vous ne pouvez pas vous fier à l'authenticité des appels LocalConnection que reçoit votre fichier SWF HTTPS.

Par défaut, les fichiers SWF hébergés via le protocole HTTPS sont accessibles uniquement aux autres fichiers SWF hébergés également par l'intermédiaire du protocole HTTPS. Cette implémentation préserve l'intégrité fournie par le protocole HTTPS.

Il n'est pas recommandé d'utiliser cette méthode pour annuler le comportement par défaut car elle compromet la sécurité HTTPS. Cependant, vous devrez peut-être l'utiliser, par exemple, si vous devez autoriser l'accès aux fichiers HTTPS publiés pour Flash Player 9 ou version ultérieure à partir de fichiers HTTP publiés pour Flash Player 6 ou version antérieure.

Pour plus d'informations, consultez les références suivantes :

• Le chapitre relatif à la sécurité du manuel Programmation d'ActionScript 3.0 et les derniers commentaires disponibles dans LiveDocs
• Le Livre blanc sur la sécurité de Flash Player 9

Paramètres

Voir aussi

Ferme (déconnecte) un objet LocalConnection. Appelez cette commande lorsque vous ne souhaitez plus que l'objet accepte de commandes, par exemple, lorsque vous souhaitez exécuter une commande connect() en utilisant le même paramètre connectionName dans un autre fichier SWF.

Voir aussi

Prépare un objet LocalConnection à recevoir des commandes à partir d'une commande send() (l'objet LocalConnection d'envoi). L'objet utilisé avec cette commande est appelé l'objet LocalConnection de réception. Les objets de réception et d'envoi doivent s'exécuter sur le même ordinateur client.

Pour éviter tout conflit, définissez les méthodes associées à l’objet LocalConnection de réception avant d’appeler cette méthode, comme illustré dans l’exemple de la classe LocalConnection.

Par défaut, Flash Player remplace connectionName par "superdomain:connectionName", superdomain représentant le superdomaine du fichier SWF qui contient la commande connect(). Par exemple, si le fichier SWF contenant l'objet LocalConnection de réception se trouve à l'adresse www.someDomain.com, connectionName devient "someDomain.com:connectionName". (Si un fichier SWF se trouve dans l'ordinateur client, la valeur affectée au superdomain est "localhost".)

De même, par défaut, Flash Player ne permet à l'objet LocalConnection de réception de n'accepter que les commandes provenant d'objets LocalConnection d'envoi dont le nom de connexion correspond également à une valeur "superdomain:connectionName". Ainsi, Flash facilite la communication entre les fichiers SWF situés dans un même domaine.

Si vous implémentez une communication uniquement entre des fichiers SWF appartenant au même domaine, spécifiez pour connectionName une chaîne qui ne commence pas par un caractère de soulignement (_) et qui ne spécifie pas un nom de domaine (par exemple, "myDomain:connectionName"). Utilisez cette même chaîne dans la méthode connect(connectionName).

Si vous implémentez des communications entre des fichiers SWF de domaines différents, la spécification pour connectionName d’une chaîne qui commence par un caractère de soulignement (_) accroît la portabilité interdomaines du fichier SWF associé à l'objet LocalConnection de réception. Les cas de figure possibles sont les suivants :

• Si la chaîne dédiée à connectionName ne commence pas par un caractère de soulignement (_), Flash Player ajoute un préfixe au superdomaine et deux points (par exemple, "myDomain:connectionName"). Vous avez ainsi la garantie que votre connexion n'entrera pas en conflit avec les connexions de même nom dans d'autres domaines. Cependant, tous les objets LocalConnection d'envoi doivent spécifier ce superdomaine (par exemple, "myDomain:connectionName"). Si le fichier SWF associé à l'objet LocalConnection de réception est déplacé dans un autre domaine, Flash Player modifie le préfixe afin qu'il reflète le nouveau superdomaine (par exemple, "anotherDomain:connectionName"). Tous les objets LocalConnection d'envoi doivent être modifiés manuellement pour pointer vers le nouveau superdomaine.
• Si la chaîne dédiée à connectionName commence par un caractère de soulignement (par exemple, "_connectionName"), Flash Player ne lui ajoute pas de préfixe. Les objets LocalConnection de réception et d'envoi utilisent donc des chaînes identiques pour connectionName. Si l'objet de réception utilise allowDomain() pour spécifier que les connexions seront acceptées à partir de tous les domaines, le fichier SWF contenant l'objet LocalConnection de réception peut être déplacé dans un autre domaine, sans qu’il soit nécessaire de modifier les objets LocalConnection d'envoi.

Pour plus d'informations, consultez la présentation de la classe et la section consacrée au paramètre connectionName de la méthode send(), ainsi que les entrées de allowDomain() et domain.

Remarque : les deux-points sont utilisés en tant que caractères spéciaux pour séparer le superdomaine de la chaîne connectionName. Toute chaîne associée à connectionName contenant deux-points n'est pas valide.

Lorsque vous employez cette méthode, tenez compte du modèle de sécurité de Flash Player. Par défaut, un objet LocalConnection est associé au sandbox du fichier SWF qui l'a créé et les appels interdomaines des objets LocalConnection sont interdits, à moins que vous n’appeliez la méthode LocalConnection.allowDomain() dans le fichier SWF de réception. Vous pouvez éviter qu'un fichier SWF n'utilise cette méthode en définissant le paramètre allowNetworking des balises object et embed dans la page HTML qui héberge le contenu SWF.

Pour plus d'informations, consultez les références suivantes :

• Le chapitre relatif à la sécurité du manuel Programmation d'ActionScript 3.0 et les derniers commentaires disponibles dans LiveDocs
• Le Livre blanc sur la sécurité de Flash Player 9

Paramètres

Voir aussi

Appelle la méthode nommée methodName sur une connexion établie à l'aide de la méthode connect(connectionName) (l'objet LocalConnection de réception). L'objet utilisé avec cette commande est appelé objet LocalConnection d'envoi. Les fichiers SWF qui contiennent les objets d'envoi et de réception doivent s'exécuter sur le même ordinateur client.

La quantité de données que vous pouvez transmettre en tant que paramètres à cette commande est limitée à 40 Ko. Si send() émet une ArgumentError mais que votre syntaxe est correcte, tentez de répartir les requêtes send() dans plusieurs commandes, chacune comportant moins de 40 Ko de données.

Comme nous l'avons vu à la rubrique consacrée à la méthode connect(), Flash Player ajoute le superdomaine actuel à connectionName par défaut. Si vous implémentez la communication entre différents domaines, vous devez définir connectionName dans les objets LocalConnection d'envoi et de réception de sorte que Flash n'ajoute pas le superdomaine actuel à connectionName. Pour ce faire, procédez de l'une des deux façons suivantes :

• Placez un caractère de soulignement (_) au début de connectionName dans les objets LocalConnection d'envoi et de réception. Dans le fichier SWF contenant l'objet de réception, utilisez LocalConnection.allowDomain() pour spécifier que des connexions seront acceptées de tous les domaines. Cette implémentation vous permet de stocker vos fichiers SWF d'envoi et de réception dans n'importe quel domaine.
• Intégrez le superdomaine à connectionName dans l'objet LocalConnection d'envoi, par exemple, myDomain.com:myConnectionName. Dans l'objet de réception, utilisez LocalConnection.allowDomain() pour spécifier que les connexions à partir du superdomaine spécifié seront acceptées (dans ce cas, myDomain.com) ou que les connexions de tous les domaines seront acceptées.

Remarque : vous ne pouvez pas spécifier de superdomaine dans connectionName dans l'objet LocalConnection de réception : vous ne pouvez le faire que dans celui d'envoi.

Lorsque vous employez cette méthode, tenez compte du modèle de sécurité de Flash Player. Par défaut, un objet LocalConnection est associé au sandbox du fichier SWF qui l'a créé et les appels interdomaines des objets LocalConnection sont interdits, à moins que vous n’appeliez la méthode LocalConnection.allowDomain() dans le fichier SWF de réception. Vous pouvez éviter qu'un fichier SWF n'utilise cette méthode en définissant le paramètre allowNetworking des balises object et embed dans la page HTML qui héberge le contenu SWF.

Pour plus d'informations, consultez les références suivantes :

• Le chapitre relatif à la sécurité du manuel Programmation d'ActionScript 3.0 et les derniers commentaires disponibles dans LiveDocs
• Le Livre blanc sur la sécurité de Flash Player 9

Paramètres

Voir aussi

Distribué lorsqu’une erreur est renvoyée de manière asynchrone ; autrement dit, lorsqu'elle provient du code asynchrone natif.

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

Distribué si un appel de LocalConnection.send() tente d’envoyer des données à un autre sandbox de sécurité.

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

Voir aussi

Distribué lorsqu’un objet LocalConnection publie son état. Si LocalConnection.send() aboutit, la valeur de la propriété level de l’objet événement status correspond à "status". Dans le cas contraire, la propriété level correspond à "error". Si le fichier SWF de réception refuse la connexion, l’appel peut échouer sans que le fichier SWF d’envoi n'en soit averti.

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

Voir aussi

Une occurrence de LocalConnection est créée dans le fichier SWF LocalConnectionSenderExample. Lorsque l’utilisateur appuie sur le bouton, la méthode call() est utilisée pour appeler la méthode lcHandler dans le fichier SWF contenant le nom de connexion « myConnection » et le contenu de TextField est transmis en tant que paramètre.

Une occurrence de LocalConnection est créée dans le fichier SWF LocalConnectionReceiverExample et la méthodeconnect() est appelée pour désigner ce fichier SWF comme destinataire des messages adressés à la connexion « myConnection ». En outre, cette classe comprend une méthode publique intitulée lcHandler(). Il s’agit de la méthode appelée par le fichier SWF LocalConnectionSenderExample. Lorsqu’elle est appelée, le texte reçu en tant que paramètre est ajouté à TextField sur la scène.

Remarque : pour tester l’exemple, chargez les deux fichiers SWF simultanément sur le même ordinateur.

// Code in LocalConnectionSenderExample.as
package {
    import flash.display.Sprite;
    import flash.events.MouseEvent;
    import flash.net.LocalConnection;
    import flash.text.TextField;
    import flash.text.TextFieldType;
    import flash.events.StatusEvent;
    import flash.text.TextFieldAutoSize;

    public class LocalConnectionSenderExample extends Sprite {
        private var conn:LocalConnection;
        
        // UI elements
        private var messageLabel:TextField;
        private var message:TextField;
        private var sendBtn:Sprite;
        
        public function LocalConnectionSenderExample() {
            buildUI();
            sendBtn.addEventListener(MouseEvent.CLICK, sendMessage);
            conn = new LocalConnection();
            conn.addEventListener(StatusEvent.STATUS, onStatus);
        }
        
        private function sendMessage(event:MouseEvent):void {
            conn.send("myConnection", "lcHandler", message.text);
        }
        
        private function onStatus(event:StatusEvent):void {
            switch (event.level) {
                case "status":
                    trace("LocalConnection.send() succeeded");
                    break;
                case "error":
                    trace("LocalConnection.send() failed");
                    break;
            }
        }
        
        private function buildUI():void {
            const hPadding:uint = 5;
            // messageLabel
            messageLabel = new TextField();
            messageLabel.x = 10;
            messageLabel.y = 10;
            messageLabel.text = "Text to send:";
            messageLabel.autoSize = TextFieldAutoSize.LEFT;
            addChild(messageLabel);
            
            // message
            message = new TextField();
            message.x = messageLabel.x + messageLabel.width + hPadding;
            message.y = 10;
            message.width = 120;
            message.height = 20;
            message.background = true;
            message.border = true;
            message.type = TextFieldType.INPUT;
            addChild(message);
            
            // sendBtn
            sendBtn = new Sprite();
            sendBtn.x = message.x + message.width + hPadding;
            sendBtn.y = 10;
            var sendLbl:TextField = new TextField();
            sendLbl.x = 1 + hPadding;
            sendLbl.y = 1;
            sendLbl.selectable = false;
            sendLbl.autoSize = TextFieldAutoSize.LEFT;
            sendLbl.text = "Send";
            sendBtn.addChild(sendLbl);
            sendBtn.graphics.lineStyle(1);
            sendBtn.graphics.beginFill(0xcccccc);
            sendBtn.graphics.drawRoundRect(0, 0, (sendLbl.width + 2 + hPadding + hPadding), (sendLbl.height + 2), 5, 5);
            sendBtn.graphics.endFill();
            addChild(sendBtn);
        }
    }
}