更新日期:2026年 01月 16日QuickGame(安卓 UE)客户端接入文档
<h3>
<span style="font-size:16px;">一、环境配置</span>
</h3>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<span style="font-size:14px;">MasOS 15.7.1(arm64)</span><br />
<span style="font-size:14px;">UnrealEditor 5.5.4</span><br />
<span style="font-size:14px;">JetBrains Rider 2025.3</span><br />
<span style="font-size:14px;">Xcdeo 16.0</span><br />
<span style="font-size:14px;">JDK 17</span><br />
<span style="font-size:14px;">Visual Studio Code 1.106.1 (Universal)</span><br />
<span style="font-size:14px;">Android Studio Flamingo | 2022.2.1 Patch 2</span><br />
<p>
<span style="font-size:14px;">Gradle 及 Android SDK 均为Android Studio创建项目后的默认版本</span>
</p>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<p>
<span style="font-size:14px;color:#E53333;"><strong>建议:上述工具及环境配置在安装时一律使用其推荐的默认路径</strong></span>
</p>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<h3>
<span style="font-size:16px;">二、插件文件介绍与前期处理</span>
</h3>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<p>
<span style="font-size:14px;"><img src="https://staticsite.quickapi.net/data/newFiles/20260116/20260116163806LhXs355.png" alt="" /><br />
</span>
</p>
<p>
<br />
</p>
<span style="font-size:14px;">Android/asstes/quickgame_sdk/qg_ipconfig</span><br />
<span style="font-size:14px;">SDK域名配置文件,若是部署版cp,请复制域名地址api到此文件</span><br />
<br />
<span style="font-size:14px;">MyAndroidMessageSubsystem</span><br />
<span style="font-size:14px;">常规作为广播消息给UE蓝图Widget</span><br />
<span style="font-size:14px;">struct FQuickGamePayInfo 封装订单对象</span><br />
<p>
<span style="font-size:14px;">struct FQuickGameRoleInfo 封装角色对象</span>
</p>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<span style="font-size:14px;">QuickGameHelper</span><br />
<p>
<span style="font-size:14px;">封装的sdk方法</span>
</p>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<span style="font-size:14px;">QuickSDK_UPL.xml</span><br />
<p>
<span style="font-size:14px;color:#E53333;"><strong>常规注入android代码及依赖,后续如果新增额外接口及第三方依赖可在此添加,参照java文档</strong></span>
</p>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<p>
<br />
</p>
<p>
<br />
</p>
<h3>
<span style="font-size:16px;">三、SDK必接接口</span>
</h3>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<h4>
<span style="font-size:14px;">1. 初始化</span>
</h4>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<p>
<span style="font-size:14px;">QuickGameHelper ::GetInstance()->initSDK("SDK product_code");</span>
</p>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<h4>
<span style="font-size:14px;">2. 登录</span>
</h4>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<p>
<span style="font-size:14px;">QuickGameHelper ::GetInstance()->login();</span>
</p>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<h4>
<span style="font-size:14px;">3. 角色信息</span>
</h4>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<p>
<span style="font-size:14px;">角色Ustrut FQuickGameRoleInfo详解(<span style="white-space:normal;font-size:14px;color:#E53333;"><strong>均为必传参数</strong></span>):</span>
</p>
<p>
<span style="font-size:14px;">
<table style="width:1000px;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000">
<tbody>
<tr>
<td>
<span style="white-space:normal;font-size:14px;">属性名</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">类型</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">释义</span><br />
</td>
</tr>
<tr>
<td>
<span style="white-space:normal;font-size:14px;">RoleId</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">String</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">角色id</span><br />
</td>
</tr>
<tr>
<td>
<span style="white-space:normal;font-size:14px;">RoleName</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">String</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">角色名</span><br />
</td>
</tr>
<tr>
<td>
<span style="white-space:normal;font-size:14px;">ServerId</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">String</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">区服id</span><br />
</td>
</tr>
<tr>
<td>
<span style="white-space:normal;font-size:14px;">ServerName</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">String</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">区服名</span><br />
</td>
</tr>
<tr>
<td>
<span style="white-space:normal;font-size:14px;">RoleLevel</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">String</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">角色等级</span><br />
</td>
</tr>
<tr>
<td>
<span style="white-space:normal;font-size:14px;">VipLevel</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">String</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">vip等级</span><br />
</td>
</tr>
<tr>
<td>
<span style="white-space:normal;font-size:14px;">RoleBanlance</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">String</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">角色余额</span><br />
</td>
</tr>
<tr>
<td>
<span style="white-space:normal;font-size:14px;">PartyName</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">String</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">工会名</span><br />
</td>
</tr>
<tr>
<td>
<span style="white-space:normal;font-size:14px;">RolePower</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">String</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">战斗力</span><br />
</td>
</tr>
</tbody>
</table>
</span>
</p>
<br />
<p>
<span style="font-size:14px;">QuickGameHelper::GetInstance()->setGameRoleInfo(RoleInfo);</span>
</p>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<h4>
<span style="font-size:14px;">4. 支付</span>
</h4>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<p>
<span style="font-size:14px;">订单Ustrut FQuickGamePayInfo详解:</span>
</p>
<p>
<span style="font-size:14px;">
<table style="width:1000px;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000">
<tbody>
<tr>
<td>
<span style="white-space:normal;font-size:14px;">属性名</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">类型</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">释义</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">是否必传</span><br />
</td>
</tr>
<tr>
<td>
<span style="white-space:normal;font-size:14px;">OrderSubject</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">String</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">商品名称</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">是</span><br />
</td>
</tr>
<tr>
<td>
<span style="white-space:normal;font-size:14px;">ProductOrderId</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">String</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">游戏生成的唯一订单号</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">是</span><br />
</td>
</tr>
<tr>
<td>
<span style="white-space:normal;font-size:14px;">ExtrasParams</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">String</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">透传参数请勿传特殊符号,如果无法避免建议进行base64编码</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">否</span><br />
</td>
</tr>
<tr>
<td>
<span style="white-space:normal;font-size:14px;">GoodsId</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">String</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">商品id</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">是</span><br />
</td>
</tr>
<tr>
<td>
<span style="white-space:normal;font-size:14px;">Amount</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">Double</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">商品金额</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">是</span><br />
</td>
</tr>
<tr>
<td>
<span style="white-space:normal;font-size:14px;">PayParam</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">String</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">商品描述</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;">是</span><br />
</td>
</tr>
</tbody>
</table>
</span>
</p>
<br />
<p>
<span style="font-size:14px;">QuickGameHelper::GetInstance()->pay(RoleInfo,PayInfo);</span>
</p>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<h4>
<span style="font-size:14px;">5. 注销</span>
</h4>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<p>
<span style="font-size:14px;">QuickGameHelper ::GetInstance()->logout() ;</span>
</p>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<h4>
<span style="font-size:14px;">6. 退出</span>
</h4>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<p>
<span style="font-size:14px;">QuickGameHelper ::GetInstance()->exit() ;</span>
</p>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<h4>
<span style="font-size:14px;">7. 获取渠道标识</span>
</h4>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<p>
<span style="font-size:14px;">QuickGameHelper ::GetInstance()->getChannelType() ;</span>
</p>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<p>
<br />
</p>
<p>
<br />
</p>
<h3>
<span style="font-size:16px;">四、SDK回调</span>
</h3>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<p>
<span style="font-size:14px;color:#E53333;"><strong><br />
</strong></span>
</p>
<p>
<span style="font-size:14px;color:#E53333;"><strong>请参照QuickSDK_UPL与GameHelper处理对应逻辑</strong></span>
</p>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<h4>
<span style="font-size:14px;">1. 初始化</span>
</h4>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<span style="font-size:14px;">JNI_METHOD void Java_com_epicgames_unreal_GameActivity_initSuccessed</span><br />
<p>
<span style="font-size:14px;">JNI_METHOD void Java_com_epicgames_unreal_GameActivity_initFailed</span>
</p>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<br />
<h4>
<span style="font-size:14px;">2. 登录</span>
</h4>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<span style="font-size:14px;">JNI_METHOD void Java_com_epicgames_unreal_GameActivity_loginSuccessed</span><br />
<span style="font-size:14px;">JNI_METHOD void Java_com_epicgames_unreal_GameActivity_loginFailed</span><br />
<p>
<span style="font-size:14px;"> </span>
</p>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<h4>
<span style="font-size:14px;">3. 支付</span>
</h4>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<span style="font-size:14px;">JNI_METHOD void Java_com_epicgames_unreal_GameActivity_paySuccessed</span><br />
<span style="font-size:14px;">JNI_METHOD void Java_com_epicgames_unreal_GameActivity_payFailed</span><br />
<p>
<span style="font-size:14px;"> </span>
</p>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<h4>
<span style="font-size:14px;">4. 注销</span>
</h4>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<span style="font-size:14px;">JNI_METHOD void Java_com_epicgames_unreal_GameActivity_logoutSuccessed</span><br />
<span style="font-size:14px;">JNI_METHOD void Java_com_epicgames_unreal_GameActivity_logoutFailed</span><br />
<p>
<br />
</p>
<p>
<br />
</p>
<h4>
<span style="font-size:14px;">5. 退出</span>
</h4>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<span style="font-size:14px;">JNI_METHOD void Java_com_epicgames_unreal_GameActivity_exitSuccessed</span><br />
<span style="font-size:14px;">JNI_METHOD void Java_com_epicgames_unreal_GameActivity_exitFailed</span><br />
<p>
<br />
</p>
<p>
<br />
</p>
<h4>
<span style="font-size:14px;">6. 获取渠道标识</span>
</h4>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<span style="font-size:14px;">JNI_METHOD void Java_com_epicgames_unreal_GameActivity_getChannelType</span><br />
<span style="font-size:14px;"></span>