西瓜SDK(Unity3D)接入文档

1 文档概述

此文档为Unity3D引擎游戏客户端接入文档。介绍如何在Unity3D引擎平台下,游戏客户端快速接入XGSDK。

1.1 文档结构

  1. 文档概述
  2. SDK下载
  3. 接口说明
  4. 注意事项

2 SDK下载

Unity3D SDK下载

下载完成后,将.unitypackage文件 导入游戏的unity工程

3 接口说明

接口详细说明

4 注意事项

4.1 安卓注意事项:

4.1.1 文件位置

文件所在位置:<项目目录>\Assets\Plugins\Android\

4.1.2 AndroidManifest.xml文件配置

1. 如果导入的AndroidManifest.xml文件 与游戏 已有文件冲突,则自行合并其中的内容到游戏AndroidManifest.xml文件中。
2. application标签中的android:name必须配置为com.xgsdk.client.api.XGApplication或其子类;
3. activity标签中的android:name必须配置为com.xgsdk.client.api.unity3d.XGUnityActivity或其子类,或者com.xgsdk.client.api.unity3d.XGUnityNativeActivity或其子类;
4. 如果游戏的主activity继承了UnityPlayerActivity,那么游戏的主activity需要修改继承XGUnityActivity,XGUnityActivity类已经继承了UnityPlayerActivity,并且实现了Android生命周期方法;同理,如果游戏的主activity继承了UnityPlayerNativeActivity,那么游戏的主activity需要修改继承XGUnityNativeActivity。
5. AndroidManifest.xml修改完类似下图:

4.1.3 打包注意事项

需要设置最终包的android:installLocation属性为auto,如果不指定auto,会默认为preferExternal,导致打出的Android包在一部分有外置储存卡的手机上无法安装。 设置步骤:【build】-【Player Settings】-【Other Settings】-【Install Location】- 选择automatic

4.2 iOS注意事项:

导入.unitypackage文件时,确保libs/iOS/的所有.a文件导入即可。