unity-封装接入指南

本文档是对 Unity 引擎游戏如何接入 4399 SDK 的说明
所用示例使用的游戏引擎是 Unity 2018.4.36f1, 不同版本注意兼容问题

下载 unity封装示例 ，解压得到如下结构

.
└── Assets
    ├── Plugins
    │   └── Editor
    └── Scripts
        ├── cn
        └── EaUnityDemo.cs

简单说明Assets目录下的文件

• Assets/Plugins/Editor/**/*.cs：一些插件，主要用于修改依赖、游戏Activity配置、渠道标识等
• Assets/Scripts/cn/**/*.cs：对 java 接口的封装
• Assets/Scripts/EaUnitDemo.cs：接口调用示例

引入 SDK

引入依赖

将Assets目录下的文件拷贝到游戏项目对应位置

• Assets/Plugins/Editor/cn/**/*.cs
• Assets/Scripts/cn/**/*.cs

修改版本

当 SDK 接口不变时，一般只需要提升版本即可

在Assets/Plugins/Editor/cn/m4399/operate/OperateGradleDependencies.cs中

namespace cn.m4399.operate
{
    public class OperateGradleDependencies : AndroidGradleDependencies
    {
        override public int callbackOrder => 101;

        override public List<string> Dependencies()
        {
            var dependencies = new List<string>
            {
                "com.android.volley:volley:1.2.1",
                "com.android.support:support-v4:28.0.0",
                "cn.m4399.sdk:operate:3.14.4"
            };
            return dependencies;
        }
    }
}

将3.14.4修改为最新即可。

按游戏修改

• Assets/Plugins/Editor/cn/m4399/operate/DemoAndroidManifestLaunchModeSingleTop.cs
  • 自定义文件名和类名
  • 修改ActivityClass()方法，返回游戏主Activity，例如:com.unity3d.player.UnityPlayerActivity
• Assets/Plugins/Editor/cn/m4399/operate/OperateChannelId4399.cs
  • 自定义文件名和类名
  • 修改ChannelId()方法，返回实际的渠道标识

接口调用

参考调用示例EaUnitDemo.cs中的用法
接口更具体说明参考 java 接入指南

注意事项

游戏黑屏

若游戏打开了 SDK 的个人中心或其他非全屏页面，再返回游戏，游戏画面出现黑屏，直到关闭 SDK 页面
可调用以下方法尝试修复：

FixBlackScreenHelper.FixBlackScreen();

警告：该方法可能存在风险，开发者使用时应当充分测试