一、环境配置

MasOS 15.7.1(arm64)
UnrealEditor 5.5.4
JetBrains Rider 2025.3
Xcdeo 16.0
JDK 17
Visual Studio Code 1.106.1 (Universal)
Android Studio Flamingo | 2022.2.1 Patch 2

Gradle 及 Android SDK 均为Android Studio创建项目后的默认版本

建议：上述工具及环境配置在安装时一律使用其推荐的默认路径

二、插件文件介绍与前期处理

Android/asstes/quickgame_sdk/qg_ipconfig
SDK域名配置文件，若是部署版cp，请复制域名地址api到此文件

MyAndroidMessageSubsystem
常规作为广播消息给UE蓝图Widget
struct FQuickGamePayInfo 封装订单对象

struct FQuickGameRoleInfo 封装角色对象

QuickGameHelper

封装的sdk方法

QuickSDK_UPL.xml

常规注入android代码及依赖，后续如果新增额外接口及第三方依赖可在此添加，参照java文档

三、SDK必接接口

1. 初始化

QuickGameHelper ::GetInstance()->initSDK("SDK product_code");

2. 登录

QuickGameHelper ::GetInstance()->login();

3. 角色信息

角色Ustrut FQuickGameRoleInfo详解（均为必传参数）：

属性名	类型	释义
RoleId	String	角色id
RoleName	String	角色名
ServerId	String	区服id
ServerName	String	区服名
RoleLevel	String	角色等级
VipLevel	String	vip等级
RoleBanlance	String	角色余额
PartyName	String	工会名
RolePower	String	战斗力

QuickGameHelper::GetInstance()->setGameRoleInfo(RoleInfo);

4. 支付

订单Ustrut FQuickGamePayInfo详解：

属性名	类型	释义	是否必传
OrderSubject	String	商品名称	是
ProductOrderId	String	游戏生成的唯一订单号	是
ExtrasParams	String	透传参数请勿传特殊符号，如果无法避免建议进行base64编码	否
GoodsId	String	商品id	是
Amount	Double	商品金额	是
PayParam	String	商品描述	是

QuickGameHelper::GetInstance()->pay(RoleInfo,PayInfo);

5. 注销

QuickGameHelper ::GetInstance()->logout() ;

6. 退出

QuickGameHelper ::GetInstance()->exit() ;

7. 获取渠道标识

QuickGameHelper ::GetInstance()->getChannelType() ;

四、SDK回调

请参照QuickSDK_UPL与GameHelper处理对应逻辑

1. 初始化

JNI_METHOD void Java_com_epicgames_unreal_GameActivity_initSuccessed

JNI_METHOD void Java_com_epicgames_unreal_GameActivity_initFailed

2. 登录

JNI_METHOD void Java_com_epicgames_unreal_GameActivity_loginSuccessed
JNI_METHOD void Java_com_epicgames_unreal_GameActivity_loginFailed

 

3. 支付

JNI_METHOD void Java_com_epicgames_unreal_GameActivity_paySuccessed
JNI_METHOD void Java_com_epicgames_unreal_GameActivity_payFailed

 

4. 注销

JNI_METHOD void Java_com_epicgames_unreal_GameActivity_logoutSuccessed
JNI_METHOD void Java_com_epicgames_unreal_GameActivity_logoutFailed

5. 退出

JNI_METHOD void Java_com_epicgames_unreal_GameActivity_exitSuccessed
JNI_METHOD void Java_com_epicgames_unreal_GameActivity_exitFailed

6. 获取渠道标识

JNI_METHOD void Java_com_epicgames_unreal_GameActivity_getChannelType