本文档列出了用于在 HTML 页面中发布 SWF(启用 Flash)内容以使其在 Web 浏览器中显示的 OBJECT 和 EMBED 标记属性。这些属性允许您指定特定的参数,用来控制 Flash Player 在浏览器中显示 SWF 文件的方式和位置等详细信息。

有关在网页内包含启用 Flash 的(SWF 文件)内容的信息,也可参阅技术说明 OBJECT 标记语法 | Flash (tn_4150)。

必需属性

在将 SWF 文件添加到 HTML 页面时,以下属性是 OBJECT 和 EMBED 标记内必需的。Flash Professional 中的“发布”命令可通过为您指定的必需属性创建 HTML 文件。 

注意:括号中的值和斜体值指示开发人员会选择该值。

OBJECT 和 EMBED 均必需:

  • width - 以像素或浏览器窗口百分比的形式指定 SWF 内容的宽度。
  • height - 以像素或浏览器窗口百分比的形式指定 SWF 内容的高度。

仅 OBJECT 标记必需:

  • classid - 标识浏览器的 ActiveX 控件。请参阅 OBJECT 标记语法 | Flash (tn_4150) 中的示例代码以了解正确的值。
  • codebase - 标识 Flash Player ActiveX 控件的位置,以便在尚未安装该控件时,浏览器可以自动下载它。请参阅 OBJECT 标记语法 | Flash (tn_4150) 中的示例代码以了解正确的值。
  • movie (param) - 指定要加载的 SWF 文件的源位置 (URL)。

仅 EMBED 标记必需:

  • src - 指定要加载的 SWF 文件的源位置 (URL)。
  • pluginspage - 标识 Flash Player 插件的位置,以便在尚未安装该插件时,用户可以下载它。

可选属性

在定义 OBJECT 和 EMBED 标记时,以下属性是可选的。对于 OBJECT,除非另外指定,否则所有属性均在 param 标记中定义:

  • id(OBJECT 标记的属性)和 name(EMBED 标记的属性)- SWF 文件标识符。标识用于 Web 浏览器的 SWF 文件,允许使用浏览器脚本语言(例如,JavaScript)来引用 SWF 内容。要实现跨浏览器兼容性,请确保将 idname 设置为相同的值。
  • play - 可能的值:true、false。指定基于时间轴的 SWF 文件是否在浏览器中加载后立即开始播放。如果忽略此属性,默认值为 true。
  • loop - 可能的值:true、false。指定基于时间轴的 SWF 文件在到达最后一帧时是不限次数循环播放还是停止。如果忽略此属性,默认值为 true。
  • menu - 可能的值:true、false。指定影片播放控件是否可在 Flash Player 上下文菜单中使用。
    • true 可显示一个完整菜单,其中提供了扩展的影片播放控件(例如,缩放、显示品质、播放、循环、后退、前进、返回)。
    • false 可显示一个菜单,其中隐藏了影片播放控件(例如,缩放、显示品质、播放、循环、后退、前进、返回)。此属性适用于不依赖时间轴的 SWF 内容,例如由 ActionScript 完全控制的内容。快捷菜单包含“设置”和“关于 Flash Player”菜单项。
  • quality - 可能的值:low、autolow、autohigh、medium、high、best。指定显示列表舞台渲染品质。通过 ActionScript 设置 Stage.quality 属性会覆盖该值。
    • low 可使播放速度优先于外观,而且从不使用消除锯齿功能。
    • autolow 可优先考虑速度,但是也会尽可能改善外观。播放开始时,消除锯齿功能处于关闭状态。如果 Flash Player 检测到处理器可以处理消除锯齿功能,就会打开该功能。
    • autohigh 可在开始时视播放速度和外观两者并重,但在必要时会牺牲外观来保证播放速度。播放开始时,消除锯齿功能处于打开状态。如果实际帧速率降到指定帧速率以下,则会关闭消除锯齿功能以提高播放速度。使用此设置可模拟 Flash Professional 中的“视图”>“消除锯齿”设置。
    • medium 可应用一些消除锯齿功能,但并不会平滑位图。此设置生成的图像品质要高于“Low”设置生成的图像品质,但低于“High”设置生成的图像品质。
    • high 可使外观优先于播放速度,并始终应用消除锯齿功能。如果影片不包含动画,则会对位图进行平滑处理;如果影片包含动画,则不会对位图进行平滑处理。
    • best 可提供最佳的显示品质,而不考虑播放速度。所有输出都会进行消除锯齿处理,并且所有位图都会进行平滑处理。
  • scale - 可能的值:showall、noborder、exactfit、noscale。指定 Flash Player 如何缩放 SWF 内容以适应由 OBJECT 或 EMBED 标记指定的像素区域。
    • default(显示全部)可使整个 SWF 文件在指定的区域中可见且无任何扭曲,同时保持影片的原始宽高比。影片的两侧可能会显示边框。
    • noborder 可缩放 SWF 文件以适应指定区域,同时保持文件的原始宽高比。Flash Player 可裁剪内容,但不会产生扭曲。
    • exactfit 可使整个 SWF 文件在指定区域中可见,但不尝试保持原始宽高比。可能会发生扭曲。
    • noscale 可阻止 SWF 文件缩放以适应 OBJECT 或 EMBED 标记的区域。可能会发生裁剪。
  • align(Object 的属性)- 可能的值:l、t、r。
    • 默认使影片在浏览器窗口内居中显示,如果浏览器窗口小于影片,则会裁剪边缘。
    • l(左)、r(右)和 t(顶部)可使影片沿浏览器窗口的边缘对齐,并根据需要裁剪其余三个边。
  • salign - 可能的值:l、t、r、tl、tr。
    • lrt 可使影片沿浏览器窗口的左、右或顶部边缘对齐,并根据需要裁剪其余的边。
    • tltr 可使影片与浏览器窗口的左上角和右上角对齐,并根据需要裁剪底部和其余的边。
  • wmode - 可能的值:window、direct、opaque、transparent、gpu。设置 SWF 文件的“窗口模式”属性,以便在浏览器中进行透明、分层、定位和渲染处理。如果忽略此属性,默认值为“window”。有关更多信息,请参阅下面的使用窗口模式 (wmode) 值
    • window - SWF 内容在网页上的自有矩形(“窗口”)内播放。浏览器确定 SWF 内容针对其他 HTML 元素的分层方式。通过此值,您无法显式指定 SWF 内容在页面中的其他 HTML 元素之上还是之下显示。
    • direct - 使用 direct 进行路径渲染。此属性会绕过屏幕缓冲区中的合成,并将 SWF 内容直接渲染到屏幕上。建议使用此 wmode 值来提供最佳的内容播放性能。它允许对使用 Stage Video 或 Stage 3D 的 SWF 内容进行硬件加速呈现。
    • opaque - SWF 内容与页面上的其他 HTML 元素一起分层。SWF 文件是不透明的,并且隐藏了页面上在其后分层的一切内容。与 wmode=windowwmode=direct 相比,此选项会降低播放性能。
    • transparent - SWF 内容与页面上的其他 HTML 元素一起分层。SWF 文件的背景颜色(舞台颜色)是透明的。利用阿尔法混合技术,SWF 文件下面的 HTML 元素通过 SWF 的任何透明区域均可见。与 wmode=windowwmode=direct 相比,此选项会降低播放性能。
    • gpu - 在某些连接 Internet 的电视和移动设备上使用额外的硬件加速。与其他 wmode 值相反,显示列表图形的像素保真度不能得到保证。否则,此值类似于 wmode=direct
  • bgcolor - 采用 #RRGGBB 格式的 [十六进制 RGB 值]。指定 SWF 内容的背景颜色。使用此属性可覆盖 SWF 文件中指定的背景颜色(舞台颜色)设置。(此属性不影响 HTML 页面的背景颜色。)
  • base - [基本目录][URL]。指定用于解析 SWF 文件中所有相对路径语句的基本目录或 URL。如果您的 SWF 文件保留在不同于其他文件的目录中,此属性将非常有用。
  • allowFullScreen - 可能的值:true 或 false。将此值设置为 true 可允许 SWF 文件通过 ActionScript 进入全屏模式。有关更多信息,请参阅了解 Flash Player 中的全屏模式。如果忽略此属性,默认值为 false
  • fullScreenAspectRatio - 可能的值:portrait 或 landscape。用于控制全屏 SWF 内容在支持自动屏幕旋转的移动设备(如手机和平板电脑)上显示的方式。如果指定此属性,Flash Player 将在全屏模式下查看 SWF 时使用指定的屏幕方向(纵向或横向)。这与设备的方向无关。如果未指定此属性,全屏模式下的内容方向将遵循浏览器使用的屏幕方向。
  • flashvars - 变量,定义为一个由键=值对组成的字符串,并会传递到 SWF 文件。
    • 使用 flashvars 可指定 SWF 文件中的根级别变量。字符串的格式为一组键=值组合,各组合之间使用“&”字符分隔。
    • 浏览器支持长度不超过 64 KB(65535 字节)的字符串大小。
    • 有关使用 flashvars 的更多信息,请参阅使用 FlashVars 将变量传递到 SWF (tn_16417)。
  • browserzoom - 以下 OBJECT 和 EMBED 标记在 Flash Player 中可用于更改 Flash 内容的大小以响应浏览器缩放系数的变化:
    • scale:打开浏览器缩放系数行为
    • noscale:关闭浏览器缩放系数行为

使用窗口模式 (wmode) 值

开发人员可以设置 SWF 内容的“窗口模式”(wmode) 属性以控制内容在浏览器中的分层和透明度。无论 wmode 的值是什么,Flash Player 都将使用直接路径渲染在全屏模式下显示查看的内容。使用直接路径渲染将启用硬件加速呈现功能,例如 Stage Video 和 Stage 3D。

要在浏览器中以最高性能播放启用 Flash 的内容,请使用 wmode=direct。此属性可启用硬件加速呈现功能,包括 Stage Video 和 Stage 3D。应避免使 SWF 内容与打算在 SWF 文件之上显示的 HTML 元素(例如,基于 HTML 的弹出菜单)重叠。只有一些现代浏览器支持显式分层控制(请参阅下表)。在其他浏览器中,SWF 内容始终显示于其他 HTML 元素之上。

如果您需要显式分层控制、透明度或浮动于 SWF 内容之上的 HTML 元素,请使用 wmode=opaquewmode=transparent。然后,您可以在页面上通过 HTML 控制与其他元素相关的分层。但是,与 wmode=window(默认)和 wmode=direct 相比,这些“无窗口”模式会降低播放性能。

用例 建议的 wmode
最佳性能,包括对硬件加速 Stage Video 和 Stage 3D 的支持。 wmode=direct
需要重叠的 HTML 元素显示在 SWF 内容之上、透明度或与 HTML 元素相关的显式分层控制(跨所有浏览器)。 wmode=opaque 或 wmode=transparent

窗口模式 (wmode) 值的浏览器支持

不同的浏览器依赖于不同的网页内容渲染方法,并以不同的方式处理 wmode 值。上表概述了何时使用不同的 wmode。下表详细介绍了每个浏览器中预期出现的特定行为。

Wmode 优势 IE 6、7 和 8 Win IE 9 Win Firefox Win Chrome Win Firefox 3 Mac(OSX 10.5 及更高版本) Firefox 4 Mac(OSX 10.6 及更高版本) Safari 3 (OSX 10.5) Safari 4(OSX 10.6 及更高版本) Chrome Mac (OSX 10.5) Chrome Mac(OSX 10.6 及更高版本)
window 最广泛的辅助功能支持 -/-/A -/-/A -/-/A -/-/A -/-/- L/-/- -/-/- L/-/- -/-/- L/-/-
透明 支持透明度和在 HTML 元素之上进行阿尔法混合。HTML 元素可以与 SWF 内容重叠。显式分层控制(所有浏览器) L/-/- L/-/- L/-/- L/-/- L/-/- L/-/- L/-/- L/-/- L/-/- L/-/-
不透明 HTML 元素可以与 SWF 内容重叠。显式分层控制(所有浏览器)。 L/-/- L/-/- L/-/- L/-/- L/-/- L/-/- L/-/- L/-/- L/-/- L/-/-
直接 最佳性能。硬件加速呈现,包括 Stage Video 和 Stage 3D(所有浏览器)。 -/H/A L/H/- -/H/A -/H/A -/H/- L/H/- -/H/- L/H/- -/H/- L/H/-
gpu 某些连接 Internet 的电视和移动设备上的额外硬件加速。 -/H/A L/H/- -/H/A -/H/A -/H/- L/H/- -/H/- L/H/- -/H/- L/H/-

L = 支持 HTML 分层。HTML 元素可以与 SWF 内容重叠。支持与其他 HTML 元素相关的显式分层控制。

H = 支持硬件加速呈现,包括 Stage Video 和 Stage 3D。

A = 支持辅助功能。

关键字:代码; 值; 属性; 标记; 参数; 播放; 循环; 品质; bgcolor; 缩放; salign; 基本; 菜单; 宽度; 高度; src; pluginspage; 影片; classid; 代码库; 背景颜色; 背景色; tn_12701

本产品经 Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License 许可  Twitter™ 与 Facebook 中的内容不在 Creative Commons 的条款约束之下。

法律声明   |   在线隐私策略