Flash Lite 2.x and 3.0 ActionScript Language Reference

capabilities (System.capabilities)

Object
    |
    +-System.capabilities

public class capabilities
extends Object

The Capabilities class determines the abilities of the system and player that host a SWF file, which lets you tailor content for different formats. For example, the screen of a mobile device is different from a computer 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 string for a mobile device:

  • that indicates a normal screen orientation
  • that is running an undetermined language
  • that is running the Symbian7.0sSeries60V2 operating system
  • that is configured so the user can't access hard disk, camera or microphone
  • that has the Flash Lite player as the official release version
  • for which the Flash Lite player does not support the development nor playback of screen broadcast applications to be run through Flash Media Server
  • that does not support printing on the device
  • that the Flash Lite player is running on a mobile device that supports embedded video.
 undefinedScreenOrientation=normal language=xu OS=Symbian7.0sSeries60V2 

 localFileReadDisable=true avHardwareDisable=true isDebugger=false 

 hasScreenBroadcast=false hasScreenPlayback=false hasPrinting=false 

 hasEmbeddedVideo=true 



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

Property summary

Modifiers

Property

Description

static

audioMIMETypes:Array [read-only]

Returns an array of MIME types for audio codecs supported by a mobile device.

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

has4WayKeyAS:Boolean [read-only]

A Boolean value that is true if the Flash Lite player executes the ActionScript code associated with key event handlers that are associated with the left, right, up, and down keys.

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 system has audio capabilities.

static

hasAudioEncoder:Boolean [read-only]

Specifies if the Flash Player can encode an audio stream.

static

hasCMIDI:Boolean [read-only]

Returns true if the mobile device can play sound data in the CMIDI audio format.

static

hasCompoundSound:Boolean [read-only]

Returns true if the Flash Lite player can process compound sound data.

static

hasDataLoading:Boolean [read-only]

Returns true if the Flash Lite player can dynamically load additional data through calls to specific functions.

static

hasEmail:Boolean [read-only]

Returns true if the Flash Lite player can send e-mail messages with the GetURL ActionScript command.

static

hasEmbeddedVideo:Boolean [read-only]

A Boolean value that indicates whether the mobile device supports embedded video.

static

hasMappableSoftKeys:Boolean

Returns true if the mobile device allows you to reset or reassign softkey labels and handle events from those softkeys.

static

hasMFI:Boolean [read-only]

Returns true if the mobile device is capable of playing sound data in the MFI audio format.

static

hasMIDI:Boolean [read-only]

Returns true if the mobile device is capable of playing sound data in the MIDI audio format.

static

hasMMS:Boolean [read-only]

Returns true if the mobile device can send MMS messages with the GetURL ActionScript command.

static

hasMouse:Boolean [read-only]

Indicates whether the mobile device sends mouse-related events to a Flash Lite player.

static

hasMP3:Boolean [read-only]

Specifies if the mobile device has a MP3 decoder.

static

hasPrinting:Boolean [read-only]

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

static

hasQWERTYKeyboard:Boolean [read-only]

Returns true if the Flash Lite player can process ActionScript code associated with all keys found on a standard QWERTY keyboard, including the BACKSPACE key.

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 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 Flash Media Server; false otherwise.

static

hasSharedObjects:Boolean [read-only]

Returns true if the Flash Lite content playing back in an application can access the Flash Lite version of shared objects.

static

hasSMAF:Boolean [read-only]

Returns true if the mobile device is capable of playing sound data in the SMAF audio format.

static

hasSMS:Number [read-only]

Indicates whether the mobile device can send SMS messages with the GetURL ActionScript command.

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 indicates whether the player can play streaming video.

static

hasStylus:Boolean [read-only]

Indicates if the mobile device supports stylus-related events.

static

hasVideoEncoder:Boolean [read-only]

Specifies if the Flash Player can encode a video stream.

static

hasXMLSocket:Number [read-only]

Indicates whether the host application supports XML sockets.

static

imageMIMETypes:Array [read-only]

Returns an array that contains all MIME types that the loadMovie function and the codecs for a mobile device support for processing images.

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

MIMETypes:Array [read-only]

Returns an array that contains all MIME types that the loadMovie function, Sound and Video objects support.

static

os:String [read-only]

A string that indicates the current operating system.

static

screenOrientation:String [read-only]

This member variable of the System.capabilities object that indicates the current screen orientation.

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

softKeyCount:Number [read-only]

Indicates the number of remappable soft keys that the mobile device supports.

static

version:String [read-only]

A string that contains the Flash Player platform and version information (for example, "WIN 7,1,0,0").

static

videoMIMETypes:Array [read-only]

Indicates all the MIME types for video that the mobile device's codecs support.

Properties inherited from class Object

constructor (Object.constructor property), __proto__ (Object.__proto__ property), prototype (Object.prototype property), __resolve (Object.__resolve property)

Method summary

Methods inherited from class Object

addProperty (Object.addProperty method), hasOwnProperty (Object.hasOwnProperty method), isPropertyEnumerable (Object.isPropertyEnumerable method), isPrototypeOf (Object.isPrototypeOf method), registerClass (Object.registerClass method), toString (Object.toString method), unwatch (Object.unwatch method), valueOf (Object.valueOf method), watch (Object.watch method)