更新日期:2025年 01月 16日海外版PC游戏Unity接入文档
<h3>
<span style="font-size:16px;color:#000000;"> 一、接入配置</span><span style="white-space:pre;"> </span><span style="font-size:14px;color:#000000;"> </span>
</h3>
<p>
<br />
<span style="font-size:14px;"><br />
</span>
</p>
<h4>
<span style="font-size:14px;color:#000000;">1.1 导入资源</span><span style="white-space:pre;"> </span><span style="font-size:14px;color:#000000;"> </span>
</h4>
<p>
<br />
<span style="font-size:14px;color:#000000;">在unity项目内导入QuickPCxxx.unitypackage</span><br />
<span style="font-size:14px;color:#000000;">Unity菜单栏 Assets --> Import Package --> Custom Package 选择下载的QuickPCxxx.unitypackage</span>
</p>
<p>
<br />
<span style="font-size:14px;"><br />
</span>
</p>
<h4>
<span style="font-size:14px;color:#000000;">1.2 参数配置</span><span style="white-space:pre;"> </span><span style="font-size:14px;color:#000000;"> </span>
</h4>
<p>
<br />
<span style="font-size:14px;color:#000000;">导入成功后,Unity的菜单栏会新增QuickSDK按钮,点击可以设置参数</span>
</p>
<p>
<span style="font-size:14px;color:#000000;">BaseUrl为域名地址</span>
</p>
<p>
<span style="font-size:14px;color:#000000;">Product Code在SDK后台创建</span>
</p>
<p>
<span style="font-size:14px;color:#000000;">其他为选填参数:显示任务栏状态,填1时显示;loading样式Style,填1为深色,2为浅色</span>
</p>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<p>
<img src="https://staticsite.quickapi.net/data/newFiles/20241224/20241224140159SWaU806.jpg" alt="" />
</p>
<p>
<span style="font-size:14px;color:#000000;"> </span>
</p>
<p>
<br />
</p>
<p>
<br />
</p>
<h3>
<span style="font-size:16px;color:#000000;">二、接口调用</span><span style="white-space:pre;"> </span><span style="font-size:16px;color:#000000;"> </span>
</h3>
<p>
<br />
</p>
<p>
<br />
<span style="font-size:14px;color:#000000;">添加 quicksdk 的命名空间using quicksdk</span><br />
<span style="font-size:14px;color:#000000;">如下方法获取 SDK 实例,SDK 接口都通过该实例调用</span>
</p>
<pre class="brush:js;toolbar:false">QuickSDK.getInstance()</pre>
<p>
<br />
</p>
<p>
<br />
<span style="font-size:14px;color:#000000;"> </span>
</p>
<h4>
<span style="font-size:14px;color:#000000;">2.1 设置监听器</span><span style="white-space:pre;"> </span><span style="font-size:14px;color:#000000;"> </span>
</h4>
<p>
<br />
</p>
<p>
<br />
<span style="font-size:14px;color:#000000;">用于接收初始化、登录结果的监听回调</span><br />
<span style="font-size:14px;color:#000000;">调用方法</span>
</p>
<pre class="brush:js;toolbar:false">public void setListener(QuickSDKListener quickSDKListener )</pre>
<br />
<span style="font-size:14px;color:#000000;"> </span><br />
<span style="font-size:14px;color:#000000;">示例</span>
<p>
<br />
<span style="font-size:14px;color:#000000;">参考Unity Demo/Assets/demo/EventHandle.cs文件</span><br />
<span style="font-size:14px;color:#000000;">注:onLoginFailed回调包括登录取消和登录失败</span><br />
<span style="font-size:14px;color:#000000;">可以通过ErrorMsg的code来区分,code为2表示登录取消,为3是登录失败</span>
</p>
<p>
<br />
</p>
<p>
<br />
</p>
<h4>
<span style="font-size:14px;color:#000000;">2.2</span><span style="white-space:pre;"> </span><span style="font-size:14px;color:#000000;">初始化</span><span style="white-space:pre;"> </span><span style="font-size:14px;color:#000000;"> </span>
</h4>
<p>
<br />
</p>
<p>
<br />
</p>
<p>
<span style="font-size:14px;color:#000000;">调用方法</span>
</p>
<pre class="brush:js;toolbar:false">public void init()</pre>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<p>
<span style="font-size:14px;color:#000000;"> 示例</span>
</p>
<pre class="brush:js;toolbar:false">QuickSDK.getInstance().init();</pre>
<span style="font-size:14px;color:#000000;"> 以下接口都需要在初始化成功之后调用</span><br />
<p>
<br />
</p>
<p>
<br />
</p>
<h4>
<span style="font-size:14px;color:#000000;">2.3</span><span style="white-space:pre;"> </span><span style="font-size:14px;color:#000000;">登录</span>
</h4>
<p>
<br />
</p>
<p>
<br />
</p>
<p>
<span style="font-size:14px;color:#000000;">调用方法</span>
</p>
<pre class="brush:js;toolbar:false">public void login()</pre>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<p>
<span style="font-size:14px;color:#000000;"> 示例</span>
</p>
<pre class="brush:js;toolbar:false">QuickSDK.getInstance().login();</pre>
<br />
<span style="font-size:14px;color:#000000;"> </span><br />
<h4>
<span style="font-size:14px;color:#000000;">2.4 上报角色信息</span>
</h4>
<p>
<br />
</p>
<p>
<br />
</p>
<p>
<span style="font-size:14px;color:#000000;">调用方法</span>
</p>
<pre class="brush:js;toolbar:false">public void updateRole(GameRoleInfo gameRoleInfo)</pre>
<br />
<span style="font-size:14px;color:#000000;"> </span><br />
<span style="font-size:14px;color:#000000;">GameRoleInfo</span>
<p>
<table cellpadding="2" cellspacing="0" border="1" bordercolor="#000000" style="width:1011px;">
<tbody>
<tr>
<td>
<span style="font-size:14px;color:#000000;">字段</span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;">类型</span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;">必要性</span>
</td>
<td>
<span style="font-size:14px;color:#000000;">说明</span><br />
</td>
</tr>
<tr>
<td>
<span style="font-size:14px;color:#000000;">serverID</span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;">String</span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;">必传</span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;">服务器 ID</span><br />
</td>
</tr>
<tr>
<td>
<span style="font-size:14px;color:#000000;">serverName</span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;">String</span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;">必传</span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;">服务器名称</span><br />
</td>
</tr>
<tr>
<td>
<span style="white-space:normal;font-size:14px;color:#000000;">gameRoleID</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;color:#000000;">String</span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;">必传</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;color:#000000;">角色 ID</span><br />
</td>
</tr>
<tr>
<td>
<span style="font-size:14px;color:#000000;">gameRoleName</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;color:#000000;">String</span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;">必传</span><br />
</td>
<td>
<span style="font-size:14px;"></span><span style="font-size:14px;color:#000000;">角色名称</span><span style="font-size:14px;"></span><br />
</td>
</tr>
<tr>
<td>
<span style="font-size:14px;color:#000000;">vipLevel</span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;">String</span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;">选传</span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;">角色 VIP 等级</span><br />
</td>
</tr>
<tr>
<td>
<span style="font-size:14px;color:#000000;">gameRoleLevel</span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;">String</span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;">必传</span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;">角色等级</span>
</td>
</tr>
<tr>
<td>
<span style="font-size:14px;color:#000000;">partyId</span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;">string</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;color:#000000;">选传</span><span style="white-space:normal;"></span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;">帮派id</span><br />
</td>
</tr>
<tr>
<td>
<span style="font-size:14px;color:#000000;">partyName</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;color:#000000;">string</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;color:#000000;">选传</span><span style="white-space:normal;"></span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;">公会社团名称</span><br />
</td>
</tr>
<tr>
<td>
<p>
<span style="font-size:14px;color:#000000;">roleBalance</span>
</p>
</td>
<td>
<span style="white-space:normal;font-size:14px;color:#000000;">string</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;color:#000000;">选传</span><span style="white-space:normal;"></span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;">角色用户余额</span><br />
</td>
</tr>
</tbody>
</table>
</p>
<p>
<br />
</p>
<p>
<br />
</p>
<h4>
<span style="font-size:14px;color:#000000;">2.5 支付</span><span style="white-space:pre;"> </span><span style="font-size:14px;color:#000000;"> </span>
</h4>
<p>
<br />
</p>
<p>
<br />
</p>
<pre class="brush:js;toolbar:false">public void pay (OrderInfo orderInfo, GameRoleInfo gameRoleInfo)</pre>
<br />
<span style="font-size:14px;color:#000000;"> </span><br />
<span style="font-size:14px;color:#000000;">OrderInfo</span>
<p>
<table cellpadding="2" cellspacing="0" border="1" bordercolor="#000000" style="width:1011px;">
<tbody>
<tr>
<td>
<span style="font-size:14px;color:#000000;">字段</span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;">类型</span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;">必要性</span>
</td>
<td>
<span style="font-size:14px;color:#000000;">说明</span><br />
</td>
</tr>
<tr>
<td>
<span style="font-size:14px;color:#000000;"><span style="white-space:normal;font-size:14px;color:#000000;">goodsID</span></span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;">String</span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;">必传</span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;"><span style="white-space:normal;font-size:14px;color:#000000;">商品 ID,用来识别购买的产品</span></span><br />
</td>
</tr>
<tr>
<td>
<span style="font-size:14px;color:#000000;"><span style="white-space:normal;font-size:14px;color:#000000;">goodsName</span></span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;">String</span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;">必传</span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;"><span style="white-space:normal;font-size:14px;color:#000000;">商品名称</span></span><br />
</td>
</tr>
<tr>
<td>
<span style="font-size:14px;color:#000000;"><span style="white-space:normal;font-size:14px;color:#000000;">goodsDesc</span></span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;">String</span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;">必传</span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;"><span style="white-space:normal;font-size:14px;color:#000000;">商品描述</span></span><br />
</td>
</tr>
<tr>
<td>
<span style="font-size:14px;color:#000000;"><span style="white-space:normal;font-size:14px;color:#000000;">amount</span></span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;color:#000000;">double</span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;">必传</span><br />
</td>
<td>
<span style="white-space:normal;font-size:14px;color:#000000;">支付金额,单位 美元</span><br />
</td>
</tr>
<tr>
<td>
<span style="font-size:14px;color:#000000;"><span style="white-space:normal;font-size:14px;color:#000000;">cpOrderID</span></span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;">String</span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;">必传</span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;"><span style="white-space:normal;font-size:14px;color:#000000;">游戏方的订单号</span></span><br />
</td>
</tr>
<tr>
<td>
<span style="font-size:14px;">clientLang</span><span style="font-size:14px;"></span><br />
</td>
<td>
<span style="font-size:14px;">string</span><span style="font-size:14px;"></span><br />
</td>
<td>
<span style="font-size:14px;">必传</span><span style="font-size:14px;"></span><br />
</td>
<td>
<span style="font-size:14px;">支付中心语言包,填写地区语言代码,如en-US。默认为中文繁体</span><span style="font-size:14px;"></span><br />
</td>
</tr>
<tr>
<td>
<span style="font-size:14px;color:#000000;"><span style="white-space:normal;font-size:14px;color:#000000;">extrasParams</span></span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;">String</span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;">选传</span><br />
</td>
<td>
<p>
<span style="font-size:14px;color:#000000;">透传参数</span>
</p>
<p>
<span style="font-size:14px;color:#000000;">请勿传特殊符号,如果无法避免建议进行 base64 编码</span>
</p>
</td>
</tr>
<tr>
<td>
<span style="white-space:normal;font-size:14px;color:#000000;">callBackUrl</span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;">string</span><br />
</td>
<td>
<span style="font-size:14px;color:#000000;">选传</span><br />
</td>
<td>
<p>
<span style="font-size:14px;"></span><span style="white-space:normal;font-size:14px;color:#000000;">支付回调地址</span><span style="font-size:14px;"></span>
</p>
<p>
<span style="white-space:normal;font-size:14px;color:#000000;">可选参数,可配置在后台;优先读取后台配置的回调地址</span><span style="font-size:14px;"></span>
</p>
</td>
</tr>
</tbody>
</table>
</p>
<p>
<br />
</p>
<p>
<br />
</p>
<h4>
<span style="font-size:14px;color:#000000;">2.6 退出登录</span>
</h4>
<p>
<br />
</p>
<p>
<br />
</p>
<pre class="brush:js;toolbar:false">public void logout()</pre>
<br />
<span style="font-size:14px;color:#000000;"> </span><br />
<h4>
<span style="font-size:14px;color:#000000;">2.7 显示个人中心</span>
</h4>
<p>
<br />
</p>
<p>
<br />
</p>
<pre class="brush:js;toolbar:false">public void userCenter()</pre>
<p>
<br />
</p>
<p>
<span style="font-size:14px;"><br />
</span>
</p>
<h4>
<span style="font-size:14px;color:#000000;">2.8 获取uid</span>
</h4>
<p>
<br />
</p>
<p>
<br />
</p>
<p>
<span style="font-size:14px;color:#000000;">可以在登录之后再次获取Uid,如果没有登录返回空字符串</span>
</p>
<pre class="brush:js;toolbar:false">public string getUserId()</pre>
<span style="font-size:14px;"></span>
<p>
<br />
</p>
<p>
<span style="font-size:14px;color:#000000;"> </span>
</p>
<div style="white-space:nowrap;">
<br />
</div>
<p>
<br />
</p>