文档中心 | 一键联接，全心服务

更新日期：2025年 02月 13日PC游戏Unity接入文档

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