在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代碼中的對象。