Macromedia flash mx professional 2004-macromedia flash lite 1.1 authoring guidelines User Manual

Page of 86
32
Chapter 5:  New FSCommand and FSCommand2 commands
Supported applications
This feature is not supported in all mobile phones. 
SetQuality()
The 
SetQuality()
 function sets the quality of the rendering of the animation. The value of the 
quality
 argument must be 
high
medium
, or 
low
.
The 
SetQuality()
 function is executed immediately upon invocation. If this function is not 
supported, a value of -1 is returned.
Syntax
status = FSCommand2( "SetQuality", quality )
Here, 
quality
 is either a defined variable or a constant string value (for example, 
"medium"
).
Return value
A value of -1 if the function is not supported; 0 if it’s supported.
Key configuration
The commands in this section describe how to control the soft keys for Flash content on 
mobile phones. 
SetSoftKeys()
The 
SetSoftKeys()
 function is used to remap the left and right soft keys of mobile phones, 
provided that they can be accessed and remapped. The 
left
 and 
right
 parameters to this 
command specify the text to be displayed for the left and right soft keys, respectively. After this 
function is executed, pressing the left key generates a 
PageUp
 keypress event, and pressing the 
right key generates a 
PageDown
 keypress event. ActionScript associated with the 
PageUp
 and 
PageDown
 keypress events is executed when the respective key is pressed.
This function is executed immediately upon invocation. If this function is not supported, a value 
of -1 is returned.
This function is supported only when Flash Lite is running in stand-alone mode. It is not 
supported when the player is running in the context of another application (for example, as a 
plug-in to a browser).
Syntax
status = FSCommand2( "SetSoftkeys", left, right )
In this example, 
left
 and 
right
 are either defined variables or constant string values (for 
example, 
"label"
)
Return value
A value of -1 if the function is not supported; 0 if it’s supported.
Supported applications
This feature is not supported in all mobile phones.