User Guide

System.exactSettings 851
System.exactSettings
Availability
Flash Player 7 or later.
Usage
System.exactSettings:Boolean
Description
Property; a Boolean value that specifies whether to use superdomain (false) or exact domain
(
true) 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 in a
directory called here.xyz.com, the settings and data for a SWF file hosted at there.xyz.com are
stored in a directory called 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 in
a directory called 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 in the xyz.com directory. If this isn’t the behavior you
want, ensure 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, do so 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 the files published for Flash Player 7 share a single value for
System.exactSettings, and all 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 the files that you plan to load. If you load
multiple files, the setting specified in the last file that’s loaded overwrites any previously
specified setting. For more information on how domain matching is implemented in Flash, see
“Flash Player security features” in Using ActionScript in Flash.