ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Security
You can use the SoundMixer.areSoundsInaccessible() method to find out whether a call to the
SoundMixer.stopAll() method would not stop all sounds because the sandbox of one or more sound owners is
inaccessible to the caller.
Calling the SoundMixer.stopAll() method stops those sounds whose owner sandbox is the same as that of the caller
of stopAll(). It also stops those sounds whose playback was started by SWF files that have called the
Security.allowDomain() method to permit access by the domain of the SWF file calling the stopAll() method.
Any other sounds are not stopped, and the presence of such sounds can be revealed by calling the
SoundMixer.areSoundsInaccessible() method.
Calling the computeSpectrum() method requires that every sound that is playing be either from the same sandbox as
the object calling the method or from a source that has granted permission to the caller's sandbox; otherwise, a
SecurityError exception is thrown. For sounds that were loaded from embedded sounds in a library in a SWF file,
permission is granted with a call to the Security.allowDomain() method in the loaded SWF file. For sounds loaded
from sources other than SWF files (originating from loaded mp3 files or from video files), a URL policy file on the
source server grants access to data in loaded media.
For more information, see “Author (developer) controls” on page 1043 and “Website controls (policy files)” on
page 1040.
To access sound data from RTMP streams, you must allow access on the server. Use the Server-Side ActionScript
Client.audioSampleAccess property to allow access to specific directories on Flash Media Server. For more
information, see the Server-Side ActionScript Language Reference.
Accessing video data
Flash Player 9 and later, Adobe AIR 1.0 and later
You can use the BitmapData.draw() or BitmapData.drawWithQuality() method to capture the pixel data of the
current frame of a video. (The drawWithQuality method is available in Flash Player 11.3 and higher; AIR 3.3 and
higher.)
There are two different kinds of video:
Video streamed over RTMP from Flash Media Server
Progressive video, which is loaded from an FLV or F4V file
To use the draw methods to extract run-time graphics from RTMP streams, you must allow access on the server. Use
the Server-Side ActionScript Client.videoSampleAccess property to allow access to specific directories on Flash
Media Server. For more information, see the Server-Side ActionScript Language Reference.
When you call a draw method with progressive video as the source parameter, the caller of the method must either
be from the same sandbox as the FLV file, or the server of the FLV file must have a policy file that grants permission
to the domain of the calling SWF file. You can request that the policy file be downloaded by setting the
checkPolicyFile property of the NetStream object to true.
Last updated 6/6/2012
1056