capabilities (System.capabilities)

Object | +-System.capabilities public class capabilities extends Object

The Capabilities class determines the abilities of the system and player hosting a SWF file, which lets you tailor 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 System.capabilities object to determine the type of device a user has. You can then either specify to the server to send different SWF files based on the device capabilities or tell the SWF file 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 example shows a server string for a computer that has MP3 support, 1600 x 1200 pixel resolution, is running Windows XP, and Flash Player 8 (8.0.0.0):

 A=t&SA=t&SV=t&EV=t&MP3=t&AE=t&VE=t&ACC=f&PR=t&SP=t&

 SB=f&DEB=t&V=WIN%208%2C0%2C0%2C0&M=Macromedia%20Windows&

 R=1600x1200&DP=72&COL=color&AR=1.0&OS=Windows%20XP&

 L=en&PT=External&AVD=f&LFD=f&WD=f"

All properties of the System.capabilities object are read-only.

Availability: ActionScript 1.0; Flash Player 6

Property summary

Modifiers	Property	Description
`static`	avHardwareDisable`:`Boolean [read-only]	A Boolean value that specifies whether access to the user's camera and microphone has been administratively prohibited (`true`) or allowed (`false`).
`static`	hasAccessibility`:`Boolean [read-only]	A Boolean value that is `true` if the player is running in an environment that supports communication between Flash Player and accessibility aids; `false` otherwise.
`static`	hasAudio`:`Boolean [read-only]	Specifies if the player is running on a system that has audio capabilities.
`static`	hasAudioEncoder`:`Boolean [read-only]	Specifies if the Flash Player can encode an audio stream.
`static`	hasEmbeddedVideo`:`Boolean [read-only]	A Boolean value that is `true` if the player is running on a system that supports embedded video; `false` otherwise.
`static`	hasIME`:`Boolean [read-only]	Indicates whether the system has an input method editor (IME) installed.
`static`	hasMP3`:`Boolean [read-only]	Specifies if the system has a MP3 decoder.
`static`	hasPrinting`:`Boolean [read-only]	A Boolean value that is `true` if the player is running on a system that supports printing; `false` otherwise.
`static`	hasScreenBroadcast`:`Boolean [read-only]	A Boolean value that is `true` if the player supports the development of screen broadcast applications to be run through the Flash Media Server; `false` otherwise.
`static`	hasScreenPlayback`:`Boolean [read-only]	A Boolean value that is `true` if the player supports the playback of screen broadcast applications that are being run through the Flash Media Server; `false` otherwise.
`static`	hasStreamingAudio`:`Boolean [read-only]	A Boolean value that is `true` if the player can play streaming audio; `false` otherwise.
`static`	hasStreamingVideo`:`Boolean [read-only]	A Boolean value that is `true` if the player can play streaming video; `false` otherwise.
`static`	hasVideoEncoder`:`Boolean [read-only]	Specifies if the Flash Player can encode a video stream.
`static`	isDebugger`:`Boolean [read-only]	A Boolean value that indicates whether the player is an officially released version (`false`) or a special debugging version (`true`).
`static`	language`:`String [read-only]	Indicates the language of the system on which the player is running.
`static`	localFileReadDisable`:`Boolean [read-only]	A Boolean value that indicates whether read access to the user's hard disk has been administratively prohibited (`true`) or allowed (`false`).
`static`	manufacturer`:`String [read-only]	A string that indicates the manufacturer of Flash Player, in the format "`Adobe` OSName" (OSName could be "`Windows`", "`Macintosh`", `"Linux"`, or "`Other OS Name`").
`static`	os`:`String [read-only]	A string that indicates the current operating system.
`static`	pixelAspectRatio`:`Number [read-only]	An integer that indicates the pixel aspect ratio of the screen.
`static`	playerType`:`String [read-only]	A string that indicates the type of player.
`static`	screenColor`:`String [read-only]	A string that indicates the screen color.
`static`	screenDPI`:`Number [read-only]	A number that indicates the dots-per-inch (dpi) resolution of the screen, in pixels.
`static`	screenResolutionX`:`Number [read-only]	An integer that indicates the maximum horizontal resolution of the screen.
`static`	screenResolutionY`:`Number [read-only]	An integer that indicates the maximum vertical resolution of the screen.
`static`	serverString`:`String [read-only]	A URL-encoded string that specifies values for each `System.capabilities` property.
`static`	version`:`String [read-only]	A string that contains the Flash Player platform and version information.

Modifiers

Property

Description

static

avHardwareDisable:Boolean [read-only]

A Boolean value that specifies whether access to the user's camera and microphone has been administratively prohibited (true) or allowed (false).

static

hasAccessibility:Boolean [read-only]

A Boolean value that is true if the player is running in an environment that supports communication between Flash Player and accessibility aids; false otherwise.

static

hasAudio:Boolean [read-only]

Specifies if the player is running on a system that has audio capabilities.

static

hasAudioEncoder:Boolean [read-only]

Specifies if the Flash Player can encode an audio stream.

static

hasEmbeddedVideo:Boolean [read-only]

A Boolean value that is true if the player is running on a system that supports embedded video; false otherwise.

static

hasIME:Boolean [read-only]

Indicates whether the system has an input method editor (IME) installed.

static

hasMP3:Boolean [read-only]

Specifies if the system has a MP3 decoder.

static

hasPrinting:Boolean [read-only]

A Boolean value that is true if the player is running on a system that supports printing; false otherwise.

static

hasScreenBroadcast:Boolean [read-only]

A Boolean value that is true if the player supports the development of screen broadcast applications to be run through the Flash Media Server; false otherwise.

static

hasScreenPlayback:Boolean [read-only]

A Boolean value that is true if the player supports the playback of screen broadcast applications that are being run through the Flash Media Server; false otherwise.

static

hasStreamingAudio:Boolean [read-only]

A Boolean value that is true if the player can play streaming audio; false otherwise.

static

hasStreamingVideo:Boolean [read-only]

A Boolean value that is true if the player can play streaming video; false otherwise.

static

hasVideoEncoder:Boolean [read-only]

Specifies if the Flash Player can encode a video stream.

static

isDebugger:Boolean [read-only]

A Boolean value that indicates whether the player is an officially released version (false) or a special debugging version (true).

static

language:String [read-only]

Indicates the language of the system on which the player is running.

static

localFileReadDisable:Boolean [read-only]

A Boolean value that indicates whether read access to the user's hard disk has been administratively prohibited (true) or allowed (false).

static

manufacturer:String [read-only]

A string that indicates the manufacturer of Flash Player, in the format "Adobe OSName" (OSName could be "Windows", "Macintosh", "Linux", or "Other OS Name").

static

os:String [read-only]

A string that indicates the current operating system.

static

pixelAspectRatio:Number [read-only]

An integer that indicates the pixel aspect ratio of the screen.

static

playerType:String [read-only]

A string that indicates the type of player.

static

screenColor:String [read-only]

A string that indicates the screen color.