|
| Flash Lite 1.1 FSCommand2 用法列表(上) |
尽管 Flash Lite 2.0 已经就快出来了，但是，掌握一些 Flash Lite 1.1 的基础知识还是很必要的，对手机 Flash 应用的开发者来说，等到 Flash Lite 2.0 再动手并不是一个最好的选择，能掌握先机是很重要的。
这些资料其实是从 Flash Lite 1.1 的文档翻译来的，是为了今后查找的时候更方便一些而已。这些功能并不是所有手机都会支持，需要上机测试才能了解是否支持。
Flash Lite 1.1 目前支持功能相对较强的 FSCommand2，这在普通的 FLash 播放器中是不支持的。相对 FSCommand，有如下的不同：
FSCommand2 可以使用任意多的参数；
FSCommand2 在动画中被立即执行，而 FSCommand 则是在一帧结束后才执行；
FSCommand2 可以有返回值，以便判断是否成功。
FSCommand2 主要分成三类：普通指令、控制影片播放的指令、平台相关指令。下面是详细内容：
普通指令
普通指令::URL 编码相关
Escape
status = FSCommand2( “Escape”, original, encoded )
URL 编码指令，将 original 编码成 encoded。
返回 0 失败，返回 1 成功。
Example:
original_string = “hello, how are you?”;
status = fscommand2(”Escape”, original_string, “encoded_string”);
Unescape
status = FSCommand2( “Unescape”, encoded, original )
URL 解码指令，将 encoded 解码成 original。
返回 0 失败，返回 1 成功。
Example:
string2 = “Hello%7B%5BWorld%5D%7D”;
status = fscommand2(”Unescape”, string2, “normal_string”);
普通指令::输入框相关
SetInputTextType()
status = FSCommand2( “SetInputTextType”, variableName, type )
设定文本框可输入文本的类型，variableName 是对应的文本框内的值，type 则由以下内容控制：
Numeric: [0-9]；
Alpha: [A-Z, a-z]；
Alphanumeric: [0-9, A-Z, a-z]；
Latin: 拉丁符号；
NonLatin: 非拉丁符号；
NoRestriction: 默认模式。
返回 0 失败，返回 1 成功。
Example:
status = fscommand2(”SetInputTextType”, “input1″, “Numeric”);
控制影片播放的指令
控制影片播放的指令::显示
FullScreen()
status = FSCommand2( “FullScreen”, size )
设置全屏播放模式，size 应该为 true 或者 false。
返回 -1 为不支持，0 则为支持。
某些手机不支持全屏播放模式。
SetQuality()
status = FSCommand2( “SetQuality”, quality )
设置动画播放的质量，quality 的值为 high，medium 或 low。
返回 -1 为不支持，0 则为支持。
控制影片播放的指令::键盘设置
SetSoftKeys()
status = FSCommand2( “SetSoftkeys”, left, right )
设置手机上左右两个软键的功能显示内容，left 和 right 可以是变量或者字符串。按下左键的时候激活的是 PageUp 事件，而右键则是 PageDown 事件。
返回 -1 为不支持，0 则为支持。
ResetSoftKeys()
status = FSCommand2( “ResetSoftKeys” )
重置左右软键。
返回 -1 为不支持，0 则为支持。
播放器操作指令
GetFreePlayerMemory()
status = FSCommand2( “GetFreePlayerMemory” )
获得剩余内存数，以 K 为单位。
返回 -1 为不支持，其它值则为剩余的内存，以 K 为单位。
GetTotalPlayerMemory()
status = FSCommand2( “GetTotalPlayerMemory” )
获得 Flash Lite 可使用的内存总数，以 K 为单位。
返回 -1 为不支持，其它值则为内存数，以 K 为单位。
Launch()
status = FSCommand( “Launch”, “application-path,arg1,arg2,…,argn” )
执行手机上的其它应用程序（操作系统无关）。
Quit()
status = FSCommand2( “Quit” )
退出当前的 Flash Lite 程序。
返回 -1 为不支持。 |
|
|
