Flash Player 11.3 and later support full-screen interactive mode,
in which content running in Flash Player can fill the entire screen
and accept text input
.
To enter full-screen interactive mode, the
displayState
property
of the Stage is set to the
StageDisplayState.FULL_SCREEN_INTERACTIVE
constant.
For more information, see
Working with full-screen mode
.
For SWF files running in a remote sandbox, there are some security
considerations.
To enable full-screen mode, in the
<object>
and
<embed>
tags
in the HTML page that contains a reference to the SWF file, add
the
allowFullScreenInteractive
parameter, with
its value set to
"true"
(the default value is
"false"
),
as shown in the following example:
<object classid="clsid:d27cdb6e-ae6d-11cf-96b8-444553540000"
codebase="http://fpdownload.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=9,0,18,0"
width="600" height="400" id="test" align="middle">
<param name="allowFullScreenInteractive" value="true" />
<param name="movie" value="test.swf" />
<param name="bgcolor" value="#333333" />
<embed src="test.swf" allowFullScreen="true" bgcolor="#333333"
width="600" height="400"
name="test" align="middle" type="application/x-shockwave-flash"
pluginspage="http://www.macromedia.com/go/getflashplayer" />
</object>
An HTML page may also use a script to generate SWF-embedding
tags. You must alter the script so that it inserts the proper
allowFullScreenInteractive
settings.
HTML pages generated by Flash Professional and Flash Builder use
the
AC_FL_RunContent()
function to embed references
to SWF files, and you need to add the
allowFullScreenInteractive
parameter
settings, as in the following:
AC_FL_RunContent( ... "allowFullScreenInteractive", "true", ...)
The ActionScript that initiates full-screen interactive mode
can be called only in response to a mouse event or keyboard event.
If it is called in other situations, Flash Player throws an exception.
An overlay message appears when the content enters full-screen
interactive mode. The message displays the domain of the full-screen
page, instructions on how to exit full-screen mode, and an
Allow
button.
The overlay persists until the user clicks
Allow
, acknowledging
they are in full-screen interactive mode.
Administrators can disable full-screen interactive mode for SWF
files running in browsers by setting
FullScreenInteractiveDisable = 1
in
the mms.cfg file. For details, see
Administrator controls
.
In a browser, a SWF file must be contained in an HTML page to
allow full-screen interactive mode.
