Skip to main content

Full-screen interactive mode security

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.