capabilities (System.capabilities) class

The System.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.

Property summary

The following table lists the properties that are not supported by the System.capabilites class when using ActionScript for Flash Lite 2.x.

Property	Description
`hasIME`	Indicates whether the system has an input method editor (IME) installed.
`manufacturer`	A string that indicates the manufacturer of Flash Player, in the format "Adobe OSName" (OSName could be "Windows", "Macintosh", "Linux", or "Other OS Name").
`pixelAspectRatio`	Indicates the pixel aspect ratio of the screen.
`playerType`	Indicates the type of player: stand-alone, external, plug-in, or ActiveX.
`screenColor`	Indicates whether the screen is color, grayscale, or black and white.
`screenDPI`	Indicates the screen resolution, in pixels (such as dpi).
`serverString`	A URL-encoded string that specifies values for each `System.capabilities` property.

Flash Lite property extensions

The following table lists properties that are extensions to the System.capabilites class for use with ActionScript for Flash Lite 2.x.

Property	Description
`hasCompoundSound`	A read-only Boolean value that is `true` if the player can process compound sound data; `false` otherwise.
`hasEmail`	A read-only Boolean value that is `true` if the player can send e-mail messages using the `GetURL` ActionScript command; `false` otherwise.
`hasMMS`	A read-only Boolean value that is `true` if the player can send multimedia message service (MMS) messages using the `GetURL` ActionScript command; `false` otherwise.
`hasSMS`	A read-only value whose variable `_capSMS` indicates whether Flash Lite can send short message service (SMS) messages using the `GetURL` ActionScript command. If Flash Lite can send SMS messages, this variable is defined and has a value of 1. Otherwise, this variable is not defined.
`hasMFI`	A read-only Boolean value that is `true` if the player can play sound data in the Melody Format for i-mode (MFi) audio format; `false` otherwise.
`hasMIDI`	A read-only Boolean value that is `true` if the player can play sound data in the MIDI audio format; `false` otherwise.
`hasSMAF`	A read-only Boolean value that is `true` if the player can play sound data in the Synthetic music Mobile Application Format (SMAF); `false` otherwise.
`hasDataLoading`	A read-only Boolean value that is `true` if the player can dynamically load additional data through calls to `loadMovie()`, `loadMovieNum()`, `loadVariables()`, `loadVariablesNum()`, `XML.parseXML()`, `Sound.loadSound()`, `MovieClip.loadVariables()`, `MovieClip.loadMovie()`, `MovieClipLoader.loadClip()`, `LoadVars.load()`, and `LoadVars.sendAndLoad()`; `false` otherwise.
`has4WayKeyAS`	A read-only Boolean value that is `true` if the player can execute ActionScript attached to `keyEvent` handlers associated with the right, left, up and down keys; `false` otherwise. If the value of this variable is `true`, when one of the four-way keys is pressed, the player first looks for a handler for that key. If none is found, Flash control navigation is performed. However, if an event handler is found, no navigation action occurs for that key. In other words, the presence of a keypress handler for a down key disables the ability to navigate down.
`hasMouse`	A read-only Boolean value that is `true` if the player can send mouse-related events and `false` if the platform does not support a mouse.
`hasMappableSoftKeys`	Allows user to set soft-key values and handle events from those soft keys.
`hasStylus`	A read-only Boolean value that is `true` if the player can send stylus-related events and `false` if the platform does not support a stylus. The `onMouseMove` event is not supported by a stylus. This flag allows the content to check if this event is supported.
`hasCMIDI`	A read-only Boolean value that is `true` if the platform supports CMIDI sound, and `false` if the platform does not support CMIDI sound.
`hasXMLSocket`	(added in Flash Lite 2.1) Indicates whether the host application supports XML sockets.
`softKeyCount`	A number specifying the number of soft keys that the platform supports.
`hasSharedObjects`	A read-only Boolean value that is `true` if Flash content playing back in this application can access Flash Lite shared objects; `false` otherwise.
`hasQWERTYKeyboard`	A read-only Boolean value that is `true` if ActionScript can be attached to all keys found on a standard QWERTY keyboard and the Backspace key; `false` otherwise.
`audioMIMETypes`	A read-only property that contains an array of MIME types that the device's audio codecs support, and that can be used by the ActionScript Sound object.
`imageMIMETypes`	A read-only property that contains an array of MIME types that the device's image codecs support and that can be used by the `loadMovie` ActionScript function.
`videoMIMETypes`	A read-only property that contains an array of MIME types that the device's video codecs support and that can be used by the ActionScript Video object.
`MIMETypes`	A read-only property that contains an array of all the MIME types that the Sound and Video objects support and the `loadMovie()` ActionScript function.

View comments on LiveDocs