一、环境配置

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创建项目后的默认版本

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

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

asstes/QHinfo
SDK域名配置文件，若是部署版CP，请复制域名地址api到此文件

ibs/quickgame.aar

MyAndroidMessageSubsystem

常规作为广播消息给UE蓝图Widget

struct FQuickGamePayInfo 封装订单对象

struct FQuickGameRoleInfo 封装角色对象

QuickGameHelper

封装android端海外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等级

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

4. 支付

订单Ustrut FQuickGamePayInfo详解：

属性名	类型	释义	是否必传
OrderSubject	String	商品名称	是
ProductOrderId	String	游戏生成的唯一订单号	是
ExtrasParams	String	透传参数请勿传特殊符号，如果无法避免建议进行base64编码	否
GoodsId	String	商品id	是
Amount	Double	商品金额，需要和下方的货币单位对应，用于appsflyer等数据SDK统计	是
SuggestCurrency	String	货币单位，用于appsflyer等数据SDK统计，以游戏实际货币单位为准 货币单位参考链接：https://en.wikipedia.org/wiki/ISO_4217#Active_codes	是
SkuType	String	默认inapp消耗性，订阅请设置为subs	否
CallbackURL	String	回调地址	否

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

5. 注销

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

6. 展示浮标

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

7. 隐藏浮标

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

四、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_loginCancel
JNI_METHOD void Java_com_epicgames_unreal_GameActivity_loginFailed
//游戏内没有Google订阅类商品可忽略该回调
JNI_METHOD void Java_com_epicgames_unreal_GameActivity_googlePlaySub

 

3. 支付

JNI_METHOD void Java_com_epicgames_unreal_GameActivity_paySuccessed
JNI_METHOD void Java_com_epicgames_unreal_GameActivity_payFailed
JNI_METHOD void Java_com_epicgames_unreal_GameActivity_payCancel

 

4. 注销

JNI_METHOD void Java_com_epicgames_unreal_GameActivity_logoutSuccessed