Flash Lite 1.1 FSCommand2 用法列表

來源:互聯網
上載者:User
command   儘管 Flash Lite 2.0 已經就快出來了,但是,掌握一些 Flash Lite 1.1 的基礎知識還是很必要的,對手機 Flash 應用的開發人員來說,等到 Flash Lite 2.0 再動手並不是一個最好的選擇,能掌握先機是很重要的。

  這些資料其實是從 Flash Lite 1.1 的文檔翻譯來的,是為了今後尋找的時候更方便一些而已。這些功能並不是所有手機都會支援,需要上機測試才能瞭解是否支援。

  Flash Lite 1.1 目前支援功能相對較強的 FSCommand2,這在普通的 FLash 播放器中是不支援的。相對 FSCommand,有如下的不同:

  1. FSCommand2 可以使用任意多的參數;
  2. FSCommand2 在動畫中被立即執行,而 FSCommand 則是在一幀結束後才執行;
  3. 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 為不支援。

平台相關指令

平台相關指令::日期和時間

GetDateDay()

status = FSCommand2( “GetDateDay” )
獲得當前的日期(1-31)。
返回 -1 為不支援,支援則返回 1-31 之間的數字。

GetDateMonth()

status = FSCommand2( “GetDateMonth” )
獲得當前的月份(1-12)。
返回 -1 為不支援,支援則返回 1-12 之間的數字。

GetDateWeekday()

status = FSCommand2( “GetDateWeekday” )
獲得當前的月份(0-6)。
返回 -1 為不支援,支援則返回 0-6 之間的數字。

GetDateYear()

status = FSCommand2( “GetDateYear” )
獲得當前的年份。
返回 -1 為不支援,支援則返回數字,如:2005。

GetLocaleLongDate()

status = FSCommand2( “GetLocaleLongDate”, “longdate” )
擷取當前的長日期串。日期格式根據手機本身以及 Locale 來確定。日期值指向到一個字串。
返回 -1 為不支援,0 則為支援。
以下是兩個返回的 longdate 的例子:
October 16, 2004
16 October 2004

GetLocaleShortDate()

status = FSCommand2( “GetLocaleShortDate”, “shortdate” )
擷取當前的短日期串。日期格式根據手機本身以及 Locale 來確定。日期值指向到一個字串。
返回 -1 為不支援,0 則為支援。
以下是兩個返回的 shortdate 的例子:
10/16/2004
16-10-2004

GetLocaleTime()

status = FSCommand2( “GetLocalTime”, “time” )
擷取當前的時間串。時間格式根據手機本身以及 Locale 來確定。時間值指向到一個字串。
返回 -1 為不支援,0 則為支援。
以下是兩個返回的 time 的例子:
6:10:44 PM
18:10:44

GetTimeHours()

status = FSCommand2( “GetTimeHours” )
獲得當前的小時(0-23)。
返回 -1 為不支援,支援則返回 0-23 之間的數字。

GetTimeMinutes()

status = FSCommand2( “GetTimeMinutes” )
獲得當前的分鐘(0-59)。
返回 -1 為不支援,支援則返回 0-59 之間的數字。

GetTimeSeconds()

status = FSCommand2( “GetTimeSeconds” )
獲得當前的秒(0-59)。
返回 -1 為不支援,支援則返回 0-59 之間的數字。

GetTimeZoneOffset()

status = FSCommand2( “GetTimeZoneOffset”, “timezoneoffset” )
擷取當前的時差數。時差值指向到一個數字,單位為秒。
返回 -1 為不支援,0 則為支援。
以下是兩個返回的 timezoneoffset 的例子:
540: Japan standard time
-420: Pacific daylight savings time

平台相關指令::音量

GetMaxVolumeLevel()

status = FSCommand2( “GetMaxVolumeLevel” )
擷取系統最大音量。
返回 -1 為不支援,支援則返回一個數字。

GetVolumeLevel()

status = FSCommand2( “GetVolumeLevel” )
擷取系統當前音量。
返回 -1 為不支援,支援則返回一個數字。

平台相關指令::震動

StartVibrate()

status = FSCommand2( “StartVibrate”, time_on, time_off, repeat )
設定手機震動,time_on 為開始時間,time_off 為停止時間, repeat 為重複次數。time_on 和 time_off 均為百分秒,並且不超過 5 秒。
返回 -1 為不支援,0 為目前正在震動,1 為出現錯誤。

StopVibrate()

status = FSCommand2( “StopVibrate” )
停止震動。
返回 -1 為不支援,0 為停止成功。

平台相關指令::電源

GetBatteryLevel()

status = FSCommand2( “GetBatteryLevel” )
獲得電量。
返回 -1 為不支援,支援則返回一個數字。

GetMaxBatteryLevel()

status = FSCommand2( “GetMaxBatteryLevel” )
獲得最大電量。
返回 -1 為不支援,支援則返回一個數字。

GetPowerSource()

status = FSCommand2( “GetPowerSource” )
擷取供電方式。
返回 -1 為不支援,0 為目前在使用電池供電,1 為目前在使用外部電源供電。

平台相關指令::網路資訊

GetMaxSignalLevel()

status = FSCommand2( “GetMaxSignalLevel” )
擷取最大訊號強度值。
返回 -1 為不支援,支援則返回一個數字。

GetNetworkConnectStatus()

status = FSCommand2( “GetNetworkConnectStatus” )
擷取當前網路狀態。
返回 -1 為不支援,其它則為
0:在網路連接狀態;
1:正在試圖串連網路;
2:無可用網路連接;
3:網路連接暫停狀態;
4:無法判斷狀態。

GetNetworkName()

status = FSCommand2( “GetNetworkName”, “networkname” )
擷取串連網路的名稱,傳回值指向一個字串。
返回 -1 為不支援,其它則為
0:未串連網路;
1:串連網路,但是無法擷取名稱;
2:成功。
返回的 networkname 的例子:
AT&T Wireless
KPN Mobile

GetNetworkRequestStatus()

status = FSCommand2( “GetNetworkRequestStatus” )
擷取網路請求狀態。
返回 -1 為不支援,其它則為
0:等待中,網路連接已經成功,主機名稱已經解析,伺服器也已經串連;
1:等待中,網路連接已經成功;
2:等待中,但是網路連接尚未成功;
3:等待中,串連已經成功,主機名稱已經解析;
4:失敗,網路連接錯誤;
5:失敗,串連伺服器失敗;
6:伺服器返回 404 錯誤;
7:失敗,無法串連 DNS 伺服器或者無法解析主機名稱;
8:請求成功完成;
9:請求逾時;
10:尚未執行請求。

GetNetworkStatus()

status = FSCommand2( “GetNetworkStatus” )
擷取網路狀態。
返回 -1 為不支援,其它則為
0:無網路;
1:在本網;
2:在本地擴充網路;
3:漫遊。

GetSignalLevel()

status = FSCommand2( “GetSignalLevel” )
擷取當前訊號強度值。
返回 -1 為不支援,支援則返回一個數字。

平台相關指令::使用者裝置資訊

GetLanguage()

status = FSCommand2( “GetLanguage”, “language”)
擷取使用者裝置使用的語言,傳回值指向一個字串。
返回 -1 為不支援,0 則為支援。
返回的 language 值:
cs: Czech.
da: Danish.
de: German.
en-UK: UK or international English.
en: USA English.
es: Spanish.
fi: Finnish.
fr: French.
hu: Hungarian.
it: Italian.
jp: Japanese.
ko: Korean.
nl: Dutch.
no: Norwegian.
pl: Polish.
pt: Portuguese.
ru: Russian.
Platform integration commands 45
sv: Swedish.
tr: Turkish.
xu: The language cannot be determined.
zh-CN: Simplified Chinese.
zh-TW: Traditional Chinese.

平台相關指令::使用者裝置及播放器標識

GetDeviceID()

status = FSCommand2( “GetDeviceID”, “id” )
擷取裝置的 ID,傳回值指向一個字串。
返回 -1 為不支援,0 則為支援。

GetPlatform()

status = FSCommand2( “GetPlatform”, “platform” )
擷取裝置的作業系統平台,傳回值指向一個字串。
返回 -1 為不支援,0 則為支援。
返回的 paltform 例子:
506i
FOMA1

GetDevice()

status = FSCommand2( “GetDevice”, “device” )
擷取裝置的型號,傳回值指向一個字串。
返回 -1 為不支援,0 則為支援。



相關文章

E-Commerce Solutions

Leverage the same tools powering the Alibaba Ecosystem

Learn more >

Apsara Conference 2019

The Rise of Data Intelligence, September 25th - 27th, Hangzhou, China

Learn more >

Alibaba Cloud Free Trial

Learn and experience the power of Alibaba Cloud with a free trial worth $300-1200 USD

Learn more >

聯繫我們

該頁面正文內容均來源於網絡整理,並不代表阿里雲官方的觀點,該頁面所提到的產品和服務也與阿里云無關,如果該頁面內容對您造成了困擾,歡迎寫郵件給我們,收到郵件我們將在5個工作日內處理。

如果您發現本社區中有涉嫌抄襲的內容,歡迎發送郵件至: info-contact@alibabacloud.com 進行舉報並提供相關證據,工作人員會在 5 個工作天內聯絡您,一經查實,本站將立刻刪除涉嫌侵權內容。