kuneriLite入門

記錄一下初次使用 kuneriLite的筆記。


簡介
kuneriLite是可以擴充Flash Lite對硬體控制功能(S60 only)的開發工具，讓FlashLite可做到原來做不到的事，如對Camera, GPS, File System等功能的控制。

能力
在kuneriLite裏，這些擴充能力稱為"plug-in"，目前支援的plug-ins如下：
-Accelerometer plugin
-Camera plugin
-Connect plugin
-Download plugin
-DTMF plugin
-File plugin
-GPS plugin
-Rotate plugin
-Simple protection plugin
-Timer plugin
-Upload/Download plugin
完整列表請看這裏
範例成品下載

原理
與flyer 類似，kuneriLite也是在手機中建一個local server(base on Symbian C++)，再以Flash Lite用loadVariables連結127.0.0.1來達成溝通。所以實際跟硬體溝通的其實是local server，而Flash Lite只是不斷跟它傳遞資訊而已。
細節請參考官方Wiki上的kuneriLite Overview

軟體
kuneriLite同時也是一個打包.sis的工具。在開發過程中必需把你的.swf放進kuneriLite的PC端tool中，再轉換成含有kuneriLite功能的sis，完成後手機直接安裝該sis即可，不需另外裝其他軟體。
目前有分三個版本
-Basic : 免費下載，plug-in功能完整，只可做個人測試用，不可任意發佈成品(不論是否商業性質)。
-Professional : 免費，但需跟官方申請才有。plug-in功能完整，除個人測試外，可發佈非商業作品。
-Commercial : 付費，無任何限制，甚至可客制化plug-ins
三版本詳情請看這裏

安裝
1.下載Basic版
2.安裝kuneriLite前，有3個東西要先裝好：Java runtime, Active Perl and Symbian S60 3rd edition SDK Maintenance Release
註：詳細說明及各別下載連結請參考這裏，記得注意裏面路徑設置的說明。
註：其中S60 SDK比較麻煩的，需先註冊成Forum Nokia的會員才可下載，而Forum Nokia的email審核標準比一般嚴苛得多，gmail使用不能。註冊完後，此SDK有300多MB大，需花不少時間。

使用
打開KuneriLite Wizard會看到以下畫面。

設 好Project Name, note後，記得要選取右邊的Plug-ins，有需要用的就選起來。另外右下的Use external player yes/no，意指是否要用額外的FlashPlayer播放，選no的話，則以預設/內建的Player，選yes的話則可用另外灌的版本。(但這部份 目前測是無效，在我N95上不論選yes/no，都固定以2.0開啟，而在N73測則固定以1.1開啟)

第二個畫面如下，是給你選.swf以外，會用到的檔，可包進多個檔，或整個目錄。


第三步如下，swf欄必填，就是主要work的.swf，其他欄可留空。按下方Compile project後，等待一段時間即可得.sis檔。(compile時間有點久)


如compile過程有錯誤，請檢查安裝時所需的三個軟體是否都有安裝，及路徑設置是否都正確

開發
而Flash這邊的code要如何撰寫？以accelerometer來說，accelerometer plugin主要有三個行為：Start, End 及Read。
Start及End似乎是各plugin都需要的，好讓local server不需持續開外掛，當收到start時才開啟，收到end則關閉。
<br />//Start:<br />loadVariables("http://127.0.0.1:1001/Basic/accelerometer?klCommand=startsensor", test_mc, "POST");<br /><br />//Read:<br />loadVariables("http://127.0.0.1:1001/Basic/accelerometer?klCommand=readsensor", test_mc, "POST");<br /><br />//End<br />loadVariables("http://127.0.0.1:1001/Basic/accelerometer?klCommand=stopsensor", test_mc, "POST");<br /><br />//語法結構大致如下<br />loadVariables("http://127.0.0.1:{自訂的port，default為1001}/{版本}/{plugin 類型}?klCommand={指令}", {接收變數的mc參照，注意1.1及2.x的寫法不同}, "POST");<br />

指令執行後，接收變數的mc會收到(非同步)對應的變數內容。不同的plugin會有不同的變數，以上述accelerometer來說，當我下readsensor時，在test_mc後就能得到：
klEnd
klError
klCount
klXAxis
klYAxis
klZAxis
幾個變數

每一個plugin的詳細用法請參考官方wiki及fla範例
配合說明及範例檔，應該就不難上手了。

注意
用到目前為止，我覺KuneriLite的使用方便性及支援程度都還不錯，Basic即有所有plug-ins可玩，相當不錯。唯一麻煩是以Basic版開發的sis，一次只能裝一個在手機裏，若要裝第二個.sis，必需先移除原來的才行。(包含官網的範例成品也是以Basic完成的)。這是為了防止user把basic開發的東西拿出去散佈而設的限制。

若真要做可發佈的作品，則需跟官方申請professional版才行，申請過程不知是否會很麻煩，有待測試查証。