Unity与Android交互(4)——接入SDK

这篇具有很好参考价值的文章主要介绍了Unity与Android交互(4)——接入SDK。希望对大家有所帮助。如果存在错误或未考虑完全的地方,请大家不吝赐教,您也可以点击"举报违法"按钮提交疑问。

【前言】

unity接入Android SDK有两种方式,一种是把Unity的工程导出google project的形式进行接入,另一种是通过把Android的工程做成Plugins的形式进行接入。我们接入SDK基本都是将SDK作为插件的形式接入的。

对我们接入SDK的人来说,SDK也是分等级的:

第一等级:只有so文件,这种so文件里一般是算法居多,他们不懂得如何做成SDK,这时需要做这个JAR中间层,C#调用JAR接口,JAR接口调用so文件接口,如果你懒得做,可以让给so文件的人做,本来就是他们应该做的。或者直接用C#调用C++的方式来接入。如果连so文件都没给,可以直接开喷,一般不会出现这种情况。

第二等级:有Androrid SDK和接入文档,我们知道Android SDK一般包含so文件和jar,理论上我们可以直接在C#端调用了。如果是功能简单的SDK可以这样做,如果SDK比较复杂,尤其是涉及Activity有生命周期的,必须自己再写个Jar作为中间层。这时候,如果接入文档不清晰就有很多坑。如果有直接的SDK对接人,任何不清楚的地方就要直接问。很多SDK不是一般不是面向Unity的,都在这个范围内

第三等级:有Android SDK和中间层Jar、接入文档。这种SDK接入起来比较舒服Jar层大的框架都给你搭建好了,你肯定要拿到Jar的代码的,根据项目需要和使用SDK的需要,在Jar层修改些代码,在C#层调用就可以了。这种一般是面向Unity的SDK。

第四等级:有Android SDK和中间层Jar以及C#层调用接口。这种SDK接起来最轻松,只需要根据需要在C#调用接口,写回调函数即可,看文档的时候注意调用什么方法,参数都是什么,代表什么意义,回调参数都是什么即可。一般这种SDK是比较成熟的可以面向Unity的大型SDK,接口回调什么的都会给你设置好。

SDK接入多了熟练了之后,你会发现接入SDK是一件无聊又费时的事情,你不知道别人家的SDK会不会在文档中没说明什么问题,坑很多,Android的和iOS的有时候又往往不一样。SDK的测试相比GamePlay等在Editor上就能测试的而言会繁琐很多,你必须需要等到出包之后才能进行验证和测试,Android和iOS都要测一遍,甚至不同的机型也要测下,看Log还需要连接adb拿log,自己看不懂log还要交给对方去看,需要来回沟通。为了提高效率,必须要了解如何热更和打包。

【接入SDK的两种方式】

第一种是,将 Unity 在安卓平台选择 Gradle 打包出来,然后在Android Studio中接入原生SDK,并生成APK

第二种是,将SDK做成 Unity Plugin,生成jar或arr在C#层调用。

基本上我们都是用第二种方式接入的。

【UnityPlayer与UnityPlayerActivity】

Activity生命周期

游戏启动时调用MainActivity,也即UnityPlayerActivity。(以下代码源自反编译)

按照Activity的生命周期,先调用onCreate(),onCreate时new了一个UnityPlayer

unity 接入安卓sdk,接入Android SDK

UnityPlayer实例化时主要做了以下事情:

  1. 指定currentActivty,上下文mContext;
  2. preloadJavaPlugins()预加载JavaPlugins,主要是调用com.unity3d.JavaPluginPreloader,其是Unity引擎的一个Java类,用于在Android应用程序启动时提前加载相关插件,以提高应用程序的性能和稳定性
  3. loadNative(getUnityNativeLibraryPath(var1))中加载libmain.so文件,libmain.so是一个动态共享库文件,用于处理Unity游戏引擎的启动和初始化过程,该库包含了Unity引擎的主要逻辑和函数,包括资源管理、场景管理、物理引擎、渲染引擎等。
  4. this.mContext.registerReceiver(this.mKillingIsMyBusiness,newIntentFilter("com.unity3d.intent.action.SHUTDOWN")) 使用Activity的registerReceiver()方法来注册一个BroadcastReceiver,并指定想要监听的广播时间类型为com.unity3d.intent.action.SHUTDOWN,收到该事件时指定onReceive方法,也即finish方法,这finish方法是Android系统的finish(),用于结束当前Activity并退出应用程序
  5. this.m_MainThread.start() unity主线程开始运行(前面进行过实例化),设置了线程名字为UnityMain。

unity 接入安卓sdk,接入Android SDK

unity 接入安卓sdk,接入Android SDK

 unity 接入安卓sdk,接入Android SDK

unity 接入安卓sdk,接入Android SDK

unity 接入安卓sdk,接入Android SDK

当暂停时,调用UnityPlayer的Pause方法, 如果这个暂停是结束,会调用到UnityPlayer.ShutDown,否则调用Semaphore.release()用于释放一个许可证并增加信号量的计数器,以便其他线程可以获取许可证并访问共享资源。调用Semaphore.drainPermits来判断是否需要Destroy。

(Semaphore 是 Java 中的一个多线程同步工具,它可以用来控制并发线程数,防止出现线程安全问题。在 Semaphore 中,许可证的数量表示可以同时执行的线程数。当一个线程需要执行某个操作访问共享资源时,它需要先调用acquire()方法获取一个许可证,这会减少信号量的计数器,如果当前许可证的数量为 0,那么这个线程就会被阻塞。当共享资源被释放时,线程需要调用release()方法来释放许可证并增加信号量的计数器。而调用 Semaphore.drainPermits() 方法后,Semaphore 中所有的许可证都会被强制释放。这个方法通常在一些特殊情况下使用,比如在程序退出时,需要强制释放 Semaphore 中的所有许可证,以确保程序能够正确退出。)

unity 接入安卓sdk,接入Android SDK

 unity 接入安卓sdk,接入Android SDK

 当Resume时,调用UnityPlayer的Resume方法,最终会调用UnityPlayer.this.nativeResume(),其会继续调用Unity游戏引擎底层的C++代码,以便在Android系统中恢复Unity的渲染和逻辑处理。同时主线程Resume。

unity 接入安卓sdk,接入Android SDK

unity 接入安卓sdk,接入Android SDK

 当Destory时,调用UnityPlayer的quit方法,在该方法中主线程销毁,卸载libmain.so

unity 接入安卓sdk,接入Android SDK

这些会经过Unity C++ NativeCode会调用到C#的 OnApplicationPause、OnApplicationFocus、OnApplicationQuit

 UnitySendMessage

UnitySendMessage最终调用了nativeUnitySendMessage

unity 接入安卓sdk,接入Android SDK

 还有其他的一些例如各种输入事件等,都是从Java调用Unity的C++ NativeCode,继而调用我们平常使用的Unity C# API

unity 接入安卓sdk,接入Android SDK

 可以看到UnityPlayerActivity是Activity和UnityPlayer的中间层,核心都在UnityPlayer中。

【在Unity中接入SDK】

如果把前面的文章都看完了,那么对于如何接入SDK就有了一定的了解,理顺一些初始化、调用关系等在实现逻辑上应该没有疑惑了。

接入单个SDK

先判断这个SDK需不需要生命周期,如果需要可以继承UnityPlayerActivity,在onCreate等方法中调用SDK的方法等,其他的写一些Java方法,让C#可以调用即可。

如果有生命周期,又不想继承UnityPlayerActivity,可以在Java通过onCreate等调用SDK的方法改为C#通过OnApplicationPause等调用。

如果SDK不需要生命周期,在Java里写入一些初始化方法,参数从C#调用时传递进去即可,如果SDK仅需要Activity参数,获取到UnityPlayer的curActivty传递进去即可。

如果SDK必须有独立的Activity,那就在Java中通过Intent调用另一个Activtiy,也就是如何切换Activty的问题。

接入多个SDK

考虑接入单个SDK时,我们有三层,C#、JAR、SDK,在C#层我们会将业务层直接调用C#方法,在Jar层我们会直接调用SDK的方法。

如果要接入多个SDK每个SDK分开接入的话,就会有多个上述的三层,不好管理。我们自然而言的就会想到合并,合并就是要做一个中间层,供业务层和SDK通信。这个中间层就是中间件。

中间件包括C#层和Jar层,原来业务层是直接调用C#方法,C#调用Java方法,Java方法里调用SDK方法,现在是业务层调用中间件的C#层,C#调用Jar层,Jar层调用SDK的方法。

我们知道SDK提供的方法可以分为以下几类:

初始化相关的方法A、可能的生命周期方法B、业务需要的功能方法C

假设要接入三个SDK: X Y Z

那么我们至少要调用9个方法(3x3)

我们在调用方法时有三个选择:一个是直接在C#调用某个SDK的某个方法,例如AndroidJavaClass.Call(XA)。另一个是在C#传入参数,间接调用,在Java端再直接调用方法,例如调用SDK的初始化方法时,将SDK类型作为参数,在Java端根据类型再调用对应SDK的初始化方法。三是更进一步的是将调用的方法名字也作为参数传入。

至于使用哪种方式看你自己,推荐的方式是中间件的方法直接调用,SDK的初始化和声明周期方法间接调用,功能方法全参数调用。

回调参数设计

我们有多个SDK的多个方法,但回调时Unity只给有一个string类型的参数,为了解决各种不同类型的回调,我们自然而然想到的是用json字符串。格式如下: 

{
    "sdkname": "xxx",
    "methodname": "xxx",
    "result": 0,
    "data": {
        "type": "xxx.",
        "filename": "xxx",
        "country": "xx"
}

在回调用方法中,将Json字符串转为C#对象,依次switch sdkname、methodname,创建对应的处理方法,有一个简单的result用于区分同一个方法在不同情况下的回调,回调的结果放在data里,每个方法有各自不同的data。

之后如果有新增的Sdk,直接创建对应的方法即可。

中间件结构设计

C#层:

C# SDKManager类,其中包含业务调用的接口,持有各种不同的SDK基类(将不同的SDK当作组件),及回调函数

各种SDK基类及其PC子类、Android子类、iOS子类,在Android子类中调用Jar层方法,相同功能的SDK可以再抽象出一个基类

Jar层:

JavaSDKManager类,其中包括C#层调用的接口,持有各种SDK类,及UnitySendManager等

各种SDK类包含调用SDK的方法。

【参考】

Unity3d Android SDK接入解析(二)Unity3d Android SDK的设计与两种接入方式_android unity 3d app 架构_小杨在玩iOS的博客-CSDN博客文章来源地址https://www.toymoban.com/news/detail-560686.html

到了这里,关于Unity与Android交互(4)——接入SDK的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处: 如若内容造成侵权/违法违规/事实不符,请点击违法举报进行投诉反馈,一经查实,立即删除!

领支付宝红包 赞助服务器费用

相关文章

  • 【unity接入SDK案例】从0到1 如何接入百度地图SDK到unity中【一】

    👨‍💻个人主页 :@元宇宙-秩沅 👨‍💻 hallo 欢迎 点赞👍 收藏⭐ 留言📝 加关注✅! 👨‍💻 本文由 秩沅 原创 👨‍💻 收录于专栏 :Unity基础实战 下载入口 下载入口 android studio版本是:2021.2.1.16, 打开后 点击SDK Manager 我们需要更改一下SDK的安装路径 选择自己新建的文

    2024年03月17日
    浏览(30)
  • Unity接入SDK

    C#是托管语言,C++是非托管语言。 托管代码和非托管代码的区别 1、托管代码是一种中间语言,运行在CLR上;非托管代码被编译为机器码,运行在机器上。 2、托管代码独立于平台和语言,能更好的实现不同语言平台之间的兼容;非托管代码依赖于平台和语言。 3、托管代码可

    2024年02月16日
    浏览(26)
  • Unity接入PICO Unity Integration SDK

     1.我下载的SD版本是 2.2;  2.支持Pico3 ,Pico 4开发   3.Pico设备的系统版本要在5.6.0以上 4.注意支持的Unity 版本最低为2020.3.21  我用的是2021.2.5 下载完成并且解压出来  1.打开包管理器,选择从磁盘中加载选择 packakge.json  回到unity后会看见是否切换新版输入系统,然后等待unity重启

    2024年02月07日
    浏览(29)
  • Unity接入海康相机SDK(保姆级)

    1.问题描述:控制海康相机进行操作(远焦、近焦、上下左右移动等)。 2.准备:官网下载SDK:https://open.hikvision.com/#home 选择适合自己平台代码语言开发的SDK下载 Demo里有对应案例可查看 在库文件里除了ClientDemoDll文件 都拖进unityPlugins ,然后有两个重复Dll文件(OpenAL,AudioRend

    2024年02月16日
    浏览(24)
  • 【Unity】接入Max广告聚合SDK

    下载和导入MAX Unity插件: 官方SDK链接 在这里插入图片描述 2.初始化MAX SDK: 3.配置广告源 选择所需要的广告源。点install。ExternalDependencyManager会帮你根据选择的广告源下载对应的SDK,可能需要挂vpn 4.在Unity应用中加载广告 激励视频有一下参考接口 其他类型的广告接口可以看侧

    2024年02月08日
    浏览(27)
  • unity接入讯飞AIUI(Windows SDK)

    一、什么是AIUI AIUI 是一套人机交互解决方案,整合了语音唤醒、语音识别、语义理解、内容平台、语音合成(比普通的语音合成多一个发音人)等能力。 新用户有20个免费的装机量,每天有500交互次数 二、创建AIUI 在控制台→我的应用→创建新应用中来创建自己测试项目 三

    2024年02月08日
    浏览(26)
  • 【第三方SDK接入汇总】Unity接入VuforiaAR(图片识别)

    目录 一.注册Vuforia账号 二.获取许可秘钥 三.获取Vuforia的SDK导入unity 四.搭建创建AR场景 五.打包到手机 注册地址:Engine Developer Portal 申请地址:https://developer.vuforia.com/vui/develop/licenses 方式一: 官网下载 下载地址:SDK Download | Engine Developer Portal  下载后把package包导入unity即可。

    2024年04月08日
    浏览(41)
  • Unity发布抖音小游戏:SDK接入

    上篇介绍Unity小游戏发布抖音平台的开发者账号注册以及小游戏创建和申请。本篇介绍字节SDK接入Unity游戏项目中。 接入参考教程:Docs,下载bgdt.package包,并导入Unity项目工程。    打开ByteGame菜单,弹出字节工具面板。点击下载安装另外2个字节小游戏工具。   安装完毕后,

    2024年02月16日
    浏览(30)
  • 【Unity】接入MAX聚合广告SDK Applovin + GoogleAdmob

    版本: Unity:2019.4.35f1 gradle plugin: 4.2.0 (实际要7.0+ 对应build_tools:34.0.0) gradle: 6.7.1 (实际要7.0+ 对应build_tools:34.0.0) jdk: 1.8.0_241 build_tools: 34.0.0 ndk: android-ndk-r19 文档: 6.0.1(Android 12.0.0 iOS 12.0.0) MAX聚合广告Unity:MAX Mediation Documentation 8.5.3 Google Admob:Releases · googleads/googleads-mobi

    2024年02月05日
    浏览(32)
  • 【Android -- 开源库】腾讯 TBS 浏览器 SDK 接入

    在 Android 开发项目中,经常会用到 Webview 。而 WebView 是出了名的坑,各种 Bug。腾讯 TBS 浏览服务面向应用开发商和广大开发者,提供浏览增强,内容框架,广告体系,H5游戏分发,大数据等服务,能够帮助应用开发商大幅改善应用体验,有效提升开发,运营,商业化的效率。

    2024年02月11日
    浏览(26)

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

博客赞助

微信扫一扫打赏

请作者喝杯咖啡吧~博客赞助

支付宝扫一扫领取红包,优惠每天领

二维码1

领取红包

二维码2

领红包