第一步：集成 | 英雄文档

# 1 环境

UE4插件安装包：SDK插件下载

# 1.1 接入准备

开发前需要准备:

开发环境:
- UE4引擎：建议在4.26.2及以上版本；
  - SDK插件开发所使用的UE4引擎版本为 4.26.2；
- iOS打包:
  - 需要 xcode16以上版本，自 2025 年 4 月 24 日起，必须使用 Xcode 16 打包提交App Store (opens new window)
- 安卓开发:
  - JDK 1.8 或以上版本
  - Android Studio 3.0.0或以上版本
  - gradle 2.3.3或以上版本
调试验证的移动设备:
- 需要能正常连接互联网:
  - 安卓: 5.0以上
  - 苹果: iOS11.0以上
- 请注意：SDK的完整功能需要在在真机上运行验证

调试前需要准备:

请通过游戏运营在 SDK 开发者系统 创建游戏参数；
根据发行需要，在中台选择配置渠道、插件、SDK功能模块等；
可联系SDK 运营人员了解更多接入相关信息；

# 1.2 接入流程

# 2 集成

# 2.1 解压资源

解压已下载的资源包（如 HeroUSDKPlugin.zip）, 将得到如图所示文件夹:

以下是资源目录结构说明：

./
├── Binaries               UE4工程生成的中间文件
├── Intermediate           插件编译生成的中间文件
├── Content                插件的资源文件
├── Resources              插件ICON资源文件
├── HeroUSDKPlugin.uplugin 插件配置信息文件,包含插件名称、版本、支持平台等等
└── Source
    └── HeroUSDKPlugin     包含插件的中间层代码、移动平台的库以及相关配置文件
        ├── HeroUSDKPlugin.Build.cs    插件配置文件
        ├── HeroUSDKPlugin_APL.xml     Android端配置文件
        ├── HeroUSDKPlugin_UPL_IOS.xml iOS端配置文件
        ├── Private                    C++相关.cpp文件
        ├── Public                     C++相关.h文件
        ├── Android
        │   ├── AndroidManifest.xml    Android清单文件
        │   ├── assets                 为融合相关配置文件
        │   ├── libs                   为融合相关的libs库
        │   └── res                    为融合Android资源文件
        └── iOS
            ├── HeroBaseSDK.embeddedframework 融合基础库
            ├── HeroUSDK.embeddedframework    融合SDK库
            ├── Global                        全球渠道相关SDK库
            └── Game                          国内渠道相关SDK库

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

# 2.2 复制到游戏工程

将HeroUSDKPlugin文件夹拷贝到游戏工程(UE4) 中的Plugins文件夹下；

如图所示:

# 2.3 启用插件

开启插件：在UE4编辑器中如图:
关闭Google相关插件:

由于USDK使用了Google相关插件，我们必须在UE4插件中搜索Google关键词，并关闭相关插件，以避免Google插件冲突；如图：

# 2.4 在项目中添加

在项目名称.Build.cs中添加HeroUSDKPlugin,如图:

WARNING

插件中有使用到 Json、JsonUtilities 等系统插件，必须在工程配置中添加“Json、JsonUtilities”如上图所示位置，否则会出现转化失败无法初始化

# 3 运行

请先确定游戏能正常编译运行。

# 3.1 开始验证

在确认资源导入后，请开发者尝试将游戏+资源进行打包运行：

如果打包成功并运行后有用户协议弹窗出现，则表示可以继续下一步：
- iOS需要配置《第二步：iOS配置》
- PC（Windows、MacOS）需要配置《第二步：PC配置》
- Android 端可以继续接入《第三步：开始接入》;
如果 打包不成功 或 运行后没有弹窗，请联系我们协助解决；

恭喜你完成USDK集成！

Android端继续配置《第二步：Android配置》

iOS继续配置《第二步：iOS配置》

PC继续配置《第二步：PC配置》

Steam继续配置《第二步：Steam配置》

本文档对解决你的问题有所帮助？