LocalConnection.domain()

Availability

Flash Player 6.

Usage

my_lc.domain()

Parameters

None.

Returns

A string representing the subdomain of the location of the current movie.

Description

Method; returns a string representing the subdomain of the location of the current movie. For example, if the current movie is located at www.macromedia.com, this command returns "macromedia.com". If the current movie 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.

Example

In the following example, a receiving movie accepts commands only from movies 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 movie located at yourdomain.com invokes a method in a receiving movie located at mydomain.com. The sending movie includes its domain name as a parameter to the method it invokes, so the receiving movie can return a reply value to a LocalConnection object in the correct domain. The sending movie also specifies that it will accept commands only from movies at mydomain.com.

Line numbers are included for reference purposes. The sequence of events is as follows:

See also

LocalConnection.allowDomain