ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Display programming
AC_FL_RunContent(
...
'allowFullScreen','true',
...
); //end AC code
This does not apply to SWF files running in the stand-alone Flash Player.
Note: If you set the Window Mode (wmode in the HTML) to Opaque Windowless (opaque) or Transparent Windowless
(transparent), the full-screen window is always opaque
There are also security-related restrictions for using full-screen mode with Flash Player in a browser. These restrictions
are described in “Security” on page 1031.
Enabling full-screen interactive mode in Flash Player 11.3 and higher
Flash Player 11.3 and higher support full-screen interactive mode, which enables full support for all keyboard keys
(except for Esc, which exits full-screen interactive mode). Full-screen interactive mode is useful for gaming (for
example, to enable chat in a multi-player game or WASD keyboard controls in a first-person shooter game.)
To enable full-screen interactive mode for a SWF file embedded in an HTML page, the HTML code to embed Flash
Player must include a param tag and embed attribute with the name allowFullScreenInteractive and value true,
like this:
...
In the Flash authoring tool, select File -> Publish Settings and in the Publish Settings dialog box, on the HTML tab,
select the Flash Only - Allow Full Screen Interactive template.
In Flash Builder and Flex, ensure that the HTML templates include and tags that support full
screen interactive mode.
If you are using JavaScript in a web page to generate the SWF-embedding tags, you must alter the JavaScript to add the
allowFullScreenInteractive param tag and attribute. For example, if your HTML page uses the
AC_FL_RunContent() function (which is used in HTML pages generated by Flash Professional and Flash Builder),
you should add the allowFullScreenInteractive parameter to that function call as follows:
AC_FL_RunContent(
...
'allowFullScreenInteractive','true',
...
); //end AC code
This does not apply to SWF files running in the stand-alone Flash Player.
Full screen stage size and scaling
The Stage.fullScreenHeight and Stage.fullScreenWidth properties return the height and the width of the
monitor that’s used when going to full-screen size, if that state is entered immediately. These values can be incorrect
if the user has the opportunity to move the browser from one monitor to another after you retrieve these values but
before entering full-screen mode. If you retrieve these values in the same event handler where you set the
Stage.displayState property to StageDisplayState.FULL_SCREEN, the values are correct.For users with multiple
Last updated 6/6/2012
168