12/12/2024 11:37:55

接入教程（Unity）

一、导入插件

按照 GCloudSDK 文档指引，将 SDK 导入工程中。

二、配置环境

详情请参考 环境配置 文档。

三、接入功能

3.1 注册MSDK初始化回调

0） 注意事项：

该接口 PIX 版本必须接入，非 PIX 版本可不接入

• 一般版本：版本号第三段以 0 开头，如：V5.31.000
• Pix 版本： 版本号第三段以 1 开头，如：V5.31.100

1） 功能描述

接受MSDK初始化完成的回调，游戏需要注册回调函数进行处理。游戏需要等待该回调完成后，才能开始调用MSDK其他模块功能接口。

2） 接口声明

/// <summary>
//// MSDK初始化回调
/// </summary>
public static event OnMSDKRetEventHandler<MSDKBaseRet> InitRetEvent;

3）示例代码

MSDK.InitRetEvent += OnInitRetEvent;

private void OnInitRetEvent(MSDKBaseRet baseRet)
{
	Debug.Log ("OnInitRetEvent in MSDK");

	if (baseRet.retCode == MSDKError.SUCCESS) {
		Debug.Log ("MSDK is initialized successfully. ");
		// 此时可以调用MSDK接口了
	} else {
		Debug.Log ("Failed to initialize MSDK.");
	}
}

3.2 初始化 MSDK

需要在游戏开始时，执行 MSDK.Init 方法来初始化 MSDK 模块。

MSDK.isDebug = true; // Unity 层设置 MSDK 为 Debug 模式，可以打印出更多级别的日志（设置为false，仅打印 error 级别日志）；原生日志通过 MSDKConfig.ini 配置，详情请参考 二、配置环境
MSDK.Init ();

3.3 MSDK 功能模块

MSDK 功能模块的调用，请参考 功能模块 文档中的调用方式。

四、打包

4.1 Android 的环境配置

• 建议使用 Gradle 打包方案，具体方案可以咨询 GCloud 相关同事。
• 如果使用 ADT 打包方式，遇到方法数超标问题，需要使用 Android MultiDex 方案。详情请咨询 GCloud 相关同事。

4.2 iOS 的环境配置

• iOS 使用 XUPorter 打包，需要注意 MSDK 相关的配置
• 详情请咨询 GCloud 相关同事。

五、常见问题

1、关于 Android 端混淆配置文件 proguard-rules.pro 的注意事项

PIX 版本，大部分 java 类都是通过 JNI 反射调用的，当业务开启代码混淆后，可能会导致部分反射找不到类或方法。当业务在 gradle 打包插件时，业务需注意 MSDK proguard-rules.pro 文件新增的内容。