【Unity游戏开发】SDK接入与集成——小白入门篇
2017-07-24 09:52
597 查看
一、简介
通常一款游戏开发到后期,一般都会涉及到第三方SDK的接入与集成,对于不熟悉SDK接入的同学来说,接SDK每次都是云里雾里,而熟悉SDK接入的同学又觉得不断地重复做接入SDK工作这样没有成就感,太尼玛无聊了(Android渠道一弄就十几个,直接吐血)。其实通常情况下接入SDK都是很简单的一个过程,本系列博客就让马三和大家从小白开始,从零基础开始学习如何接入SDK以及一些常见的SDK的接入流程。本系列博客规划为以下几篇:SDK接入与集成——小白入门篇(介绍环境搭建以及Unity和Android的基本交互与调用)
SDK接入与集成——信鸽SDK篇(介绍消息推送框架--信鸽SDK的接入)
SDK接入与集成——QQ与微信SDK篇(都是腾讯开放平台的,就放在一起学了)
SDK接入与集成——科大讯飞SDK篇(游戏中的语音通信和语音识别会用到此SDK)
SDK接入与集成——百度地图SDK篇(做LBS游戏必不可少)
SDK接入与集成——第三方SDK接入解决方案AnySDK篇
SDK接入与集成——构建自己的Android集成多SDK框架篇
先挖了这么多坑,以后慢慢填吧,放心博主肯定不会太监的。
二、浅谈常用的两种接入方案
1.第三方SDK接入解决方案
其实游戏SDK接入发展到现在,已经有很多成熟的第三方SDK接入解决方案了,比如AnySDK,ShareSDK,U8SDK等等。这些第三方SDK接入解决方案的整个接入过程,不改变任何SDK的功能、特性、参数等,对于最终玩家而言是完全透明无感知的。让CP商能有更多时间更专注于游戏本身的品质。第三方SDK包括了渠道SDK、用户系统、支付系统、广告系统、统计系统、分享系统等等。利用他们可以轻松快速接入第三方SDK。第三方SDK的统一验证流程基本如下:
2.手动接入SDK
既然上面说的第三方解决方案那么好,为什么我们还有手动去接入SDK呢?造轮子就这么上瘾?其实接入了一些第三方的SDK解决方案以后,我们有的游戏数据是要经过他们的服务器的,对于一些游戏厂商来说,不想让自己的数据经过别人的服务器,或者需要对验证服务器有完全自主的控制权,那么必然要手动接入各种SDK了。另外还有一些奇奇怪怪,非常诡异的SDK,我们也是要手动去接入的,不能都指望第三方的集成。而且作为一名合格的猿类来说,知其然更要知其所以然,掌握SDK的接入原理和过程很有必要。三、开始接入!Unity与Android的交互
前面啰嗦了那麽多,到这里终于可以开始实战操作了。1.Android开发环境搭建
关于Android环境的搭建,网上已经有很多博客了,介绍的很详细,马三就不在这里水了。这里给大家安利一个关于Android开发工具的好网站:http://www.androiddevtools.cn/ 。上面提供了很多可用的AndroidADK国内镜像和教程。2.Android端的开发工作
(1)打开IDE建立一个空的Android库工程,这里我用Eclispe举例。注意Min Required SDK最好选择4.0以上,要不然还需要引入android-support-v7兼容包,比较麻烦,之后我们可以把这个Min Required SDK 再该回来的。需要注意的两步已经截图了,剩下一路Next操作即可。注意包名和勾选Mark this project as a library选项。(2)导入Classes.jar包到Android工程中
Unity和Android做交互,他们两个之间不认识肯定,没法直接通信,因此需要一个中间的搭桥牵线的人,Classes.jar就起到了这个作用。Classes.jar是由Unity提供给我们的,我们需要找到它并且引入到我们的Android项目中。Claess.jar的路径一般如下 X盘:\xxx目录\Unity\Editor\Data\PlaybackEngines\androidplayer\release\bin\classes.jar(不同的计算机上,这个位置可能会有所不同,大家按照自己的路径添加即可)。我们找到它直接拖到我们的Android工程的libs目录下。然后在它上面右键,将其添加到Build Path中。
添加到Build Path成功以后,工程是这个样子的。
(3)编写Android端的代码
我们在Android端编写一些代码,提供一些接口来供Unity一会的调用。打开我们的MainActivity.java,然后添加代码。需要注意的是,让我们的MainActivity继承Jar包中的UnityPlayerActivity类,这样,Unity才能调的到哦,缺什么包,直接让Eclipe自动导下包即可,快捷键ctrl+shift+o。对了,还需要把 setContentView(R.layout.activity_main); 这段代码注释掉,要不然会显示Android的默认布局文件,上面就一个 Hello World。
简单的写了几个普通方法和一个静态方法,供一会的测试调用。(无论是静态方法还是普通方法,在Unity中都是可以调用的到的)MainActicity.java的代码内容如下:
package com.mx.sdkbase; import android.app.Activity; import android.os.Bundle; import android.view.Menu; import android.view.MenuItem; import android.widget.Toast; import com.unity3d.player.UnityPlayer; import com.unity3d.player.UnityPlayerActivity; public class MainActivity extends UnityPlayerActivity { private static MainActivity instance; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); // setContentView(R.layout.activity_main); instance = this; } @Override public boolean onCreateOptionsMenu(Menu menu) { // Inflate the menu; this adds items to the action bar if it is present. getMenuInflater().inflate(R.menu.main, menu); return true; } @Override public boolean onOptionsItemSelected(MenuItem item) { // Handle action bar item clicks here. The action bar will // automatically handle clicks on the Home/Up button, so long // as you specify a parent activity in AndroidManifest.xml. int id = item.getItemId(); if (id == R.id.action_settings) { return true; } return super.onOptionsItemSelected(item); } /** * 供Unity调用的求和函数 * @param x * @param y * @return */ public int Sum(int x, int y) { return x + y; } /**供Unity调用的比较最大值函数 * @param x * @param y * @return */ public int Max(int x, int y) { return Math.max(x, y); } /**供Unity调用的显示吐司的函数 * @param str */ public void MakeToast(String str) { Toast.makeText(this, str, Toast.LENGTH_LONG).show(); } /**供Unity调用的自加一函数 * @param x * @return */ public int AddOne(int x) { return x + 1; } /**供Unity调用的静态方法,单例类,返回当前的Activity对象 * @return */ public static MainActivity GetInstance() { return instance; } /**供Unity调用的函数,此函数会回调指定的一个Unity中的方法,完成数据的双向交互 * @param str */ public void CallUnityFunc(String str){ str=str+"Android Call Unity."; String ReceiveObject="MessageHandler"; String ReceiverMethod="Receive"; UnityPlayer.UnitySendMessage(ReceiveObject, ReceiverMethod, str); } }
(4)导出我们的Android项目为Jar包供Unity调用
在我们的项目上面右键,然后选择Export,选择Java目录下的 Jar file。因为没有用到第三方的jar包或者lib库,因此只要勾选src/和res/目录导出为jar包即可。
(5)Unity端工程的开发
建立一个新的空Unity工程,然后在Asset/目录下建立如下路径的文件夹:Plugins/Android。从名字就可以看出来,这个文件夹是用来存放安卓的插件的。然后将我们上面刚刚导出的SDKBase.jar 包导入到这个目录下,并且将Andoird工程目录下的,libs/ 、res/ 、AndroidMainFest.xml 都复制到该路径下。
需要特别注意的是要将Unity 项目中 libs下的classes.jar文件删除掉,这个就是上面提到的那个起到中介作用的jar包,一定要删掉!一定要删掉!一定要删掉!(重要的事情说三遍,网上不少教程都是针对Unity老版的教程,没有提到要删除这个classes.jar包,结果在Unity 5.x中打包肯定会出错)。出错截图如下所示。
然后我们建立一个场景,简单地在里面放上一些Label和输入框、按钮,供我们验证交互操作。并且编写一个脚本(MessageHandler.cs即是我创建的脚本), 在其中编写用来调用Jar包的C#方法,然后将按钮和这些函数绑定(Unity基本操作,不赘述了)。
MessageHandler.cs 脚本的内容如下,函数的功能看注释就行了,写得很全。
using System; using UnityEngine; using UnityEngine.UI; public class MessageHandler : MonoBehaviour { private AndroidJavaClass _jc; private AndroidJavaObject _jo; public InputField inputFieldA; public InputField inputFiledB; public Text resultLabel; // Use this for initialization void Start() { //初始化 //"com.unity3d.player.UnityPlayer"和"currentActivity"这两个参数都是固定的 //UnityPlayerActivity里面对其进行了处理 _jc = new AndroidJavaClass("com.unity3d.player.UnityPlayer"); _jo = _jc.GetStatic<AndroidJavaObject>("currentActivity"); } public void AddOne() { int a = Convert.ToInt32(inputFieldA.text); //注意,这里使用的就不是之前默认的com.unity3d.player.UnityPlayer,而是需要传入自己的类(实现了需要调用相应方法的类) //因为默认的UnityPlayer中是没有我们所需要的方法的,所以需要加载自己的类 AndroidJavaClass jc = new AndroidJavaClass("com.mx.sdkbase.MainActivity"); //调用Java中的静态方法,单例模式,返回当前Activity实例 AndroidJavaObject jo = jc.CallStatic<AndroidJavaObject>("GetInstance"); resultLabel.text = "AddOne" + jo.Call<int>("AddOne",a); } public void Sum() { int a = Convert.ToInt32(inputFieldA.text); int b = Convert.ToInt32(inputFiledB.text); //调用Java类中的普通方法,返回值为int型 resultLabel.text = "Sum: " + _jo.Call<int>("Sum", a, b); } public void Max() { int a = Convert.ToInt32(inputFieldA.text); int b = Convert.ToInt32(inputFiledB.text); resultLabel.text = "Max: " + _jo.Call<int>("Max", a, b); } public void CallUnityFunc() { //调用Java中的一个方法,该方法会回调Unity中的指定的一个方法,这里会回调Receive( ) _jo.Call("CallUnityFunc","Unity Call Android.\n"); } public void Receive(string str) { resultLabel.text = str; } public void Toast() { _jo.Call("MakeToast","Unity 调用Toast"); } }
通过上面的代码,我们就可以看出来,想在Unity中调用Android的代码,主要涉及到了两个类。AndroidJavaClass 和 AndroidJavaObject 。这两个类在Unity API手册里面有详细的解释。
下面的代码是获取到对应包名的java.lang.Class实例,这里获取到的是com.unity3d.player.UnityPlayer类。
_jc = new AndroidJavaClass("com.unity3d.player.UnityPlayer");
下面的代码是获取到UnityPlayer类中的静态字段,它的返回值类型是AndroidJavaObject对象。
_jo = _jc.GetStatic<AndroidJavaObject>("currentActivity");
通过以上两行代码,我们可以获取到这个AndroidJavaObject 对象,然后用 AndroidJavaObject 对象就可以任意地调用Android中的静态和非静态函数了。其中两个函数中的字符串参数 "com.unity3d.player.UnityPlayer" 和 "currentActivity" 都是固定的写法,我们不用去改变。
AndroidJavaObject 类的一些常用方法及功能如下表所示:
AndroidJavaObject | 构造函数,根据类名返回AndroidJavaObject对象 |
Call | 调用Android代码中的非静态方法 |
CallStatic | 调用Android代码中的静态方法 |
Dispose | IDisposable 回调 |
Get | 获取Android代码中的非静态字段 |
GetRawClass | 获取一个指向Java class的原始引用 |
GetRawObject | 获取一个指向Java object的原始引用 |
GetStatic | 获取Android代码中的静态字段 |
Set | 设置Android代码中的非静态字段 |
SetStatic | 设置Android代码中的静态字段 |
int a = Convert.ToInt32(inputFieldA.text); //注意,这里使用的就不是之前默认的com.unity3d.player.UnityPlayer,而是需要传入自己的类(实现了需要调用相应方法的类) //因为默认的UnityPlayer中是没有我们所需要的方法的,所以需要加载自己的类 AndroidJavaClass jc = new AndroidJavaClass("com.mx.sdkbase.MainActivity"); //调用Java中的静态方法,单例模式,返回当前Activity实例 AndroidJavaObject jo = jc.CallStatic<AndroidJavaObject>("GetInstance"); resultLabel.text = "AddOne" + jo.Call<int>("AddOne",a);
不止Unity可以调用Android的代码,Android也可以反过来回调Unity的代码。下面这段代码就是用来回调Unity函数的:
/**供Unity调用的函数,此函数会回调指定的一个Unity中的方法,完成数据的双向交互 * @param str */ public void CallUnityFunc(String str){ str=str+"Android Call Unity."; String ReceiveObject="MessageHandler"; String ReceiverMethod="Receive"; UnityPlayer.UnitySendMessage(ReceiveObject, ReceiverMethod, str); }
利用UnityPlayer.UnitySendMessage(ReceiveObject, ReceiverMethod, str); 就可以返回过来回调一个Unity中的方法,完成Unity和Android的双向通信。其中第一个参数是接受该回调的gameobject名称,第二个参数是挂载在该gameobject上面的一个脚本中接受该消息的方法,最后一个参数是本条消息发送的字符串信息。比如上面例子中的代码就会调用名称为MessageHandler的gameobject上面挂载的脚本中的Receive方法。
(6)打包发布Android平台的APK
代码写好以后,我们会习惯性地在Unity Editor 里面运行查看一下效果,但是如果要调用 Android 代码的话,是不可以这样做的,一定要在真机上运行(模拟器上也行),在Editor中运行会报错的。所以我们还是打包发布到Android端查看效果吧。
在Unity中按快捷键 ctrl +b ,打开Build Setting界面,然后把平台切换为 Android 平台并将我们的测试场景加到Build Setting队列中。点击PlayerSetting,对工程的信息进行配置。注意要把里面的Company Name和Product Name修改成和包名一致。如下图所示:
然后 ,Bundle Identifier的值也要修改成和包名一样,并且调整下Minimum API Level。如下图:
最后,还记得我们在最一开始建立Android库工程的时候,将最小安装需求的API调成了4.0吗,这就意味着,打出来的APK包安装运行的最低系统要求是Android 4.0。这样肯定是不可以的,要考虑到低版本的Android系统。因此还需要做最后一步的修改,才能打包。
找到我们Unity项目中的 AndroidManifest.xml 文件,用文本编辑器打开它,将android:minSdkVersion的值修改成上一步在面板中设置的 Minimum API Level 对应的版本号,比如我这里面的 Minimum API Level 为2.3.3,其版本号为 10。
之后,我们就可以放心地打包了,打包成功后安装到手机上测试下效果,下面是我在模拟器上测试的几张效果图:
可以看到Unity成功地调用到了Android中的方法,并返回正确的结果,而且Android反过来也回调了Unity中的方法。
四、结语
关于“SDK接入与集成的小白入门篇”就写到这里了,通过本篇博客,我们一起初步地了解和学习了一下Unity和Android是如何交互的。下篇博客,我们将会实战地练习一下“消息推送框架”信鸽SDK的接入与使用,敬请期待!最后放上本篇博客中演示的项目源码:
Github地址:https://github.com/XINCGer/Unity3DTraining/tree/master/SDK/SDKBase 欢迎fork!
作者:马三小伙儿
出处:http://www.cnblogs.com/msxh/p/7220741.html
请尊重别人的劳动成果,让分享成为一种美德,欢迎转载。另外,文章在表述和代码方面如有不妥之处,欢迎批评指正。留下你的脚印,欢迎评论!
相关文章推荐
- 【Unity游戏开发】SDK接入与集成
- 【Unity游戏开发】SDK接入与集成——小白入门篇
- Unity游戏开发——unity接入多渠道sdk
- Unity游戏开发实现短信验证(SMSSDK)
- Unity接入多个SDK的通用接口开发与资源管理(二)
- 【游戏服务器开发】SDK接入——以nibia为例的SDK接入总结
- Unity接入多个SDK的通用接口开发与资源管理(三)
- Unity接入多个SDK的通用接口开发与资源管理(一)
- unity开发关于IOS平台接入之自动化构建管线
- 教你如何开发VR游戏系列教程二:VR SDK介绍及开发流程介绍
- Unity 3D游戏开发工具
- Unity-3D捕鱼达人小游戏开发 —— 游戏中场景
- 采用Unity快速开发高质量游戏的若干优化建议
- Unity游戏开发图片纹理压缩方案
- unity游戏开发为什么工作这么难找
- Android开发接入第三方SDK流程
- 集成华为游戏服务SDK,安装失败存在同名的数据库
- 【Unity游戏开发】浅谈Unity游戏开发中的单元测试
- unity游戏开发之游戏过审后 国行PS4将在3月20日发售
- Unity开发小型游戏中如何便捷使用PureMVC框架