【Unity3D】Unity 中使用 C# 调用 Java ② ( C# 调用 Java 的相关方法介绍 | 调用 Java 方法 | 获取 Java 字段 | 设置 Java 字段 )

在 【Unity3D】Android 打包 ④ ( Android 工程打包 | Unity 中导出安卓工程 | Android Studio 打开 Unity 导出的 Android 工程 ) 博客中将 Unity 项目导出为了 Android 项目 , 并在 Android Studio 中编译并运行了该项目 ;

使用的 C# 脚本 , 是在 【Unity3D】Unity 游戏画面帧更新 ( 游戏物体 GameObject 移动 | 借助 Time.deltaTime 进行匀速运动 ) 系列博客中编写的脚本 ;

在上一篇博客 【Unity3D】Unity 中使用 C# 调用 Java ① ( Android Studio 模块准备 | 编译 Android 模块拿到字节码文件 | 拷贝字节码到 Unity 编辑器 ) 准备了要调用的 Android 模块 , 并且编译得到了字节码文件 , 该字节码文件已拷贝到 Unity 编辑器中 ;

一、 C# 调用 Java 的相关方法介绍

---

在 Unity 的 C# 脚本 中 , 通过

• AndroidJavaClass , 用于调用 Java 类 ;
• AndroidJavaObject , 用于调用 Java 对象 ;

两个类调用 Android 中的 Java 类和对象 ;

1、 AndroidJavaClass 原型

AndroidJavaClass 原型如下 :

using UnityEngine;

namespace UnityEngine
{
    //
    // 摘要:
    //     AndroidJavaClass 是 java.lang.Class 的泛型实例的Unity表示。
    public class AndroidJavaClass : AndroidJavaObject
    {
        //
        // 摘要:
        //     根据类名构造一个AndroidJavaClass。
        //
        // 参数:
        //   className:
        //     指定 Java 类名 (e.g. <tt>java.lang.String</tt>).
        public AndroidJavaClass(string className);
    }
}

创建 AndroidJavaClass 实例对象 , 传入一个 String 字符串类型的 全路径类名即可 , 注意要带包名 ;

// 创建 AndroidJavaClass 类
AndroidJavaClass androidJavaClass = new AndroidJavaClass("kim.hsl.mylibrary.Student");

2、 调用 Java 方法

调用普通方法

通过 AndroidJavaObject#Call() 方法 , 可以调用 Java 类的方法 ; AndroidJavaClass 继承了 AndroidJavaObject 类 , 也可以调用该方法 ;

AndroidJavaObject#Call() 方法原型如下 :

//
// 摘要:
//     在对象上调用Java方法。
//
// 参数:
//   methodName:
//     指定要调用的方法。
//
//   args:
//     传递给方法的参数数组。
public void Call(string methodName, params object[] args);

如果要调用的方法有返回值 , 则在 Call 之后添加一个泛型 , 然后使用 泛型类型变量 接收返回值 , 如下所示 ;

// 调用 kim.hsl.mylibrary.Student 类的 getName 方法
string studentName = androidJavaClass.Call<string>("getName");

调用静态方法

如果要调用静态方法 , 则调用 AndroidJavaObject#CallStatic 方法即可 ; AndroidJavaClass 继承了 AndroidJavaObject 类 , 也可以调用该方法 ;

//
// 摘要:
//     Call a static Java method on a class.
//
// 参数:
//   methodName:
//     Specifies which method to call.
//
//   args:
//     An array of parameters passed to the method.
public void CallStatic(string methodName, params object[] args);

3、 获取 Java 字段

获取普通字段

调用 AndroidJavaObject#Get 方法 , 可以获取 Java 普通字段 ; AndroidJavaClass 继承了 AndroidJavaObject 类 , 也可以调用该方法 ;

在 Get 方法后使用泛型标注字段的类型 , 使用字段类型变量接收获取的字段值 ;

AndroidJavaObject#Get 方法 原型如下 :

public FieldType Get<FieldType>(string fieldName);

方法使用示例 :

// 获取 kim.hsl.mylibrary.Student 类的 name 字段
string studentName2 = androidJavaClass.Get<string>("name");

获取静态字段

调用 AndroidJavaObject#GetStatic 方法 , 可以获取 Java 静态字段 ; AndroidJavaClass 继承了 AndroidJavaObject 类 , 也可以调用该方法 ;

在 GetStatic 方法后使用泛型标注字段的类型 , 使用字段类型变量接收获取的字段值 ;

AndroidJavaObject#GetStatic 方法原型如下 :

public FieldType GetStatic<FieldType>(string fieldName);

方法使用示例 :

// 获取 kim.hsl.mylibrary.Student 类的 TAG 静态字段
string tag = androidJavaClass.GetStatic<string>("TAG");

4、 设置 Java 字段

调用 AndroidJavaObject#Set 方法 , 可以设置 Java 普通字段 ; AndroidJavaClass 继承了 AndroidJavaObject 类 , 也可以调用该方法 ;

在 Set 方法后使用泛型标注字段的类型 ;

AndroidJavaObject#Set 方法原型 :

public void Set<FieldType>(string fieldName, FieldType val);

使用示例 :

// 设置 kim.hsl.mylibrary.Student 类的 name 字段
androidJavaClass.Set<string>("name", "Tom");