Unity集成华为游戏服务SDK方式：Unity集成Android插件

Posted 2022-05-21 华为开发者论坛

原理介绍

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

Unity端

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

创建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上添加组件：

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

到这里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

2. 去掉包名

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

回到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...目录：

2、切换到Android平台，点击Play Settings…：

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

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

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