The Capabilities class provides properties that describe the system and runtime that are hosting the application. For example, a mobile phone's screen might be 100 square pixels, black and white, whereas a PC screen might be 1000 square pixels, color. By using the Capabilities class to determine what capabilities the client has, you can provide appropriate content to as many users as possible. When you know the device's capabilities, you can tell the server to send the appropriate SWF files or tell the SWF file to alter its presentation.

However, some capabilities of Adobe AIR are not listed as properties in the Capabilities class. They are properties of other classes:

There is also a `WD` server string that specifies whether windowless mode is disabled. Windowless mode can be disabled in Flash Player due to incompatibility with the web browser or to a user setting in the mms.cfg file. There is no corresponding Capabilities property.

All properties of the Capabilities class are read-only.

### Hierarchy

- Capabilities

## Index

### Properties

- avHardwareDisable
- cpuArchitecture
- hasAccessibility
- hasAudio
- hasAudioEncoder
- hasEmbeddedVideo
- hasIME
- hasMP3
- hasPrinting
- hasScreenBroadcast
- hasScreenPlayback
- hasStreamingAudio
- hasStreamingVideo
- hasTLS
- hasVideoEncoder
- isDebugger
- isEmbeddedInAcrobat
- language
- localFileReadDisable
- manufacturer
- maxLevelIDC
- os
- pixelAspectRatio
- playerType
- screenColor
- screenDPI
- screenResolutionX
- screenResolutionY
- serverString
- supports32BitProcesses
- supports64BitProcesses
- touchscreenType
- version

### Methods

- get_cpuArchitecture
- get_language
- get_manufacturer
- get_os
- get_pixelAspectRatio
- get_screenDPI
- get_screenResolutionX
- get_screenResolutionY
- get_version
- hasMultiChannelAudio

## Properties

### Static avHardwareDisable

avHardwareDisable: boolean

- Defined in lib/openfl/system/Capabilities.d.ts:41

Specifies whether access to the user's camera and microphone has been administratively prohibited(`true`) or allowed (`false`). The server string is `AVD`.

For content in Adobe AIR™, this property applies only to content in security sandboxes other than the application security sandbox. Content in the application security sandbox can always access the user's camera and microphone.

### Static cpuArchitecture

cpuArchitecture: string

- Defined in lib/openfl/system/Capabilities.d.ts:49

Specifies the current CPU architecture. The `cpuArchitecture` property can return the following strings: "`PowerPC`", "`x86`", "`SPARC`", and "`ARM`". The server string is `ARCH`.

### Static hasAccessibility

hasAccessibility: boolean

- Defined in lib/openfl/system/Capabilities.d.ts:58

Specifies whether the system supports(`true`) or does not support(`false`) communication with accessibility aids. The server string is `ACC`.

### Static hasAudio

hasAudio: boolean

- Defined in lib/openfl/system/Capabilities.d.ts:64

Specifies whether the system has audio capabilities. This property is always `true`. The server string is `A`.

### Static hasAudioEncoder

hasAudioEncoder: boolean

- Defined in lib/openfl/system/Capabilities.d.ts:71

Specifies whether the system can(`true`) or cannot (`false`) encode an audio stream, such as that coming from a microphone. The server string is `AE`.

### Static hasEmbeddedVideo

hasEmbeddedVideo: boolean

- Defined in lib/openfl/system/Capabilities.d.ts:78

Specifies whether the system supports(`true`) or does not support(`false`) embedded video. The server string is `EV`.

### Static hasIME

hasIME: boolean

- Defined in lib/openfl/system/Capabilities.d.ts:85

Specifies whether the system does(`true`) or does not (`false`) have an input method editor(IME) installed. The server string is `IME`.

### Static hasMP3

hasMP3: boolean

- Defined in lib/openfl/system/Capabilities.d.ts:92

Specifies whether the system does(`true`) or does not (`false`) have an MP3 decoder. The server string is `MP3`.

### Static hasPrinting

hasPrinting: boolean

- Defined in lib/openfl/system/Capabilities.d.ts:99

Specifies whether the system does(`true`) or does not (`false`) support printing. The server string is `PR`.

### Static hasScreenBroadcast

hasScreenBroadcast: boolean

- Defined in lib/openfl/system/Capabilities.d.ts:107

Specifies whether the system does(`true`) or does not (`false`) support the development of screen broadcast applications to be run through Flash Media Server. The server string is `SB`.

### Static hasScreenPlayback

hasScreenPlayback: boolean

- Defined in lib/openfl/system/Capabilities.d.ts:115

Specifies whether the system does(`true`) or does not (`false`) support the playback of screen broadcast applications that are being run through Flash Media Server. The server string is `SP`.

### Static hasStreamingAudio

hasStreamingAudio: boolean

- Defined in lib/openfl/system/Capabilities.d.ts:122

Specifies whether the system can(`true`) or cannot (`false`) play streaming audio. The server string is `SA`.

### Static hasStreamingVideo

hasStreamingVideo: boolean

- Defined in lib/openfl/system/Capabilities.d.ts:129

Specifies whether the system can(`true`) or cannot (`false`) play streaming video. The server string is `SV`.

### Static hasTLS

hasTLS: boolean

- Defined in lib/openfl/system/Capabilities.d.ts:136

Specifies whether the system supports native SSL sockets through NetConnection(`true`) or does not(`false`). The server string is `TLS`.

### Static hasVideoEncoder

hasVideoEncoder: boolean

- Defined in lib/openfl/system/Capabilities.d.ts:143

Specifies whether the system can(`true`) or cannot (`false`) encode a video stream, such as that coming from a web camera. The server string is `VE`.

### Static isDebugger

isDebugger: boolean

- Defined in lib/openfl/system/Capabilities.d.ts:152

Specifies whether the system is a special debugging version (`true`) or an officially released version (`false`). The server string is `DEB`. This property is set to `true` when running in the debug version of Flash Player or the AIR Debug Launcher(ADL).

### Static isEmbeddedInAcrobat

isEmbeddedInAcrobat: boolean

- Defined in lib/openfl/system/Capabilities.d.ts:158

Specifies whether the Flash runtime is embedded in a PDF file that is open in Acrobat 9.0 or higher(`true`) or not(`false`).

### Static language

language: string

- Defined in lib/openfl/system/Capabilities.d.ts:182

Specifies the language code of the system on which the content is running. The language is specified as a lowercase two-letter language code from ISO 639-1. For Chinese, an additional uppercase two-letter country code from ISO 3166 distinguishes between Simplified and Traditional Chinese. The languages codes are based on the English names of the language: for example, `hu` specifies Hungarian.

On English systems, this property returns only the language code (`en`), not the country code. On Microsoft Windows systems, this property returns the user interface(UI) language, which refers to the language used for all menus, dialog boxes, error messages, and help files. The following table lists the possible values:

Note: The value of `Capabilities.language` property is limited to the possible values on this list. Because of this limitation, Adobe AIR applications should use the first element in the `Capabilities.languages` array to determine the primary user interface language for the system.

The server string is `L`.

### Static localFileReadDisable

localFileReadDisable: boolean

- Defined in lib/openfl/system/Capabilities.d.ts:206

Specifies whether read access to the user's hard disk has been administratively prohibited(`true`) or allowed (`false`). For content in Adobe AIR, this property applies only to content in security sandboxes other than the application security sandbox.(Content in the application security sandbox can always read from the file system.) If this property is `true`, Flash Player cannot read files(including the first file that Flash Player launches with) from the user's hard disk. If this property is `true`, AIR content outside of the application security sandbox cannot read files from the user's hard disk. For example, attempts to read a file on the user's hard disk using load methods will fail if this property is set to `true`.

Reading runtime shared libraries is also blocked if this property is set to `true`, but reading local shared objects is allowed without regard to the value of this property.

The server string is `LFD`.

### Static manufacturer

manufacturer: string

- Defined in lib/openfl/system/Capabilities.d.ts:224

Specifies the manufacturer of the running version of Flash Player or the AIR runtime, in the format `"Adobe` `_OSName_"`. The value for `_OSName_` could be `"Windows"`, `"Macintosh"`, `"Linux"`, or another operating system name. The server string is `M`.

Do not use `Capabilities.manufacturer` to determine a capability based on the operating system if a more specific capability property exists. Basing a capability on the operating system is a bad idea, since it can lead to problems if an application does not consider all potential target operating systems. Instead, use the property corresponding to the capability for which you are testing. For more information, see the Capabilities class description.

### Static maxLevelIDC

maxLevelIDC: number

- Defined in lib/openfl/system/Capabilities.d.ts:238

Retrieves the highest H.264 Level IDC that the client hardware supports. Media run at this level are guaranteed to run; however, media run at the highest level might not run with the highest quality. This property is useful for servers trying to target a client's capabilities. Using this property, a server can determine the level of video to send to the client.

The server string is `ML`.

### Static os

os: string

- Defined in lib/openfl/system/Capabilities.d.ts:254

Specifies the current operating system. The `os` property can return the following strings:

The server string is `OS`.

Do not use `Capabilities.os` to determine a capability based on the operating system if a more specific capability property exists. Basing a capability on the operating system is a bad idea, since it can lead to problems if an application does not consider all potential target operating systems. Instead, use the property corresponding to the capability for which you are testing. For more information, see the Capabilities class description.

### Static pixelAspectRatio

pixelAspectRatio: number

- Defined in lib/openfl/system/Capabilities.d.ts:262

Specifies the pixel aspect ratio of the screen. The server string is `AR`.

### Static playerType

playerType: string

- Defined in lib/openfl/system/Capabilities.d.ts:284

Specifies the type of runtime environment. This property can have one of the following values:

- `"ActiveX"` for the Flash Player ActiveX control used by Microsoft Internet Explorer
- `"Desktop"` for the Adobe AIR runtime(except for SWF content loaded by an HTML page, which has `Capabilities.playerType` set to `"PlugIn"`)
- `"External"` for the external Flash Player or in test mode
- `"PlugIn"` for the Flash Player browser plug-in(and for SWF content loaded by an HTML page in an AIR application)
- `"StandAlone"` for the stand-alone Flash Player

The server string is `PT`.

### Static screenColor

screenColor: string

- Defined in lib/openfl/system/Capabilities.d.ts:292

Specifies the screen color. This property can have the value `"color"`, `"gray"`(for grayscale), or `"bw"`(for black and white). The server string is `COL`.

### Static screenDPI

screenDPI: number

- Defined in lib/openfl/system/Capabilities.d.ts:298

Specifies the dots-per-inch(dpi) resolution of the screen, in pixels. The server string is `DP`.

### Static screenResolutionX

screenResolutionX: number

- Defined in lib/openfl/system/Capabilities.d.ts:310

Specifies the maximum horizontal resolution of the screen. The server string is `R`(which returns both the width and height of the screen). This property does not update with a user's screen resolution and instead only indicates the resolution at the time Flash Player or an Adobe AIR application started. Also, the value only specifies the primary screen.

### Static screenResolutionY

screenResolutionY: number

- Defined in lib/openfl/system/Capabilities.d.ts:321

Specifies the maximum vertical resolution of the screen. The server string is `R`(which returns both the width and height of the screen). This property does not update with a user's screen resolution and instead only indicates the resolution at the time Flash Player or an Adobe AIR application started. Also, the value only specifies the primary screen.

### Static serverString

serverString: string

- Defined in lib/openfl/system/Capabilities.d.ts:335

A URL-encoded string that specifies values for each Capabilities property.

The following example shows a URL-encoded string: `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%2C5%2C0%2C208&M=Adobe%20Windows& R=1600x1200&DP=72&COL=color&AR=1.0&OS=Windows%20XP& L=en&PT=External&AVD=f&LFD=f&WD=f`

### Static supports32BitProcesses

supports32BitProcesses: boolean

- Defined in lib/openfl/system/Capabilities.d.ts:341

Specifies whether the system supports running 32-bit processes. The server string is `PR32`.

### Static supports64BitProcesses

supports64BitProcesses: boolean

- Defined in lib/openfl/system/Capabilities.d.ts:347

Specifies whether the system supports running 64-bit processes. The server string is `PR64`.

### Static touchscreenType

touchscreenType: TouchscreenType

- Defined in lib/openfl/system/Capabilities.d.ts:353

Specifies the type of touchscreen supported, if any. Values are defined in the flash.system.TouchscreenType class.

### Static version

version: string

- Defined in lib/openfl/system/Capabilities.d.ts:376

Specifies the Flash Player or Adobe® AIR® platform and version information. The format of the version number is: platform majorVersion,minorVersion,buildNumber,internalBuildNumber. Possible values for platform are `"WIN"`, ``"MAC"`,`"LNX"`, and`"AND"`. Here are some examples of version information:`WIN 9,0,0,0 // Flash Player 9 for Windows MAC 7,0,25,0 // Flash Player 7 for Macintosh LNX 9,0,115,0 // Flash Player 9 for Linux AND 10,2,150,0 // Flash Player 10 for Android`

Do not use `Capabilities.version` to determine a capability based on the operating system if a more specific capability property exists. Basing a capability on the operating system is a bad idea, since it can lead to problems if an application does not consider all potential target operating systems. Instead, use the property corresponding to the capability for which you are testing. For more information, see the Capabilities class description.

The server string is `V`.

## Methods

### Static Protected get_cpuArchitecture

- get_cpuArchitecture(): string

- - Defined in lib/openfl/system/Capabilities.d.ts:51

  #### Returns string

### Static Protected get_language

- get_language(): string

- - Defined in lib/openfl/system/Capabilities.d.ts:184

  #### Returns string

### Static Protected get_manufacturer

- get_manufacturer(): string

- - Defined in lib/openfl/system/Capabilities.d.ts:226

  #### Returns string

### Static Protected get_os

- get_os(): string

- - Defined in lib/openfl/system/Capabilities.d.ts:256

  #### Returns string

### Static Protected get_pixelAspectRatio

- get_pixelAspectRatio(): number

- - Defined in lib/openfl/system/Capabilities.d.ts:264

  #### Returns number

### Static Protected get_screenDPI

- get_screenDPI(): number

- - Defined in lib/openfl/system/Capabilities.d.ts:300

  #### Returns number

### Static Protected get_screenResolutionX

- get_screenResolutionX(): number

- - Defined in lib/openfl/system/Capabilities.d.ts:312

  #### Returns number

### Static Protected get_screenResolutionY

- get_screenResolutionY(): number

- - Defined in lib/openfl/system/Capabilities.d.ts:323

  #### Returns number

### Static Protected get_version

- get_version(): string

- - Defined in lib/openfl/system/Capabilities.d.ts:378

  #### Returns string

### Static hasMultiChannelAudio

- hasMultiChannelAudio(type: string): boolean

- - Defined in lib/openfl/system/Capabilities.d.ts:381

  #### Parameters

  - ##### type: string

  #### Returns boolean

Generated using TypeDoc