ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Security
applicationDomain: Use this property only when loading a SWF file written in ActionScript 3.0 (not an image or
a SWF file written in ActionScript 1.0 or 2.0). When loading the file, you can specify that the file be placed into a
particular application domain, rather than the default of being placed in a new application domain that is a child of
the loading SWF file’s application domain. Note that application domains are subunits of security domains, and
thus you can specify a target application domain only if the SWF file that you are loading is from your own security
domain, either because it is from your own server, or because you have successfully imported it into your security
domain using the securityDomain property. If you specify an application domain but the loaded SWF file is part
of a different security domain, the domain you specify in applicationDomain is ignored. For more information,
see “Working with application domains” on page 147.
For details, see “Specifying loading context” on page 200.
An important property of a Loader object is the contentLoaderInfo property, which is a LoaderInfo object. Unlike
most other objects, a LoaderInfo object is shared between the loading SWF file and the loaded content, and it is always
accessible to both parties. When the loaded content is a SWF file, it can access the LoaderInfo object through the
DisplayObject.loaderInfo property. LoaderInfo objects include information such as load progress, the URLs of
loader and loadee, the trust relationship between loader and loadee, and other information. For more information, see
“Monitoring loading progress” on page 199.
Loading sound and videos
Flash Player 9 and later, Adobe AIR 1.0 and later
Any content, except content in the local-with-filesystem sandbox, is allowed to load sound and video from network
origins, using the Sound.load(), NetConnection.connect(), and NetStream.play() methods.
Only content in the local-with-filesystem and AIR application sandboxes can load media from the local file system.
Only content in the local-with-filesystem sandbox, the AIR application sandbox, or the local-trusted sandbox can
access data in these loaded files.
There are other restrictions on accessing data from loaded media. For details, see “Accessing loaded media as data” on
page 1054.
Loading SWF files and images using the tag in a text field
Flash Player 9 and later, Adobe AIR 1.0 and later
You can load SWF files and bitmaps into a text field by using the tag, as in the following code:
You can access content loaded this way by using the getImageReference() method of the TextField instance, as in
the following code:
var loadedObject:DisplayObject = myTextField.getImageReference('instanceName');
Note, however, that SWF files and images loaded in this way are put in the sandbox that corresponds to their origin.
When you load an image file using an tag in a text field, access to the data in the image may be permitted by a
URL policy file. You can check for a policy file by adding a checkPolicyFile attribute to the tag, as in the
following code:
When you load a SWF using an tag in a text field, you can permit access to that SWF file’s data through a call
to the Security.allowDomain() method.
Last updated 6/6/2012
1050