documentation flash localconnection

Vous êtes ici: Les articles techniques » documentation » Eléments du langage ActionScript » LocalConnection

Table des matières

LocalConnection

Object
     |
     +-LocalConnection
 
public dynamic class **LocalConnection**
extends Object

La classe LocalConnection vous permet de développer des fichiers SWF qui peuvent échanger des instructions entre eux sans utiliser fscommand() ou JavaScript. Les objets LocalConnection peuvent communiquer uniquement avec les fichiers SWF s’exécutant sur le même ordinateur client, mais peuvent s’exécuter dans diverses applications, par exemple un fichier SWF s’exécutant dans un navigateur et un fichier SWF s’exécutant dans une projection. Vous pouvez utiliser les objets LocalConnection pour envoyer et recevoir des données dans un fichier SWF unique, mais il ne s’agit pas de l’implémentation standard ; tous les exemples de cette section illustrent la communication entre différents fichiers SWF.

Les principales méthodes utilisées pour envoyer et recevoir des données sont les méthodes LocalConnection.send() et LocalConnection.connect(). Sous sa forme la plus basique, votre code implémente les commandes suivantes ; notez que les commandes LocalConnection.send() et LocalConnection.connect() spécifient le même nom de connexion, lc_name : 

// Code in the receiving SWF file
this.createTextField("result_txt", 1, 10, 10, 100, 22);
result_txt.border = true;
var receiving_lc:LocalConnection = new LocalConnection();
receiving_lc.methodToExecute = function(param1:Number, param2:Number) {
result_txt.text = param1+param2;
};
receiving_lc.connect("lc_name");
 
// Code in the sending SWF file
var sending_lc:LocalConnection = new LocalConnection();
sending_lc.send("lc_name", "methodToExecute", 5, 7);

La manière la plus simple d’utiliser un objet LocalConnection est d’autoriser la communication uniquement entre les objets LocalConnection appartenant au même domaine, ce qui vous évitera tout problème de sécurité. Toutefois, si vous devez autoriser la communication entre les domaines, vous pouvez procéder de différentes façons pour implémenter vos mesures de sécurité. Pour plus d’informations, consultez la rubrique consacrée au paramètre connectionName dans LocalConnection.send() ainsi que les entrées LocalConnection.allowDomain et LocalConnection.domain().

Disponibilité : ActionScript 1.0 ; Flash Player 6

Voir également

Résumé des propriétés

Propriétés héritées de la classe Object

Résumé des événements

Evénement Description
allowDomain = function([sendingDomain:String]) {} Invoqué à chaque fois que receiving_lc reçoit une requête pour appeler une méthode à partir d’un objet LocalConnection d’envoi.
allowInsecureDomain = function([sendingDomain:String]) {} Invoqué à chaque fois que receiving_lc, qui se trouve dans un fichier SWF hébergé sur un domaine utilisant un protocole sécurisé (HTTPS), reçoit une requête pour appeler une méthode à partir d’un objet LocalConnection d’envoi qui se trouve dans un fichier SWF hébergé à l’aide d’un protocole non sécurisé.
onStatus = function(infoObject:Object) {} Invoqué une fois qu’un objet LocalConnection d’envoi a tenté d’envoyer une commande à un objet LocalConnection de réception.

Résumé des constructeurs

Signature Description
LocalConnection() Crée un objet LocalConnection.

Résumé de la méthode

Modificateurs Signature Description
close() : Void Ferme (déconnecte) un objet LocalConnection.
connect(connectionName:String) : Boolean Prépare un objet LocalConnection à recevoir des commandes à partir d’une commande LocalConnection.send() (appelée l’objet LocalConnection d’envoi).
domain() : String Renvoie une chaîne représentant le domaine de l’emplacement du fichier SWF actuel.
send(connectionName:String, methodName:String, [args:Object]) : Boolean Invoque la méthode nommée method sur une connexion établie à l’aide de la commande LocalConnection.connect( connectionName ) (l’objet LocalConnection de réception).

Méthodes héritées de la classe Object




veille
inscrits inscrits ! Compensation à la rédaction
  • Inscription au wiki
  • Connexion

vod