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 为不支持。