QuickSDK
  • 首页
  • 产品与服务
    聚合SDK工具

    聚合2000余家渠道的SDK出包工具,一次接入,批量出包,全渠道上架

    QuickSDK部署版

    本地化部署,数据独立存储,渠道资源共享公共版更新

    国内发行工具

    QuickGame SDK国内版助力手游开发商快速拥有自主发行的能力。

    海外发行工具

    QuickGame SDK海外版帮助发行商快速搭建海外自主发行平台。

    QuickAD+ 广告追踪工具

    检测广告效果,提供结算依据,优化投放策略为用户提供真实的广告监测数据

    玩家维护系统

    游戏客服服务、重度玩家跟踪、玩家情感分析、提升玩家忠诚度和参与度。

  • 开发者中心
    文档中心 下载中心 渠道列表 功能索引
  • 资讯动态
  • 商务合作
  • 关于我们
    公司介绍 人才招聘
  • 隐私政策
简体中文
简体中文 繁體中文 English
登录 注册
SDK聚合工具
  • 新手指南
  • 后台使用手册
  • SDK接入文档
    • 服务器接入文档
    • Java(Android)接入文档
    • Objective-C(iOS)接入文档
    • Unity3D接入文档
    • Unreal Engine(Android)接入文档
    • H5游戏接入文档(微端和网页)
    • QuickSDK开放平台接入文档
    • 隐私协议及权限说明
    • 登录、支付流程图
  • 母包自测用例
    • 母包自测用例 - Android
    • 母包自测用例 - iOS
  • 渠道配置说明
    • 五大渠道
    • 硬核渠道
    • 其他渠道
    • Quickgame(官方SDK)渠道
  • H5和工具使用手册
    • Android打包工具
    • iOS打包工具
    • 渠道插件使用说明
    • H5游戏上架Android或越狱渠道后台配置流程
    • H5游戏上架H5渠道后台配置流程
    • Android签名证书的创建方法
    • iOS证书和通用签名的创建方法
    • iOS如何创建推送证书以及生成pem证书
  • 关键指标说明
    • 运营数据术语定义及说明
    • 运营数据平台使用手册
    • 深度挖掘服务使用手册
  • FAQ
    • 接入问题
    • 打包问题
    • 上架测试
    • 出包错误

更新日期:2026-02-13Unity3D接入文档

1.unity部分


1.1. 导入SDK资源

请先到"下载中心",下载“QuickSDK For Unity 3D”版本的SDK包。将其中的QuickSDKForUnity.unitypackage文件导入到Unity工程里面(如果无法导入,请再次确认文件是放置于非中文路径下的),如下图所示:

1.2. 调用QuickSDK接口

注: 调用QuickSDK.cs类的接口,并实现其回调方法

需要先添加quicksdk的命名空间(using quicksdk;),并通过 QuickSDK.getInstance( ) 方法获取QuickSDK类的实例

1.2.1. 设置监听器(必接)

接口:void setListener(QuickSDKListener quickSDKListener )

案例:调用QuickSDK.getInstance().setListener函数,其参数传入实例化的QuickSDKListener类对象。setListener函数请尽可能早的设置,便于监听回调。

脚本需要实现的回调请参考以下代码:

public class EventHandle : QuickSDKListener {
   void Start () {
       QuickSDK.getInstance().setListener (this);
   }
   public override void onInitSuccess(){
       //初始化成功的回调
   }
   public override void onInitFailed(ErrorMsg errMsg){
       //初始化失败的回调
   }
   public override void onLoginSuccess (UserInfo userInfo){
       //登录成功的回调
   }
   public override void onLoginFailed (ErrorMsg errMsg){
       //登录失败的回调
       //如果游戏没有登录按钮,应在这里再次调用登录接口
   }
   public override void onSwitchAccountSuccess (UserInfo userInfo){
       //切换账号成功的回调
       //一些渠道在悬浮框有切换账号的功能,此回调即切换成功后的回调。游戏应清除当前的游戏角色信息。在切换账号成功后回到选择服务器界面,请不要再次调用登录接口。
   }
   public override void onLogoutSuccess (){
       //注销成功的回调
       //游戏应该清除当前角色信息,回到登陆界面,并自动调用一次登录接口
   }
   public override void onPaySuccess (PayResult payResult){
       //支付成功的回调
       //一些渠道支付成功的通知并不准确,因此客户端的通知仅供参考,游戏发货请以服务端通知为准,不能以客户端的通知为准
   }
   public override void onPayCancel (PayResult payResult){
       //支付取消的回调
   }
   public override void onPayFailed (PayResult payResult){
       //支付失败的回调
   }
   public override void onExitSuccess (){
       //SDK退出成功的回调
       //在此处调用QuickSDK.getInstance().exitGame()函数即可实现退出游戏,杀进程。为避免与渠道发生冲突,请不要使用Application.Quit()函数
   }
}




1.2.2. 初始化(必接)

接口:void init();
功能:调用渠道SDK的初始化
案例:QuickSDK.getInstance().init();




1.2.3. 登录(必接)


接口:void login();

功能:调用渠道SDK的登录

案例:QuickSDK.getInstance().login();

1.2.4. 上传角色信息(必接)

注:需要在创建角色,进入游戏,角色升级的时候分别调用上传角色信息的接口

1.2.4.1. 创建角色时上传

接口:void createRole(GameRoleInfo gameRoleInfo);

功能:创建角色时向渠道SDK上传角色信息

案例:

GameRoleInfo gameRoleInfo = new GameRoleInfo();
gameRoleInfo.gameRoleBalance = "0";
gameRoleInfo.gameRoleID = "000001";
gameRoleInfo.gameRoleLevel = "1";
gameRoleInfo.gameRoleName = "钱多多";
gameRoleInfo.partyName = "同济会";//设置公会名称
gameRoleInfo.serverID = "1";
gameRoleInfo.serverName = "火星服务器";
gameRoleInfo.vipLevel = "1";
gameRoleInfo.roleCreateTime = "roleCreateTime";//值为10位数时间戳
gameRoleInfo.gameRoleGender = "男";
gameRoleInfo.gameRolePower ="38";//设置角色战力,必须为整型字符串
gameRoleInfo.partyId ="1100";//设置公会id,必须为整型字符串
gameRoleInfo.professionId = "11";//设置角色职业id,必须为整型字符串
gameRoleInfo.profession = "法师";//设置角色职业名称
gameRoleInfo.partyRoleId = "1";//设置角色在公会中的id
gameRoleInfo.partyRoleName = "帮主"; //设置角色在公会中的名称
gameRoleInfo.friendlist = "无";//设置好友关系列表,格式请参考:http://open.quicksdk.net/help/detail/aid/190
QuickSDK.getInstance ().createRole(gameRoleInfo);//创建角色

1.2.4.2. 进入游戏时上传

接口:void enterGame(GameRoleInfo gameRoleInfo);