【cocos2d-js官方文檔】二十四、如何在android平臺上使用js直接調用Java方法

在cocos2d-js 3.0beta中加入了一個新特性,在Android平臺上我們可以通過反射直接在js中調用Java的靜態方法。它的使用方法很簡單:

var o = jsb.reflection.callStaticMethod(className, methodName, methodSignature, parameters...)

callStaticMethod方法中,我們通過傳入Java的類名,方法名,方法簽名,參數就可以直接調用Java的靜態方法,並且可以獲得Java方法的返回值。下面介紹的類名和方法簽名可能會有一點奇怪,但是Java的規範就是如此的。

類名

參數中的類名必須是包含Java包路徑的完整類名,例如我們在org.cocos2dx.JavaScript這個包下面寫了一個Test類:

package org.cocos2dx.javascript;

public class Test {

    public static void hello(String msg){
        System.out.println(msg);
    }

    public static int sum(int a, int b){
        return a + b;
    }

    public static int sum(int a){
        return a + 2;
    }

}

那麼這個Test類的完整類名應該是org/cocos2dx/javascript/Test,注意這裏必須是斜線/,而不是在Java代碼中我們習慣的點.

方法名

方法名很簡單,就是方法本來的名字,例如sum方法的名字就是sum

方法簽名

方法簽名稍微有一點複雜,最簡單的方法簽名是()V,它表示一個沒有參數沒有返回值的方法。其他一些例子:

  • (I)V表示參數爲一個int,沒有返回值的方法
  • (I)I表示參數爲一個int,返回值爲int的方法
  • (IF)Z表示參數爲一個int和一個float,返回值爲boolean的方法

現在有一些理解了吧,括號內的符號表示參數類型,括號後面的符號表示返回值類型。因爲Java是允許函數重載的,可以有多個方法名相同但是參數返回值不同的方法,方法簽名正是用來幫助區分這些相同名字的方法的。

目前Cocos2d-js中支持的Java類型簽名有下面4種:

Java類型 簽名
int I
float F
boolean Z
String Ljava/lang/String;

參數

參數可以是0個或任意多個,直接使用js中的number,bool和string就可以。

使用示例

我們將會調用上面的Test類中的靜態方法:

//調用hello方法
jsb.reflection.callStaticMethod("org/cocos2dx/javascript/Test", "hello", "(Ljava/lang/String;)V", "this is a message from js");

//調用第一個sum方法
var result = jsb.reflection.callStaticMethod("org/cocos2dx/javascript/Test", "sum", "(II)I", 3, 7);
cc.log(result); //10

//調用第二個sum方法
var result = jsb.reflection.callStaticMethod("org/cocos2dx/javascript/Test", "sum", "(I)I", 3);
cc.log(result); //5

在你的控制檯會有正確的輸出的,這很簡單吧。

注意

另外有一點需要注意的就是,在android應用中,cocos的渲染和js的邏輯是在gl線程中進行的,而android本身的UI更新是在app的ui線程進行的,所以如果我們在js中調用的Java方法有任何刷新UI的操作,都需要在ui線程進行。

例如,在下面的例子中我們會調用一個Java方法,它彈出一個android的Alert對話框。

//給我們熟悉的AppActivity類稍微加點東西
public class AppActivity extends Cocos2dxActivity {

    private static AppActivity app = null;
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        app = this;
    }

    public static void showAlertDialog(final String title,final String message) {

        //這裏一定要使用runOnUiThread
        app.runOnUiThread(new Runnable() {
            @Override
            public void run() {
                AlertDialog alertDialog = new AlertDialog.Builder(app).create();
                alertDialog.setTitle(title);
                alertDialog.setMessage(message);
                alertDialog.setIcon(R.drawable.icon);
                alertDialog.show();
            }
        });
    }
}

然後我們在js中調用

jsb.reflection.callStaticMethod("org/cocos2dx/javascript/AppActivity", "showAlertDialog", "(Ljava/lang/String;Ljava/lang/String;)V", "title", "hahahahha");

這樣調用你就可以看到一個android原生的Alert對話框了。

再加點料

現在我們可以從js調用Java了,那麼能不能反過來?當然可以! 在你的項目中包含Cocos2dxJavascriptJavaBridge,這個類有一個evalString方法可以執行js代碼,它位於frameworks\js-bindings\bindings\manual\platform\android\java\src\org\cocos2dx\lib文件夾下。我們將會給剛纔的Alert對話框增加一個按鈕,並在它的響應中執行js。和上面的情況相反,這次執行js代碼必須在gl線程中進行。

alertDialog.setButton("OK", new DialogInterface.OnClickListener() {
    public void onClick(DialogInterface dialog, int which) {
        //一定要在GL線程中執行
        app.runOnGLThread(new Runnable() {
            @Override
            public void run() {
                Cocos2dxJavascriptJavaBridge.evalString("cc.log(\"Javascript Java bridge!\")");
            }
        });
    }
});

這樣在點擊OK按鈕後,你應該可以在控制檯看到正確的輸出。evalString可以執行任何js代碼,並且它可以訪問到你在js代碼中的對象。

轉載自:http://www.cocos2dx.net/post/258

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章