Unity在Android和iOS中如何调用Native API

Posted

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Unity在Android和iOS中如何调用Native API相关的知识,希望对你有一定的参考价值。

参考技术A 首先unity支持在C#中调用C++ dll,这样可以在androidios中提供C++接口在unity中调用。利用这一特性,可以扩展unity的功能。例如集成和调用第三方库。同时为了满足对unity接口的一致性,可以考虑在android和iOS上提供相同的接口供C#调用。这里列举以下两个例子。本例对应的接口声明如下:public class CallNativeAPI #if UNITY_EDITOR public static void OpenWebView(string url) return; public static void SumNum(int v1, int v2) TestUnityEditor.SumNum(v1, v2); return; #elif UNITY_IPHONE [DllImport ("__Internal")] public static extern void OpenWebView(string url); [DllImport ("__Internal")] public static extern void SumNum(int v1, int v2); #elif UNITY_ANDROID [DllImport ("libtestunity", CallingConvention = CallingConvention.Cdecl)] public static extern void OpenWebView(string url); [DllImport ("libtestunity", CallingConvention = CallingConvention.Cdecl)] public static extern void SumNum(int v1, int v2); #endif public static void SumNumForResult(int v1, int v2, CallbackManager.ResultCallback callback) TestCallbackManager.sumNumCallback.SetResultCallBack(new CallbackManager.ResultCallback(callback)); SumNum(v1, v2); return; namespace CallbackManager public delegate void ResultCallback(int result); public class SumNumManager public SumNumManager() private ResultCallback resultCallback; public void SetResultCallBack(ResultCallback callback) resultCallback = callback; public void SendResult(int result) resultCallback(result); public class TestCallbackManager public static CallbackManager.SumNumManager sumNumCallback = new CallbackManager.SumNumManager(); 本回答被提问者采纳

Android/iOS内嵌Unity开发示例

目录

前言

背景

正文

环境

新建工程

Unity导出

Android接入

如何使用

作为Activity

总结

1.Android调用Unity

2.Unity调用Android

3.C/C++“中转站”

参考资料


前言

背景

Unity 与 Android/iOS 交叉开发主要有两种方式,以 Android 为例,一是 Android 生成 jar 或者 aar 包,导入到 unity3d plugin/bin/ 目录下;二是 Unity 导出 Android 工程,在 Android Studio 中作为库继续开发。网上的教程几乎全是第一种方式,而本文主要分析第二种方式。

这种方式可以在移动端的 NativeApp 中以库的形式集成已经写好的 Unity 工程,利用 Unity 游戏引擎便捷的开发手段进行跨平台开发。

Unity官方文档 Unity as a Library integration example to iOS and Android

以下以安卓平台作为示例。


正文

环境

  • Android Studio 3.5.3

  • Unity version 2019.3.7f1


新建工程

Android Studio 新建项目:

Unity 新建项目:

最终工程结构如下:


Unity导出

  • 通过 Unity 打开 UnityProject

  • 选择 File -> Build Settings -> Switch Android Platform -> Export Project

这时候选择Export可能会提示JDK路径配置出错,没关系我们到 Preference -> Externl Tools 设置路径

现在就可以点击 Export 了,路径选择可以自由选择,这里建议按照官方来


Android接入

  • 通过 Android Studio 打开 NativeAndroidApp

  • 选择 setting.gradle 文件添加 unityLibrary module

include ':unityLibrary'
project(':unityLibrary').projectDir = new File('..\\\\UnityProject\\\\androidBuild\\\\unityLibrary')
  • 选择 build.gradle(Module:app)添加 dependencies

dependencies 
    implementation project(':unityLibrary')
    implementation fileTree(dir: project(':unityLibrary').getProjectDir().toString() + ('\\\\libs'), include: ['*.jar'])
    // 自己项目的配置
  • 选择 build.gradle(Module:NativeAndroidApp)

allprojects 
    repositories 
        google()
        jcenter()

        // Add Code
        flatDir 
            dirs "$project(':unityLibrary').projectDir/libs"
        
        // End
    
  • 选择 NativeAndroidApp 的 strings.xml 添加

<resources>
    <string name="app_name">NativeAndroidApp</string>
    <string name="action_settings">Settings</string>
    // Add Code
    <string name="game_view_content_description">Game view</string>
    // End
</resources>
  • 点击 ASsync project,可以看到已经多了一个 module

现在我们可以直接使用这个 module 里的 java class 了。


如何使用

作为Activity

现在我们的工程包含了两个 module ,一个是新建工程自带的 app,一个是刚才导入的 unityLibrary。点开 unityLibrary 的目录可以看到两个主要的 class

其中 UnityPlayerActivity 是最重要的 class ,我们可以通过这个类在安卓 app 中显示 Unity 的场景。

至于如何使用—— OverrideUnityActivity 则是对 UnityPlayerActivity 用法的一个官方示例,里面的代码也很简单。

import com.unity3d.player.UnityPlayerActivity;

public abstract class OverrideUnityActivity extends UnityPlayerActivity

    public static OverrideUnityActivity instance = null;

    abstract protected void showMainActivity(String setToColor);

    @Override
    protected void onCreate(Bundle savedInstanceState)
    
        super.onCreate(savedInstanceState);
        instance = this;
    

    @Override
    protected void onDestroy() 
        super.onDestroy();
        instance = null;
    

显然官方希望我们在安卓内用一个 Activity 去显示 Unity 渲染的场景,至于这个 Activity ,直接继承 UnityPlayerActivity 就基本完事了,非常简单。

新建一个 Activity,这里命名为 SourceUnityActivity

public class SourceUnityActivity extends UnityPlayerActivity 
    @Override
    protected void onCreate(Bundle savedInstanceState) 
        super.onCreate(savedInstanceState);
    

现在只要继承 UnityPlayerActivity 就行了。现在构建 app,进入 SourceUnityActivity 的时候就会显示 Unity 的场景了。


总结

1.Android调用Unity

//向unity发消息
UnityPlayer.UnitySendMessage("Main Camera", //gameobject的名字
                             "ChangeColor", //调用方法的名字
                             "");			//参数智能传字符串,没有参数则传空字符串

2.Unity调用Android

//通过该API来实例化java代码中对应的类
AndroidJavaObject jc = new AndroidJavaObject("com.xxx.xxx.UnityPlayer");
jo.Call("Test");//调用void Test()方法
jo.Call("Text1", msg);//调用string Test1(string str)方法
jo.Call("Text2", 1, 2);//调用int Test1(int x, int y)方法

3.C/C++“中转站”

以上的传参方式只能相互传递 string 字符串,少量数据传递时可以使用这种方式,如果是大量数据这样就有点限制了。其实我们可以把C/C++的代码做为一个中转站,实现两边的数据引用与共享。只要在安卓工程加入 NDK 支持和 c++ 源码,就可以在 Unity 端调用了。

其余进阶用法请自行摸索啦哈哈哈,包括Unity中内置插件自控摄像头某些场景的额外编程但不只于此......


参考资料

Unity - Manual: Android Library Projects and Android Archive plug-ins

Unity - Manual: Extend the default Unity activity

Unity - Manual: Native plug-ins for Android

Integration Unity as a library in native Android app - Unity Forum

unity3d - Display Unity Scene as Sub View in android studio - Stack Overflow

以上是关于Unity在Android和iOS中如何调用Native API的主要内容,如果未能解决你的问题,请参考以下文章

Android/iOS内嵌Unity开发示例

如何在unity中调用 多个 第三方android sdk

关于Unity程序在IOS和Android上显示内嵌网页的方式

unity3d 怎样发布android程序

如何把unity 集成到现有的android app

Appcenter Android Build for React-Native with Unity