Unity官方为广大游戏开发者提供了集成华为HMS SDK的方式,包含游戏和华为hms core其他功能模块,这里只介绍如何集成游戏模块。
Unity官方文档链接:https://docs.unity.cn/cn/Packages-cn/com.unity.huaweiservice@1.3/manual/gameservices_cn.html
打开文档后,左上角可以查看文档版本,默认是1.3.4版本。
当前最新文档是2.3.0,建议切换到最新版本集成sdk,具体接口在1.3.4版本,接入接口时需要切换回1.3.4版本。点击左上角下三角符号切换:
如果集成过程中遇到问题,可以登录网页版unity账号,点击右上角中问号,咨询unity官方技术人员。附上unity链接:https://distribute.dashboard.unity.com/list
先下载华为游戏unity demo,下载链接:
https://github.com/Unity-Technologies/HuaweiServiceSample
使用的unity版本2020.2.4.f1c1,下面言归正传,集成步骤如下:
下载后将demo导入到unityhub,在unityHub中打开demo,在弹出的弹窗中选择ignore,如图:
等待项目导入project到unity。
导入之后,点击file->build settings->player settings,将产品信息替换为自己的。
对应的将包名和版本号替换为自己的。
将自己在AGC后台配置应用的agconnect-services.json文件放在如下目录下。
Json文件获取地址参考文档:
https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/integrate-as-sdk-0000001050435953
将以下红线选中文件删掉:
重新创建自己应用的gradle文件,创建方法为在player setting页面,将以下选项打勾,unity自动在对应位置创建文件,如图:
然后在对应的文件里面加入Game Service SDK的配置,我们参考unity官网提供的文档如下章节完成相关配置,不做赘述。
链接:
https://docs.unity.cn/cn/Packages-cn/com.unity.hms@1.2/manual/appgalleryChinese.html#1-%E4%BB%8Eunity-asset-store%E5%AF%BC%E5%85%A5%E6%AD%A4%E5%8D%8E%E4%B8%BAhms-core-app-services-sdk
配置完后,选中game的unity文件编译
出现弹窗
这是要签名的意思,默认勾选了签名,改为不勾选可以先跳过签名
但是最终发布还是需要签名,我这里直接配置签名文件
选中我本地的keystore文件,必须是keystore文件,jks文件识别不到,自己本地转化一下即可。
这里顺便写一下我自己的转化步骤:
1. 先将jks转化为中间文件.p12,命令行输入 :
keytool -importkeystore –srckeystore 后缀为jks文件的路径 -deststoretype PKCS12 -destkeystore p12的存放路径
2. 将.p12转化为keystore文件,命令行输入:
keytool -v -importkeystore –srckeystore p12文件的路径 -srcstoretype PKCS12 –destkeystore keystore存放路径 -deststoretype JKS
将keystore文件导入后输入自己的签名文件的密码。如图
重新编译,然后在控制台报错:
看这个意思应该是c#文件里面的错误,模块太多,我只需要游戏相关的就行,咨询了unity人员说可以把不相关的删掉,还帮我划分了下可以删除的部分。
按照图片删掉里面框住的部分,再编译,报错如下:
看到里面报错很多刚刚删除的模块相关文件找不到,找到这个test文件夹,删掉,还有这个错误
也将对应路径下的void文件删掉,重新build。然后报错
看这个报错cs文件有错,看了代码没发现错误,重启unity编辑器或者操作一个简单粗暴的方法,创建新项目,然后把assets文件夹挪进去,重新编译,这样可以避免因为一些环境不同的原因出现一些无从下手的问题。我这里重启后之前错误消失,出现了其他报错。
看样子全部是ui文件夹里面的报错,应该是用到了之前删除的文件,从而找不到了。把ui文件夹删掉,重新build,报错:
提示我包不存在,应该是哪里有用到,最后我在这个路径下找到相关文件夹
删掉后重新build,编译成功,成功打包apk。
手机安装后效果如图:
安装后就可以自行调测接口啦。
unity接口和华为原生游戏sdk接口映射可以参考:
https://developer.huawei.com/consumer/cn/forum/topic/0201519912259900022?fid=0101271690375130218
unity接口文档参考:
https://docs.unity.cn/cn/Packages-cn/com.unity.huaweiservice@1.3/manual/gameservices_cn.html