QuickSDK
官方SDK系统-海外版

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

一、接入配置



1.1 Unity配置


勾选下图配置，在 Assets/Plugins/Android 目录下生成 mainTemplate.gradle 文件


unity2018 版本


unity2020 版本



1.2 拷贝SDK 资源


拷贝下列文件到 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目录，请看《Unity 2021添加assets & res说明》


拷贝 Unity SDK Resources/script 中的文件到 Unity 项目的 Assets/Plugins/script 目录:

导入 Unity SDK Resources/JsonNet.9.0.1.unitypackage 到 Unity 项目



1.3 修改 mainTemplate.gradle 文件


在 dependencies 里面添加如下代码

1
2
3
4
5
6
7
8
9
10
11
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'
}



1.4 AndroidManifest 配置


1. AndroidManifest 在 Assets/Plugins/Android 目录，在 AndroidManifest 的 application 节点下添加如下代码


1
2
<!--value值的格式为 QK+quick sdk后台的ProductCode-->
<meta-data android:name="QKproductCode" android:value="QK{这里替换为SDK的ProductCode，包括大括号}"></meta-data>



2. 删掉 AndroidManifest 中配置的主 Activity，即 activity 的 中包含如下代码


1
<category android:name="android.intent.category.LAUNCHER"></category>



3. 添加 Google 登录配置（按需配置）


1
2
<!--没有Google登录可以不加，value值直接写在这里，不能用@string引用-->
<meta-data  android:name="google-signin-client_id"  android:value="替换为google后台申请的clientid"></meta-data>



1.5 gradle.properties 配置 （Unity 2020）


gradle.properties 对应 Assets/Plugins/AndroidgradleTemplate.properties 文件，在gradle.properties 里面添加


1
2
android.useAndroidX=true
android.enableJetifier=true



1.6 修改闪屏方向


闪屏默认是横屏，如果要修改闪屏方向，在AndroidManifest里面添加下面的Activity配置修改 android:screenOrientation 的值

1
2
3
4
5
6
7
<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">
  </category></action></intent-filter>
  <meta-data     android:name="unityplayer.UnityActivity"     android:value="true">
</meta-data></activity>






二、接口调用



添加 quicksdk 的命名空间 using quicksdk

如下方法获取 SDK 实例，SDK 接口都通过该实例调用


1
QuickSDK.getInstance()



2.1 设置监听器


调用方法

1
public void setListener(QuickSDKListener quickSDKListener )


示例

参考 Unity Demo/Assets/demo/EventHandle.cs 文件
注： onLoginFailed 回调包括登录取消和登录失败
可以通过ErrorMsg的code来区分，code为 2 表示登录取消，为 3 是登录失败



2.2 初始化


调用方法

1
public void init()


示例

1
QuickSDK.getInstance().init();



2.3 登录


调用方法

1
public void login()


示例

1
QuickSDK.getInstance().login();


静默登录可以调用下面的方法

1
public void freeLogin()


2.4 上报角色信息


调用方法

1
public void updateRole(GameRoleInfo gameRoleInfo)


GameRoleInfo

字段
 类型
 说明
serverID
 String
 服务器 ID
serverName
 String
 服务器名称
gameRoleName
 String
 角色名称
gameRoleID
 String
 角色 ID
vipLevel
 String
 角色 VIP 等级
gameRoleLevel
 String
 角色等级


 

2.5 支付


1
public void pay (OrderInfo orderInfo, GameRoleInfo gameRoleInfo)



OrderInfo

字段
 类型
 说明
skuType
 String
 商品类型，默认消耗性（inapp），订阅请设置为 subs
goodsID
 String
 商品 ID，用来识别购买的产品
goodsDesc
 String
 商品名称
amount
 double
 支付金额
currency
 String
 支付金额单位（如 USD、CNY）
cpOrderID
 String
 游戏方的订单号
extrasParams
 String
 透传参数
请勿传特殊符号，如果无法避免建议进行 base64 编码
callBackUrl
 String
 支付回调地址
可选参数，可配置在后台；优先读取后台配置的回调地址



2.6 退出登录


1
public void logout()



2.7 显示个人中心


1
public void userCenter()



2.8 获取uid


可以在登录之后再次获取Uid，如果没有登录返回空字符串

1
public string getUserId()



2.9 销毁账号


1
public void userTrash()



三、其他接口


3.1 绑定账号接口（按需接入）


如果游戏内有按钮，需要绑定第三方账号可以调用此接口
若指定类型未绑定，调用会走绑定流程；若已经绑定用户，调用该方法则为解绑账

接收绑定结果需要重写 QuickSDKListener 中的 onBindUnbindUserSuccess 和 onBindUnbindUserFailed


1
public void bindUser(string bindType)


bindType 要绑定的类型，详细见下表

绑定/解绑类型
 类型参数（数字字符串）
FaceBook
 6
Google
 8
Naver
 9
Line
 11
Email
 13
VK
 14
PlayGame
 17

成都惜东网络科技有限公司

Copyright ©2015-2022 All Rights Reserved  |  成都惜东网络科技有限公司  |  蜀ICP备2022015064号-6  |  隐私条款  |  服务条款
川公网安备 51015602000366号川公网安备 51015602000366号

商务合作

李先生：13880511661

QQ:48157910

市场合作

赵先生：15390049857

QQ:1077535763

技术支持

孙女士：13551010407

QQ:1799614139

官方技术交流群

QQ群：698731538