Macromedia Flash - ActionScript Dictionary : System.capabilities (object)

Home > Products > Flash > Support > ActionScript Dictionary

System.capabilities (object)

You can use the System.capabilites object to determine the abilities of the system and player hosting a Flash movie. This allows you to taylor content for different formats. For example, the screen of a cell phone (black and white, 100 square pixels) is different than the 1000-square-pixel color PC screen. To provide appropriate content to as many users as possible, you can use the Capabilities object to determine the type of device a user has. You can then either specify to the server to send different SWFs based on the device capabilites, or tell the Flash movie to alter its presentation based on the capabilities of the device.

You can send capabilities information using a GET or POST HTTP method. The following is an example of a server string for a device that does not have MP3 support and has a 400 x 200 pixel, 8 x 4 centimeter screen:

 "A=t&MP3=f&AE=gsm&VE=h11&ACC=f&V=WIN%206%2C0%2C0%2C129&M=Macromedia%WINDOWS&R=400x200&DP=72&COL=color&AR=1.0&OS=WINDOWS%2000&L=en-US"

The Capabilities object is available in the Flash Player 6.

You must access all properties of the Capabilities object through the System.capabilities object.

Property summary for the Capabilities object

Property	Description
System.capabilities.hasAudioEncoder	Indicates the supported audio encoders.
System.capabilities.hasAccessibility	Indicates whether the device meets accessibility standards.
System.capabilities.hasAudio	Indicates whether the device has audio capabilities.
System.capabilities.hasMP3	Indicates whether the device has an MP3 decoder.
System.capabilities.language	Indicates the language the Flash Player supports.
System.capabilities.manufacturer	Indicates the manufacturer of the Flash Player.
System.capabilities.os	Indicates the operating system hosting the Flash Player.
System.capabilities.pixelAspectRatio	Indicates the pixel aspect ration of the screen.
System.capabilities.screenColor	Indicates whether the screen is color, black and white, or grayscale.
System.capabilities.screenDPI	Indicates the screen dots per inch.
System.capabilities.screenResolutionX	Indicates the horizontal size of the screen.
System.capabilities.screenResolutionY	Indicates the vertical size of the screen.
System.capabilities.serverString	Indicates the capability of the Flash Player 6 to communicate with the server in the current execution context.
System.capabilities.version	Indicates the lowest supported Flash Player version.
System.capabilities.hasVideoEncoder	Indicates the supported video encoders.