MACROMEDIA FLASH MX 2004 - ACTIONSCRIPT, Reference Manual

Page: 662 / 816

662 Chapter 12: ActionScript Dictionary
System.exactSettings
Availability
Authoring: Flash MX 2004.
Playback: SWF files published for Flash Player 6 or later, playing in Flash Player 7 or later.
Usage
System.exactSettings
Description
Property; specifies whether to use superdomain or exact-domain matching rules when accessing
local settings (such as camera or microphone access permissions) or locally persistent data (shared
objects). The default value is
true
for files published for Flash Player 7 or later, and
false
for
files published for Flash Player 6.
If this value is
true
, the settings and data for a SWF file hosted at here.xyz.com are stored at
here.xyz.com, the settings and data for a SWF file hosted at there.xyz.com are stored at
there.xyz.com, and so on. If this value is
false
, the settings and data for SWF files hosted at
here.xyz.com, there.xyz.com, and xyz.com are shared, and are all stored at xyz.com.
If some of your files set this property to
false
and others set it to
true
, you might find that Swf
files in different subdomains share settings and data. For example, if this property is
false
in a
SWF file hosted at here.xyz.com and
true
in a SWF file hosted at xyz.com, both files will use the
same settings and data—namely, those at xyz.com. If this isn’t the behavior you want, make sure
that you set this property in each file to correctly represent where you want to store settings
and data.
If you want to change this property from its default value, issue the
System.exactSettings = false
command in the first frame of your document. The property
can’t be changed after any activity that requires access to local settings, such as
System.ShowSettings()
or
SharedObject.getLocal()
.
If you use
loadMovie()
,
MovieClip.loadMovie()
, or MovieClipLoader.loadClip() to load one
SWF file into another, all of the files published for Flash Player 7 share a single value for
System.exactSettings
, and all of the files published for Flash Player 6 share a single value for
System.exactSettings
. Therefore, if you specify a value for this property in one file published
for a particular Player version, you should do so in all files that you plan to load. If you load
multiple files, the setting specified in the last file loaded overwrites any previously
specified setting.
For more information on how domain matching is implemented in Flash, see “Flash Player
security features” on page 188 .
See also
SharedObject.getLocal()
, System.showSettings()