原理介绍

该集成思路是android studio集成sdk后改为library导出,作为插件给unity使用,unity通过gradle配置集成sdk。即通过android插件 实现sdk接口的调用,但是实际sdk集成在unity实现。


Unity端

首先,unity处理场景Scene,我这里创建布局如下:

Unity集成华为游戏服务SDK方式(四):Unity集成Android插件_android

创建c#脚本文件,并编写点击事件,以初始化为例,代码如下:

定义一个交互对象:

AndroidJavaObject androidSdkObject = null;

在Start中获取对象实例,其中“”中为安卓封装sdk的包名+类名,我这里实现sdk接口调用放在MainActivity中。

void Start()
{
androidSdkObject = new AndroidJavaObject("com.example.lianyungame.library.MainActivity");
}

点击unity中init按钮,实现调用android 中的sdk初始化方法,需要在脚本文件添加如下方法,包含调用init接口方法和接收sdk初始化结果方法:

public void initial()
{
//调用android接口
Debug.Log("initial");
androidSdkObject.Call("init");
}

脚本中处理初始化回调方法:

public void initSuccess()
{
Debug.Log("initSuccess");
}

public void initFailed(string str)
{
Debug.Log("initFailed:" + str);
}

脚本文件方法处理完成后将该脚本文件拖到对应的ui上添加组件:

Unity集成华为游戏服务SDK方式(四):Unity集成Android插件_包名_02

操作后可以看到脚本文件已挂载到画布Canvas上,如图:

Unity集成华为游戏服务SDK方式(四):Unity集成Android插件_ide_03

到这里unity的代码交互处理完成。


Android端

接下来处理android代码:

Android Studio中新建工程并参考华为官方sdk集成文档集成游戏服务sdk,并处理与unity交互逻辑。因为android java类要继承UnityPlayerActivity类,所以还需要将unity目录下的Editor\Data\PlaybackEngines\AndroidPlayer\Variations\il2cpp\Development\Classes\classes.jar拷贝到android项目launcher/libs目录下,并添加对该jar包的依赖。

Android studio集成sdk参考文档:

https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/integrate-as-sdk-0000001050435953

以实现游戏初始化接口为例,在调用接口后把结果通过UnityPlayer.UnitySendMessage回调给unity。

public void init() {
AccountAuthParams params = AccountAuthParams.DEFAULT_AUTH_REQUEST_PARAM_GAME;
JosAppsClient appsClient = JosApps.getJosAppsClient(UnityPlayer.currentActivity);
Task<Void> initTask;
ResourceLoaderUtil.setmContext(UnityPlayer.currentActivity);
initTask = appsClient.init(
new AppParams(params, new AntiAddictionCallback() {
@Override
public void onExit() {
UnityPlayer.UnitySendMessage("Canvas", "exit", "");
}
}));
initTask.addOnSuccessListener(new OnSuccessListener<Void>() {
@Override
public void onSuccess(Void aVoid) {
Toast.makeText(UnityPlayer.currentActivity, "init success", Toast.LENGTH_LONG).show();
UnityPlayer.UnitySendMessage("Canvas", "initSuccess", "");
}
}).addOnFailureListener(
new OnFailureListener() {
@Override
public void onFailure(Exception e) {
Toast.makeText(UnityPlayer.currentActivity, "init failed", Toast.LENGTH_LONG).show();
if (e instanceof ApiException) {
ApiException apiException = (ApiException) e;
int statusCode = apiException.getStatusCode();
Toast.makeText(UnityPlayer.currentActivity, "init failed,statusCode is " + statusCode, Toast.LENGTH_LONG).show();
if (statusCode == JosStatusCodes.JOS_PRIVACY_PROTOCOL_REJECTED) { // 错误码为7401时表示用户未同意华为联运隐私协议
Log.i(TAG, "has reject the protocol");
// 此处您需禁止玩家进入游戏
UnityPlayer.UnitySendMessage("Canvas", "initFailed", "has reject the protocol");
} else if (statusCode == GamesStatusCodes.GAME_STATE_NETWORK_ERROR) { // 错误码7002表示网络异常
Log.i(TAG, "Network error");
// 此处您可提示玩家检查网络,请不要重复调用init接口,否则断网情况下可能会造成手机高耗电。
UnityPlayer.UnitySendMessage("Canvas", "initFailed", "Network error");
} else if (statusCode == 907135003) {
// 907135003表示玩家取消HMS Core升级或组件升级
Log.d(TAG, "init statusCode=" + statusCode);
init();
} else {
// 在此处实现其他错误码的处理
UnityPlayer.UnitySendMessage("Canvas", "initFailed", "other error");
}
}
}
});
}

可以自行编写Ui界面,编译测试接口没问题后将项目改为library导出,提取jar包。

1. 修改application为library

Unity集成华为游戏服务SDK方式(四):Unity集成Android插件_包名_04

2. 去掉包名

Unity集成华为游戏服务SDK方式(四):Unity集成Android插件_游戏服务_05

3. 编译后找到编译文件,解压后把根目录下的classes.jar拷贝到unity的Assets>Plugins>Android>libs目录下

Unity集成华为游戏服务SDK方式(四):Unity集成Android插件_android_06

回到unity打包

Unity项目中添加sdk集成配置:

1、baseProjectTemplate.gradle 文件中添加AppGallery Connect plugin 以及 Maven repository,如下:

buildscript {
repositories {**ARTIFACTORYREPOSITORY**
google()
jcenter()
maven { url 'https://developer.huawei.com/repo/' }
}
}
dependencies {
classpath 'com.huawei.agconnect:agcp:1.4.2.300'
}
repositories {**ARTIFACTORYREPOSITORY**
google()
jcenter()
maven { url 'https://developer.huawei.com/repo/' }
flatDir {
dirs "${project(':unityLibrary').projectDir}/libs"
}
}

2、launcherTemplate.gradle和mainTemplate.gradle分别添加构建依赖。

dependencies {
implementation project(':unityLibrary')
implementation 'com.huawei.hms:game:6.1.0.301'
implementation 'com.huawei.hms:hwid:6.4.0.300'
implementation 'com.huawei.hms:iap:6.1.0.300'
}

3、Json文件需要在manifest文件中配置appid,否则调用接口异常:

<meta-data   
android:name="com.huawei.hms.client.appid"
android:value="appid=xxx">
</meta-data>

然后检查包名与华为后台包名一致,签名编译运行并打包测试。

1、打开unity File>Build Settings...目录:

Unity集成华为游戏服务SDK方式(四):Unity集成Android插件_android_07

2、切换到Android平台,点击Play Settings…:

Unity集成华为游戏服务SDK方式(四):Unity集成Android插件_android_08

3、左边选中Player,打开Other Settings,勾选Override Default Package Name并重写包名,Minimun API Level选中19(sdk要求最低为19)。

Unity集成华为游戏服务SDK方式(四):Unity集成Android插件_游戏服务_09

4、选中Player,打开Publishing Settings,设置签名。

Unity集成华为游戏服务SDK方式(四):Unity集成Android插件_游戏服务_10

5、返回上一个页面,选中场景,点击Build打包即可。其他接口类似,可自行集成并调测。

Unity集成华为游戏服务SDK方式(四):Unity集成Android插件_ide_11