| |
| |
| |
| |
Flash Player 6; behavior changed in Flash Player 7.
my_lc.domain()
None.
A string representing the domain of the location of the current SWF file; for details, see "Description," below.
Method; returns a string representing the domain of the location of the current SWF file.
In SWF files published for Flash Player 6, the returned string is the superdomain of the current SWF file. For example, if the SWF file is located at www.macromedia.com, this command returns "macromedia.com".
In SWF files published for Flash Player 7 or later, the returned string is the exact domain of the current SWF file. For example, if the SWF file is located at www.macromedia.com, this command returns "www.macromedia.com".
If the current SWF file is a local file residing on the client machine, this command returns "localhost".
The most common way to use this command is to include the domain name of the sending LocalConnection object as a parameter to the method you plan to invoke in the receiving LocalConnection object, or in conjunction with LocalConnection.allowDomain to accept commands from a specified domain. If you are enabling communication only between LocalConnection objects that are located in the same domain, you probably don't need to use this command.
In the following example, a receiving SWF file accepts commands only from SWF files located in the same domain or at macromedia.com.
my_lc = new LocalConnection();
my_lc.allowDomain = function(sendingDomain)
{
return (sendingDomain==this.domain() || sendingDomain=="macromedia.com");
}
In the following example, a sending SWF file located at yourdomain.com invokes a method in a receiving SWF file located at mydomain.com. The sending SWF file includes its domain name as a parameter to the method it invokes, so the receiving SWF file can return a reply value to a LocalConnection object in the correct domain. The sending SWF file also specifies that it will accept commands only from SWF files at mydomain.com.
Line numbers are included for reference purposes. The sequence of events is as follows:
"sum" (line 11). The Flash Player resolves the name of this connection to "mydomain.com:sum" (see LocalConnection.connect())."result" (line 58). It also specifies that it will accept commands only from SWF files at mydomain.com (lines 51 to 53). aSum method of a connection named "mydomain.com:sum" (line 59), and passes the following parameters: its domain (lc.domain()), the name of the connection to receive the reply ("result"), and the values to be used by aSum (123 and 456).aSum method (line 6) is invoked with the following values: sender = "mydomain.com:result", replyMethod = "aResult", n1 = 123, and n2 = 456. It therefore executes the following line of code:
this.send("mydomain.com:result", "aResult", (123 + 456));
aResult method (line 54) displays the value returned by aSum (579).
// The receiving SWF at http://www.mydomain.com/folder/movie.swf
// contains the following code
1 var aLocalConnection = new LocalConnection();
2 aLocalConnection.allowDomain = function()
3 {
// Allow connections from any domain
4 return true;
5 }
6 aLocalConnection.aSum = function(sender, replyMethod, n1, n2)
7 {
8 this.send(sender, replyMethod, (n1 + n2));
9 }
10
11 aLocalConnection.connect("sum");
// The sending SWF at http://www.yourdomain.com/folder/movie.swf
// contains the following code
50 var lc = new LocalConnection();
51 lc.allowDomain = function(aDomain) {
// Allow connections only from mydomain.com
52 return (aDomain == "mydomain.com");
53 }
54 lc.aResult = function(aParam) {
55 trace("The sum is " + aParam);
56 }
57
58 lc.connect("result");
59 lc.send("mydomain.com:sum", "aSum", lc.domain() + ':' + "result", "aResult", 123, 456);
| |
| |
| |
| |