ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Working with video
For AIR content running in full-screen mode on the desktop, the system screen saver and power-saving options are
disabled during play until either the video input stops or the user exits full-screen mode.
For full details on using full-screen mode, see “Working with full-screen mode” on page 167.
Enabling full-screen mode for Flash Player in a browser
Before you can implement full-screen mode for Flash Player in a browser, enable it through the Publish template for
your application. Templates that allow full screen include and tags that contain an
allowFullScreen parameter. The following example shows the allowFullScreen parameter in an tag.
...
...
In Flash, select File -> Publish Settings and in the Publish Settings dialog box, on the HTML tab, select the Flash Only
- Allow Full Screen template.
In Flex, ensure that the HTML template includes and tags that support full screen.
Initiating full-screen mode
For Flash Player content running in a browser, you initiate full-screen mode for video in response to either a mouse
click or a keypress. For example, you can initiate full-screen mode when the user clicks a button labeled Full Screen or
selects a Full Screen command from a context menu. To respond to the user, add an event listener to the object on which
the action occurs. The following code adds an event listener to a button that the user clicks to enter full-screen mode:
var fullScreenButton:Button = new Button();
fullScreenButton.label = "Full Screen";
addChild(fullScreenButton);
fullScreenButton.addEventListener(MouseEvent.CLICK, fullScreenButtonHandler);
function fullScreenButtonHandler(event:MouseEvent)
{
stage.displayState = StageDisplayState.FULL_SCREEN;
}
The code initiates full-screen mode by setting the Stage.displayState property to
StageDisplayState.FULL_SCREEN. This code scales the entire stage to full screen with the video scaling in
proportion to the space it occupies on the stage.
Last updated 6/6/2012
482