AIR 支持全屏模式,在该模式下,在 AIR 中运行的内容可以填充整个屏幕。要进入全屏模式,需将 Stage 的
displayState
属性设置为
StageDisplayState.FULL_SCREEN
常量。
要启用全屏模式,请在包含 SWF 文件引用的 HTML 页的
<object>
和
<embed>
标签中添加
allowFullScreen
参数,并将参数值设置为
"true"
(默认值为
"false"
),如下例所示:
<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="allowFullScreen" 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>
HTML 页也可以使用脚本生成 SWF 嵌入标签。您必须更改该脚本,以便让它能够插入适当的
allowFullScreen
设置。Flash Professional 和 Flash Builder 生成的 HTML 页面使用
AC_FL_RunContent()
函数嵌入对 SWF 文件的引用,您需要添加
allowFullScreen
参数设置,如下所示:
AC_FL_RunContent( ... "allowFullScreen", "true", ...)
仅当在响应鼠标事件或键盘事件时才会调用启动全屏模式的 ActionScript。如果在其他情况中调用,Flash Player 会引发异常。
当内容进入全屏模式时,程序会显示一条消息,指导用户如何退出和返回标准模式。该消息将显示几秒钟,然后淡出。
对于在浏览器中运行的内容,在全屏模式下将限制使用键盘。在 Flash Player 9 中,只支持使应用程序返回正常模式(如通过按 Escape 键)的快捷键。用户不能在文本字段中输入文本,也不能在屏幕上导航。在 Flash Player 10 和更高版本中,支持某些非打印键(具体来说是方向键、空格键和 Tab 键)。但仍禁止文本输入。
在独立的播放器或放映文件中始终允许全屏模式。此外,这些环境中还完全支持使用键盘(包括文本输入)。
调用 Stage 对象的
displayState
属性会因任何调用方没有与 Stage 所有者(主 SWF 文件)位于同一安全沙箱而引发异常。 有关详细信息,请参阅 Stage 安全性。
管理员可以通过在 mms.cfg 文件中设置
FullScreenDisable = 1
对浏览器中运行的 SWF 文件禁用全屏模式。有关详细信息,请参阅
管理员控制
。
在浏览器中,必须在 HTML 页面中包含 SWF 文件,才能进入全屏模式。