[as3]关于使用 StageVideo 实现硬件加速

利用舞台视频模型，Flash Player 可以将视频从显示列表中分离。Flash Player 在两个按 Z 轴排列的平面之间拆分复合显示。

舞台视频平面

舞台视频平面位于背景中。该屏幕仅显示硬件加速视频。按照此设计方案，当设备不支持硬件加速或硬件加速不可用时，该平面不可用。在 ActionScript 中，StageVideo 对象处理舞台视频平面上播放的视频。

Flash 显示列表平面

Flash 显示列表实体组合显示在位于舞台视频平面前方的平面上。显示列表实体包含运行时呈现的所有内容（包括回放控件）。当硬件加速不可用时，只能使用 Video 类对象在此平面上播放视频。舞台视频始终显示在 Flash 显示列表图形的后面。

查看完全大小图形

视频显示平面

StageVideo 对象显示在屏幕上窗口对齐的非旋转矩形区域中。您不能在舞台视频平面后分层显示对象。不过，可以使用 Flash 显示列表平面将其他图形分层显示在舞台视频平面的上方。舞台视频与显示列表并行运行。因此，您可以组合使用这两种机制利用两个不同平面创建统一的视觉效 果。例如，可以使用前面的平面显示播放控件，用于操作在背景中运行的舞台视频。

在 Flash Player 应用程序中，实现视频加速涉及到两个步骤：

1. 将视频编码为 H.264

2. 实现 StageVideo API

为了获得最佳结果，请执行下面两个步骤：H.264 编解码器允许您在目标设备上最大限度利用硬件加速功能，包括从视频解码到呈现。

舞台视频不再执行从 GPU 到 CPU 回读。换言之，GPU 不再将已解码的帧发送回 CPU 以便与显示列表对象复合，而是将已解码和已呈现的帧直接以位块形式传输到屏幕上，并将其置于显示列表对象后面。此项技术会减少 CPU 和内存的使用，另外还提供更好的像素保真度。

当视频在全屏模式下运行时，如果设备支持硬件加速，则舞台视频始终可用。不过，Flash Player 还会在浏览器内运行。在浏览器上下文中，wmode 设置会影响舞台视频的可用性。如果您希望使用舞台视频，请始终尝试使用wmode="direct"。在非全屏模式下，舞台视频与其他 wmode 设置不兼容。此项限制意味着在运行时，舞台视频可能会在可用和不可用之间摇摆不定。例如，在运行舞台视频时，如果用户退出全屏模式，则视频上下文将恢复为浏览器。如果浏览器的 wmode 参数未设置为 "direct"，则视频会突然变得不可用。Flash Player 会通过一组事件将回放上下文更改发送给应用程序。如果您实现 StageVideo API，当舞台视频变得不可用时，请将 Video 对象保留为备份。

由于舞台视频直接与硬件建立关系，因此舞台视频会限制一些视频功能。舞台视频执行以下限制：

• 对于每个 SWF 文件，Flash Player 将可并发显示的 StageVideo 对象数量限制为 4 个。但是，实际限值可能会更低，具体取决于设备硬件资源。在用于电视的 AIR 设备和大多数移动设备上，一次只有一个 StageVideo 对象可以显示视频。

• 视频计时与运行时显示的内容的计时不同步。

• 视频显示区域只能是矩形。您无法使用更先进的显示区域，如椭圆形或不规则形状。

• 无法旋转视频。

• 无法以位图形式缓存视频，也无法使用 BitmapData 对象访问视频。

• 无法对视频应用滤镜。

• 无法对视频应用颜色转化。

• 无法对视频应用 Alpha 值。

• 您应用到显示列表平面中对象的混合模式不会应用到舞台视频。

• 只能将视频放置在全像素边界上。

• 尽管 GPU 呈现模式是给定设备硬件的最佳可用模式，但不同设备并不能实现 100%“像素相同”。像素会因驱动程序和平台的不同而略有差异。

• 少数设备不支持所有必需的色彩空间。例如，一些设备不支持 H.264 标准 BT.709。在此类情况下，可使用 BT.601 进行快速显示。

• 如果 WMODE 设置为“normal”、“opaque”或“transparent”，则无法使用舞台视频。在非全屏模式下，舞台视频仅支持 WMODE=direct。在 Safari 4 或更高版本、IE 9 或更高版本或者用于电视的 AIR 中，WMODE 没有任何效果。

大多数情况下，上述限制对视频播放器应用程序没有影响。如果您能够接受上述限制，则应尽可能使用舞台视频。

Stage.stageVideos 属性是一个 Vector 对象，通过该对象可访问 StageVideo 实例。此矢量最多可包含 4 个 StageVideo 对象，具体取决于硬件和系统资源。用于电视的 AIR 设备仅能播放单一 StageVideo 实例。移动设备可以限制为 1 个对象或无对象。

当舞台视频不可用时，该矢量不包含任何对象。为了避免运行时错误，当接收到指示舞台视频可用的最近 StageVideoAvailability 事件时，请确保仅访问该矢量的成员。

StageVideo API 框架提供了以下事件：

StageVideoAvailabilityEvent.STAGE_VIDEO_AVAILABILITY

（在用于电视的 AIR 2.5 中不支持）当 Stage.stageVideos 属性更改时发送该事件。StageVideoAvailabilityEvent.availability 属性指示 AVAILABLE 或 UNAVAILABLE。使用该事件可确定 stageVideos 属性是否包含任何 StageVideo 对象，而不必直接检查 Stage.stageVideos 矢量的长度。

StageVideoEvent.RENDER_STATE

当 NetStream 对象已附加到 StageVideo 对象并正在播放时发送该事件。指示当前使用的解码类型：硬件、软件或不可用（不显示任何内容）。事件目标包含 videoWidth 和 videoHeight 属性，调整视频视口的大小时可以安全地使用这些属性。

重要说明： 从 StageVideo 目标对象获取的坐标使用舞台坐标，这是因为他们不是标准显示列表的一部分。

VideoEvent.RENDER_STATE

（在用于电视的 AIR 2.5 中不支持）当使用 Video 对象时发送该事件。指示当前使用的是软件解码还是硬件加速解码。如果该事件指示硬件加速解码，则在可能的情况下，应切换到 StageVideo 对象。Video 事件目标包含 videoWidth 和 videoHeight 属性，调整视频视口大小时可以安全地使用这些属性。

请执行这些顶级步骤来实现 StageVideo 功能：

1. 侦听 StageVideoAvailabilityEvent.STAGE_VIDEO_AVAILABILITY 事件以了解 Stage.st geVideos 矢量何时更改。请参阅使用 StageVideoAvailabilityEvent.STAGE_VIDEO_AVAILABILITY 事件。（在用于电视的 AIR 2.5 中不支持。）

2. 如果 StageVideoAvailabilityEvent.STAGE_VIDEO_AVAILABILITY 事件报告舞台视频可用，则可以在事件处理函数中使用 Stage.stageVideos Vector 对象来访问 StageVideo 对象。在用于电视的 AIR 2.5 中，呈现第一个 SWF 帧后，访问 Stage.stageVideos。

3. 使用 StageVideo.attachNetStream() 连接 NetStream 对象。

4. 使用 NetStream.play() 播放视频。

5. 侦听 StageVideo 对象上的 StageVideoEvent.RENDER_STATE 事件，以确定播放视频的状态。收到此事件还说明，视频的宽度和高度属性已初始化或更改。请参阅使用 StageVideoEvent.RENDER_STATE 和 VideoEvent.RENDER_STATE 事件。

6. 侦听 Video 对象上的 VideoEvent.RENDER_STATE 事件。此事件提供与 StageVideoEvent.RENDER_STATE 相同的状态，因此您也可以使用它来确定 GPU 加速是否可用。收到此事件还说明，视频的宽度和高度属性已初始化或更改。（在用于电视的 AIR 2.5 中不支持。）请参阅使用 StageVideoEvent.RENDER_STATE 和 VideoEvent.RENDER_STATE 事件。