On devices that support GPU (hardware) acceleration, you can use a flash.media.StageVideo object to process video on the device hardware. The availability of StageVideo depends upon the versions and capabilities of different parts of your system including Flash Player, video hardware, OS, drivers, browser, network connection, and viewing context.
The StageVideo
class lets you take advantage of hardware acceleration to present video at the highest possible performance level for a device. The availability and performance of StageVideo
is affected by the following factors:
Hardware acceleration - When hardware acceleration is available, StageVideo
processes video on the device hardware. When hardware acceleration is not available, the StageVideo
responds depends on which version of Flash you are running:
Flash 15 and later - When hardware acceleration is not available, StageVideo
falls back to software, and you do not have to do anything.
When hardware acceleration is not available, performance can degrade significantly.
Flash 14 and earlier - When hardware acceleration is not available, StageVideo
becomes unavailable. In a small set of configurations where hardware acceleration is not supported by the browser or GPU, or is turned off in the Flash Player, video display with the TVSDK HLS stack will fail. In the HDS pipeline, you can switch from StageVideo
to an alternate, such as the Video object, that processes video in the CPU.
Presentation context - During full screen viewing, StageVideo
is always available and performance will be at the maximum level that is available on the device. When not viewing full-screen, the video presentation falls under the context of the browser, where the browser’s settings and capabilities are used.
wmode - In the browser context, the wmode
setting is critical to performance. Adobe recommends that you keep wmode
set to direct
to ensure the best possible performance in the browser context.
The combination of factors that include wmode
, StageVideo
, and Flash result in different capabilities and restrictions, depending upon how fast your hardware runs and which version of Flash you are using.
Flash 15 and later - StageVideo
is available with all available wmode
settings. However, if you set wmode
to a setting other than direct
, performance will be lower.
Flash 14 and earlier - If you set wmode
to a setting other than direct
, StageVideo
is not available in all browsers.