Localconnection Class - MACROMEDIA FLASH MX 2004 - ACTIONSCRIPT Reference Manual

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
between SWF files that are running on the same client machine, but they can be running in two
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.connect()
commands; notice that both the
commands specify the same connection name,
// Code in the receiving movie
receiving_lc = new LocalConnection();
receiving_lc.methodToExecute = function(param1, param2)
{
// Code to be executed
}
receiving_lc.connect("lc_name");
// Code in the sending movie
sending_lc = new LocalConnection();
sending_lc.send("lc_name", "methodToExecute", dataItem1, dataItem2)
The simplest way to use a LocalConnection object is to allow communication only between
LocalConnection objects located in the same domain, since you won't have to address issues
related to security. However, if you need to allow communication between domains, you have a
number of ways to implement security measures. For more information, see the discussion of the
connectionName
LocalConnection.allowDomain
Method summary for the LocalConnection class
Method
LocalConnection.close()
LocalConnection.connect()
LocalConnection.domain()
LocalConnection.send()
434 Chapter 12: ActionScript Dictionary
or JavaScript. LocalConnection objects can communicate only
fscommand()
. At its most basic, your code will implement the following
LocalConnection.send()
parameter in
LocalConnection.send()
and
LocalConnection.domain()
LocalConnection.send()
and
:
lc_name
, and also the
Description
Closes (disconnects) the LocalConnection object.
Prepares the LocalConnection object to receive
commands from a
LocalConnection.send()
Returns a string representing the superdomain of the
location of the current SWF file.
Invokes a method on a specified LocalConnection object.
and
LocalConnection.connect()
entries.
command.