文档中心>游戏多媒体引擎

导入 SDK 到 Unreal 项目

最近更新时间:2024-10-15 15:11:32

我的收藏
本文介绍如何快速的将 GME SDK(Unreal 版本)集成到您的 Unreal 项目中。

开发环境要求

UnrealEngine 4.22 及以上版本。
Windows 或 Mac平台设备。
能运行 UnrealEngine 工程的配置环境。

步骤1:下载SDK

1. 请先下载相关 Demo 及 SDK。详细下载链接请参见 SDK 下载指引
2. 在界面中找到 Unreal 版本的 SDK 资源。
3. 单击下载。下载完的 SDK 资源解压后有以下几个部分。文件说明如下表:
文件名
说明
作用
GMESDK.uplugin
uplugin 文件
插件配置文件
Resources
插件资源文件
插件资源文件
Source
SDK 文件
SDK 各平台库文件以及代码文件(例如头文件)
Unreal SDK 平台支持:
Unreal SDK 已同时集成 Windows、Mac、Android、iOS 平台架构。如需主机平台架构,请 联系我们

步骤2:导入 GME SDK 到项目中

游戏工程的根目录(xxxx.uproject文件所在目录)下如果不存在 Plugins 文件夹,先新建一个,然后将 GME SDK 拷入 Plugins 文件夹,完成该步骤后的目录结构如下




步骤3:编译插件

刷新 C++工程(Visual studio/Xcode),打开 C++工程,可以看到类似下图的目录结构,然后编译游戏。




步骤4:编译完成

编译完成后重启 UE Editor,在 UE Editor 中打开插件管理器,可以看到 GME SDK 已经引入工程了,确定 GME SDK 是 Enabled 状态。




步骤5:新增 GME SDK 依赖

在游戏工程的 .build.cs 文件中新增 GME SDK 的依赖。




不同 Unreal 版本适配工作

1. Unreal Engine 4.21及以上版本

如果是使用 Unreal Engine 4.21及以上版本,下载使用 GME Unreal Engine 示例代码后要添加以下代码:
AUEDemoLevelScriptActor::AUEDemoLevelScriptActor()
{
PrimaryActorTick.bCanEverTick = true;
}
说明:
在默认的情况下,tick 为关闭状态,必须手动开启。

2. Unreal Engine 4.26版本

Mac 系统编译 Demo 时,出现编译错误:variable 'Xi' set but not used [-Werror,-Wunused-but-set-variable]
解决方法:
修改/Users/Shared/Epic\\ Games/UE_4.26/Engine/Source/Programs/UnrealBuildTool/Platform/IOS/IOSToolChain.cs/Users/Shared/Epic\\ Games/UE_4.26/Engine/Source/Programs/UnrealBuildTool/Platform/Mac/MacToolChain.cs两个文件,将 Result += " -Wall -Werror";改为Result += " -Werror";



打开 UnrealBuildTool 工程,重新编译后再重新打开 UE,打包 MAC 和 iOS 都正常了。