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

更新日期：2024年 12月 24日海外版Unity 接入文档

<h3> 一、接入配置 </h3> <h4> 1.1 Unity配置 </h4> 勾选下图配置，在 Assets/Plugins/Android 目录下生成 mainTemplate.gradle 文件 unity2018 版本 <img src="https://staticsite.quickapi.net/data/newFiles/20241224/20241224101639MXrE652.png" alt="" /> unity2020 版本 <img src="https://staticsite.quickapi.net/data/newFiles/20241224/20241224101649XbHi578.png" alt="" /> <h4> 1.2 拷贝SDK 资源 </h4> 拷贝下列文件到 Assets/Plugins/Android 目录： Unity SDK Resources/quickgame_hw_x.x.x.aar （x.x.x 为具体版本） Unity SDK Resources/unity_imp_libs-release.aar 拷贝Unity SDK Resources/QHinfo 到 Assets/Plugins/Android/assets 目录: 将游戏的域名（需要解析到quick提供的ip）写入 QHinfo 文件中（使用文本编辑器打开写入） 例如：域名为api.xxx.com，QHinfo文件中写入的是 http://api.xxx.com ；如果使用了https则为 https://api.xxx.com Unity 2021不支持assets目录，请看<a href="https://www.quicksdk.com/doc-1127.html?cid=45" target="_blank">《Unity 2021添加assets & res说明》</a> 拷贝 Unity SDK Resources/script 中的文件到 Unity 项目的 Assets/Plugins/script 目录: 导入 Unity SDK Resources/JsonNet.9.0.1.unitypackage 到 Unity 项目 <h4> 1.3 修改 mainTemplate.gradle 文件 </h4> 在 dependencies 里面添加如下代码 <pre class="brush:js;toolbar:false">dependencies { //必需依赖的库 api 'androidx.appcompat:appcompat:1.3.0' api "org.jetbrains.kotlin:kotlin-stdlib:1.4.10" api 'com.android.billingclient:billing:7.0.0' //根据需求添加的依赖库 //添加后sdk会获取adid api 'com.google.android.gms:play-services-ads-identifier:17.0.1' // 使用google登录需要添加 api 'com.google.android.gms:play-services-auth:19.0.0' }</pre> <h4> 1.4 AndroidManifest 配置 </h4> 1. AndroidManifest 在 Assets/Plugins/Android 目录，在 AndroidManifest 的 application 节点下添加如下代码 <pre class="brush:js;toolbar:false"> <meta-data android:name="QKproductCode" android:value="QK{这里替换为SDK的ProductCode，包括大括号}"/></pre> 2. 删掉 AndroidManifest 中配置的主 Activity，即 activity 的 <intent-filter> 中包含如下代码 <pre class="brush:js;toolbar:false"><category android:name="android.intent.category.LAUNCHER" /></pre> 3. 添加 Google 登录配置（按需配置） <pre class="brush:js;toolbar:false"> <meta-data  android:name="google-signin-client_id"  android:value="替换为google后台申请的clientid"/></pre> <h4> 1.5 gradle.properties 配置（Unity 2020） </h4> gradle.properties 对应 Assets/Plugins/AndroidgradleTemplate.properties 文件，在gradle.properties 里面添加 <pre class="brush:js;toolbar:false">android.useAndroidX=true android.enableJetifier=true</pre> <h4> 1.6 修改闪屏方向 </h4> 闪屏默认是横屏，如果要修改闪屏方向，在AndroidManifest里面添加下面的Activity配置修改 android:screenOrientation 的值 <pre class="brush:js;toolbar:false"><activity   android:name="com.qk.unity.QuickUnityPlayerProxyActivity"   android:configChanges="fontScale|orientation|keyboardHidden|locale|navigation|screenSize|uiMode"   tools:replace="android:screenOrientation,android:configChanges"   android:screenOrientation="portrait"   android:exported="true">   <intent-filter>     <action android:name="android.intent.action.MAIN" />     <category android:name="android.intent.category.LAUNCHER" />   </intent-filter>   <meta-data     android:name="unityplayer.UnityActivity"     android:value="true" /> </activity></pre> <h3> 二、接口调用 </h3> 添加 quicksdk 的命名空间 using quicksdk 如下方法获取 SDK 实例，SDK 接口都通过该实例调用 <pre class="brush:js;toolbar:false">QuickSDK.getInstance()</pre> <h4> 2.1 设置监听器 </h4> 调用方法 <pre class="brush:js;toolbar:false">public void setListener(QuickSDKListener quickSDKListener )</pre> 示例 参考 Unity Demo/Assets/demo/EventHandle.cs 文件 注： onLoginFailed 回调包括登录取消和登录失败 可以通过ErrorMsg的code来区分，code为 2 表示登录取消，为 3 是登录失败 <h4> 2.2 初始化 </h4> 调用方法 <pre class="brush:js;toolbar:false">public void init()</pre> 示例 <pre class="brush:js;toolbar:false">QuickSDK.getInstance().init();</pre> <h4> 2.3 登录 </h4> 调用方法 <pre class="brush:js;toolbar:false">public void login()</pre> 示例 <pre class="brush:js;toolbar:false">QuickSDK.getInstance().login();</pre> 静默登录可以调用下面的方法 <pre class="brush:js;toolbar:false">public void freeLogin()</pre> <h4> 2.4 上报角色信息 </h4> 调用方法 <pre class="brush:js;toolbar:false">public void updateRole(GameRoleInfo gameRoleInfo)</pre> GameRoleInfo <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 字段 </td> <td> 类型 </td> <td> 说明 </td> </tr> <tr> <td> serverID </td> <td> String </td> <td> 服务器 ID </td> </tr> <tr> <td> serverName </td> <td> String </td> <td> 服务器名称 </td> </tr> <tr> <td> gameRoleName </td> <td> String </td> <td> 角色名称 </td> </tr> <tr> <td> gameRoleID </td> <td> String </td> <td> 角色 ID </td> </tr> <tr> <td> vipLevel </td> <td> String </td> <td> 角色 VIP 等级 </td> </tr> <tr> <td> gameRoleLevel </td> <td> String </td> <td> 角色等级 </td> </tr> </tbody> </table>   <h4> 2.5 支付 </h4> <pre class="brush:js;toolbar:false">public void pay (OrderInfo orderInfo, GameRoleInfo gameRoleInfo)</pre> OrderInfo <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 字段 </td> <td> 类型 </td> <td> 说明 </td> </tr> <tr> <td> skuType </td> <td> String </td> <td> 商品类型，默认消耗性（inapp），订阅请设置为 subs </td> </tr> <tr> <td> goodsID </td> <td> String </td> <td> 商品 ID，用来识别购买的产品 </td> </tr> <tr> <td> goodsDesc </td> <td> String </td> <td> 商品名称 </td> </tr> <tr> <td> amount </td> <td> double </td> <td> 支付金额 </td> </tr> <tr> <td> currency </td> <td> String </td> <td> 支付金额单位（如 USD、CNY） </td> </tr> <tr> <td> cpOrderID </td> <td> String </td> <td> 游戏方的订单号 </td> </tr> <tr> <td> extrasParams </td> <td> String </td> <td> 透传参数 请勿传特殊符号，如果无法避免建议进行 base64 编码 </td> </tr> <tr> <td> callBackUrl </td> <td> String </td> <td> 支付回调地址 可选参数，可配置在后台；优先读取后台配置的回调地址 </td> </tr> </tbody> </table> <h4> 2.6 退出登录 </h4> <pre class="brush:js;toolbar:false">public void logout()</pre> <h4> 2.7 显示个人中心 </h4> <pre class="brush:js;toolbar:false">public void userCenter()</pre> <h4> 2.8 获取uid </h4> 可以在登录之后再次获取Uid，如果没有登录返回空字符串 <pre class="brush:js;toolbar:false">public string getUserId()</pre> <h4> 2.9 销毁账号 </h4> <pre class="brush:js;toolbar:false">public void userTrash()</pre> <h3> 三、其他接口 </h3> <h4> 3.1 绑定账号接口（按需接入） </h4> 如果游戏内有按钮，需要绑定第三方账号可以调用此接口 若指定类型未绑定，调用会走绑定流程；若已经绑定用户，调用该方法则为解绑账 接收绑定结果需要重写 QuickSDKListener 中的 onBindUnbindUserSuccess 和 onBindUnbindUserFailed <pre class="brush:js;toolbar:false">public void bindUser(string bindType)</pre> bindType 要绑定的类型，详细见下表 <table style="width:100%;" cellpadding="2" cellspacing="0" border="1" bordercolor="#000000"> <tbody> <tr> <td> 绑定/解绑类型 </td> <td> 类型参数（数字字符串） </td> </tr> <tr> <td> FaceBook </td> <td> 6 </td> </tr> <tr> <td> Google </td> <td> 8 </td> </tr> <tr> <td> Naver </td> <td> 9 </td> </tr> <tr> <td> Line </td> <td> 11 </td> </tr> <tr> <td> Email </td> <td> 13 </td> </tr> <tr> <td> VK </td> <td> 14 </td> </tr> <tr> <td> PlayGame </td> <td> 17 </td> </tr> </tbody> </table>