Flash Lite platform capabilities (Flash Professional only)

Each combination of target device and Flash Lite content type defines a set of available Flash Lite features, such as navigation type, supported image and sound formats, or input text support. When the Information debug option is enabled in the emulator settings pane (see Setting emulator debug options (Flash Professional only)), the emulator generates a list of platform capabilities for the currently selected device and content type, as the following image shows:



You can use the information to determine the features and capabilities available to your application when it is running on the currently selected test device. The emulator generates a warning message if your application attempts to do something--for example, load an image in an unsupported format--that the currently selected test device does not support.

The following table describes the Flash Lite platform capabilities as they are reported in the Output panel when you test your application in the emulator:

Capability name

Description and possible values

CodePage

Specifies the code page that the device uses. Values are in the ISO-639 language code format (for example, en for English and zh-TW for Traditional Chinese).

DeviceImageFormats

Lists the image formats (in image/ImageType format) that the device supports natively.

DeviceSoundsCached

Indicates if the device caches device sounds (Yes) or not (No).

DeviceSoundKeyOnly

Indicates whether the device plays device sounds only in response to the user pressing a key on the device (Yes) or independently of any user action (No). For more information, see Using device sound (Flash Professional only).

DeviceSoundsOrdered

A comma-delimited list of device sound formats that the platform supports. The order of the sound formats indicates what sound Flash Lite plays if a SWF file contains a sound bundle file with multiple sound formats. For more information about sound bundles, see Creating a sound bundle (Flash Professional only).

DeviceVideoFormats

Lists the video formats (in video/videoType format) that the device supports natively.

DeviceVideoMethods

Specifies additional Video object methods, if any, that are supported by the device. Possible values are seek, mute,

DynamicHeapSize

Specifies the amount of dynamic memory (in kilobytes) allocated to Flash Lite.

DynamicMemAvailable

Indicates if Flash Lite dynamically allocates memory on the device (Yes) or not (No).

FlashLiteSVG

Indicates if Flash Lite supports SVG rendering on the device (Yes) or not (No).

FSCommand

Indicates how frequently Flash Lite processes fscommand() or fscommand2() function calls. Valid values are as follows:

OnePerKey: Only one fscommand() call is allowed for each keypress.

OnePerKeyPerFrame: Only one fscommand() call is allowed per event handler or per frame.

All: No restriction on how frequently fscommand() can be called.

None: The fscommand() function is not supported.

getUrl

Indicates how frequently Flash Lite processes getURL() function calls. Valid values are as follows:

OnePerKey: Only one getURL() call is allowed for each keypress.

OnePerKeyPerFrame: Only one getURL() call is allowed per event handler or per frame.

All: No restriction on how frequently getURL() can be called.

None: The getURL() function is not supported.

GetURL_UTF8

Specifies what conversion, if any, the host application performs on a URL string that the SWF file passes to the getURL() function. Possible values: Default_NoConversion (no conversion), Uses_UTF8 (the host application converts the URL to UTF8 before passing it to the external application), and Uses_MBCS (the host application converts the URL to MBCS before passing it to the external application).

InputText

Indicates whether the platform supports input text (Yes) or not (No). For more information about input text, see Using input text fields).

KeyRestrictions

Specifies whether all URL requests (for example, using the getURL() or loadVariables() methods) need to be triggered by a keypress or mouse action (Yes) or not (No).

keySet

Indicates what key events Flash Lite supports on the device. For more information about handling key events, see Handling key and button events (Flash Professional only). Valid values are as follows:

All: All key events are handled:

Phone: Only events associated with the 0 to 9, #, *, Select, and four-way navigation keys are handled.

LoadMovie

Indicates how frequently Flash Lite processes loadMovie() function calls. Valid values are as follows:

OnePerKey: Only one loadMovie() call is allowed for each keypress.

OnePerKeyPerFrame: Only one loadMovie() call is allowed per event handler or per frame.

All: No restriction on how frequently loadMovie() can be called.

None: The loadMovie() function is not supported.

LoadVars

Indicates how frequently Flash Lite processes loadVariables() function calls. Valid values are as follows:

OnePerKey: Only one loadVariables() call is allowed for each keypress.

OnePerKeyPerFrame: Only one loadVariables() call is allowed for each event handler or frame.

All: No restriction on how frequently loadVariables() can be called.

None: The loadVariables() function is not supported.

Loop

Indicates whether a SWF file content loops (return to the first frame in the timeline) when it reaches the end of its timeline (Yes) or stops on the last frame (No).

mouseType

Indicates what mouse events Flash Lite supports. Valid values are as follows:

None: No mouse events are supported.

Partial: The press, release, rollOver, and rollout events are supported; releaseOutside, dragOut, and dragOver events not supported.

Mouse: The Mouse Up, Mouse Down, Mouse Move messages are processed. One example is a DoCoMo phone with the virtual cursor feature. This means the mouse move should trigger the rollOver or rollOut event.

MultipleDeviceSound

Indicates whether the device supports mixing of multiple device sounds (Yes) or not (No).

NativeSounds

A nonordered list of sound formats the Flash Lite

player can play natively (as opposed to device sounds, which are passed from the Flash Lite player to the device for playback). Possible values: NativeSound_PCM, NativeSound_ADPCM, and NativeSound_MP3.

NavigationType

Indicates the navigation mode that the platform supports: two-way, four-way, or four-way with wrap-around. For more information about navigation modes, see Default navigation modes. Valid values are as follows:

2Way: Up and down arrow keys supported only.

4Way: All four arrow keys (up, down, left, and right) are supported for navigation.

4WayWrapAround: Same as 4Way except that focus wraps around to the top of the display.

PersistentStoragePerMovieSize

Indicates the maximum amount of persistent data (in kilobytes) that a single SWF file can store on the device.

PlayerRendersText

Indicates if Flash Lite renders text natively (Yes) or if the device renders all text (No).

SharedObjects

Indicates whether the device supports shared objects (Yes) or not (No).

SMS

Indicates whether Flash Lite supports sending SMS messages (Yes) or not (No).

SoundChannels

Indicates if the device supports mono (Mono) or stereo sound (Stereo).

SoundSampleRate

Specifies the sound sampling rate (in kHz) that the device supports. Possible values: 5, 8, 11, 16, 22, and 44.

SoftKeyCount

Specifies the number of soft keys available on the device.

SoundEnabled

Specifies whether sound is enabled on the device (Yes) or not (No).

TextEncodingForm

Specifies the text encoding used by the device. Possible values are Native and UTF16.

TotalPersistantStorageSize

Specifies the maximum amount of persistent data that can be stored on the device, in kilobytes.

UsePlayerEmbeddedVectorFont

Indicates if Flash Lite supports embedded vector fonts (Yes) or not (No).

UseSingleFontFace

Indicates if Flash Lite content will display in a single font face (Yes) or not (No).