User Guide

400 Chapter 2: ActionScript Language Reference
LocalConnection class
Availability
Flash Player 6.
Description
The LocalConnection class lets you develop SWF files that can send instructions to each other
without the use of fscommand() or JavaScript. LocalConnection objects can communicate only
among SWF files that are running on the same client computer, but they can be running in
different applications—for example, a SWF file running in a browser and a SWF file running in a
projector. You can use LocalConnection objects to send and receive data within a single SWF file,
but this is not a standard implementation; all the examples in this section illustrate
communication between different SWF files.
The primary methods used to send and receive data are
LocalConnection.send() and
LocalConnection.connect()
. At its most basic, your code will implement the following
commands; notice that both the
LocalConnection.send() and LocalConnection.connect()
commands specify the same connection name,
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);
The simplest way to use a LocalConnection object is to allow communication only between
LocalConnection objects located in the same domain because you won’t have security issues.
However, if you need to allow communication between domains, you have several ways to
implement security measures. For more information, see the discussion of the
connectionName
parameter in
LocalConnection.send() and the LocalConnection.allowDomain and
LocalConnection.domain() entries.
Method summary for the LocalConnection class
Method Description
LocalConnection.close()
Closes (disconnects) the LocalConnection object.
LocalConnection.connect()
Prepares the LocalConnection object to receive
commands from a
LocalConnection.send() command.
LocalConnection.domain()
Returns a string representing the superdomain of the
location of the current SWF file.
LocalConnection.send()
Invokes a method on a specified LocalConnection object.
CHAPTER 2
ActionScript Language Reference