如何在 Android 平台上使用 JavaScript 直接调用 Java 方法

    在 方法中,我们通过传入 Java 的类名,方法名,方法签名,参数就可以直接调用 Java 的静态方法,并且可以获得 Java 方法的返回值。下面介绍的类名和方法签名可能会有一点奇怪,但是 Java 的规范就是如此的。

    参数中的类名必须是包含 Java 包路径的完整类名,例如我们在 org.cocos2dx.javascript 这个包下面写了一个 Test 类:

    1. package org.cocos2dx.javascript;
    2. public class Test {
    3. public static void hello(String msg){
    4. System.out.println(msg);
    5. }
    6. public static int sum(int a, int b){
    7. return a + b;
    8. }
    9. public static int sum(int a){
    10. }
    11. }

    那么这个 Test 类的完整类名应该是 org/cocos2dx/javascript/Test,注意这里必须是斜线 / ,而不是在Java代码中我们习惯的点 。

    方法名

    方法名很简单,就是方法本来的名字,例如sum方法的名字就是 sum

    • (I)V 表示参数为一个int,没有返回值的方法
    • (I)I 表示参数为一个int,返回值为int的方法
    • (IF)Z 表示参数为一个int和一个float,返回值为boolean的方法

    现在有一些理解了吧,括号内的符号表示参数类型,括号后面的符号表示返回值类型。因为 Java 是允许函数重载的,可以有多个方法名相同但是参数返回值不同的方法,方法签名正是用来帮助区分这些相同名字的方法的。

    目前 Cocos Creator 中支持的 Java 类型签名有下面 4 种:

    参数

    参数可以是 0 个或任意多个,直接使用 JS 中的 number,bool 和 string 就可以。

    我们将会调用上面的Test类中的静态方法:

    注意

    另外有一点需要注意的就是,在 Android 应用中,cocos 引擎的渲染和 JS 的逻辑是在 GL 线程中进行的,而 Android 本身的 UI 更新是在 App 的 UI 线程进行的,所以如果我们在 JS 中调用的 Java 方法有任何刷新 UI 的操作,都需要在 UI 线程进行。

    例如,在下面的例子中我们会调用一个Java方法,它弹出一个 Android 的 Alert 对话框。

    1. // 给我们熟悉的 AppActivity 类稍微加点东西
    2. public class AppActivity extends Cocos2dxActivity {
    3. private static AppActivity app = null;
    4. @Override
    5. public void onCreate(Bundle savedInstanceState) {
    6. super.onCreate(savedInstanceState);
    7. app = this;
    8. }
    9. public static void showAlertDialog(final String title,final String message) {
    10. // 这里一定要使用 runOnUiThread
    11. app.runOnUiThread(new Runnable() {
    12. public void run() {
    13. alertDialog.setTitle(title);
    14. alertDialog.setMessage(message);
    15. alertDialog.setIcon(R.drawable.icon);
    16. alertDialog.show();
    17. }
    18. });
    19. }
    20. }

    然后我们在 JS 中调用

    这样调用你就可以看到一个 Android 原生的 Alert 对话框了。

    1. alertDialog.setButton("OK", new DialogInterface.OnClickListener() {
    2. public void onClick(DialogInterface dialog, int which) {
    3. // 一定要在 GL 线程中执行
    4. app.runOnGLThread(new Runnable() {
    5. @Override
    6. public void run() {
    7. Cocos2dxJavascriptJavaBridge.evalString("cc.log(\"Javascript Java bridge!\")");
    8. }
    9. });
    10. }

    这样在点击 OK 按钮后,你应该可以在控制台看到正确的输出。evalString 可以执行任何 JS 代码,并且它可以访问到你在 JS 代码中的对象。