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

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

    QuickSDK部署版

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

    国内发行工具

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

    海外发行工具

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

    QuickAD+ 广告追踪工具

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

    玩家维护系统

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

  • 开发者中心
    文档中心 下载中心 渠道列表 功能索引
  • 资讯动态
  • 商务合作
  • 关于我们
    公司介绍 人才招聘
  • 隐私政策
简体中文
简体中文 繁體中文 English
登录 注册
官方SDK系统-海外版
  • 新手指南
    • QuickGame自定义事件默认投递事件说明表
    • 官方SDK系统-海外版介绍
  • SDK接入文档
    • 海外版服务器接入文档
    • 海外版Android接入文档
    • 海外版Android UE接入文档
    • 海外版iOS接入文档
    • 海外版iOS UE接入文档
    • 海外版Unity 接入文档
    • 海外版Unity 2021添加assets及res说明
    • 海外版H5接入文档
    • 海外版PC游戏Web接入文档
    • 海外版PC游戏Unity接入文档
    • 海外版PC游戏UE接入文档
    • 海外版开放平台接入文档
  • 使用手册
    • 海外版产品手册
    • 海外后台配置流程
    • 海外第三方支付配置文档
    • Google后台配置文档(包含支付与登录)
    • Google谷歌支付帮助文档
    • Google谷歌支付错误码说明文档
    • Google谷歌登录常见问题
    • Facebook后台配置文档
    • H5SDK Google登录配置指南
    • H5SDK Facebook登陆配置指南
    • H5SDK Apple登录配置指南
  • 常见问题
    • GooglePlay后台怎么添加测试账号
    • Google谷歌包没有显示悬浮窗
    • 海外产品初始化失败怎么处理?
    • Facebook接入常见问题
    • QuickGameSDK海外版FAQ
  • 海外金流渠道
  • 第三方登录&数据SDK所需参数表

更新日期:2024-06-17海外版iOS接入文档

一、SDK结构 


请参照文档接入,如有疑问请参考 demo,最终以 demo 为准。 


JYouLoginKit.framework 和 SSBundle.bundle 为 SDK 核心框架和资源。 

支持平台: iPod Touch,iPhone,iPad。

系统要求:iOS9.0+。

支持框架: armv7 arm64。

环境要求: xcode12.0+ 。

 

二、注意事项 


游戏内支持购买自动订阅型商品或者需要检测苹果退款时,需做如下配置: 

在苹果后台配置服务器通知网址,URL格式为:xxx/notify/apple(其中 xxx 为厂商sdk的完整域名,必须带 https),配置示例如下图: 


 
 


另外,游戏内支持购买自动订阅型商品还需要在 QuickGame 后台产品详情里配置苹果后台的共享密钥:



获取苹果后台生成共享秘钥的入口: 



注意:订阅型商品也需要在SDK后台配置商品ID


 


三、接入步骤 

3.1.添加SDK 


将SDK文件拖放导入工程,选择正确的target 



3.2.工程配置 


在Build Settings->Linking->Other Linking Flags 中配置 -ObjC 


                               

3.3.添加系统依赖库 


支持苹果登录时需要添加:Accelerate.framework


3.4.SDK权限申请 


当支持数据统计时,如带有 Appsflyer,Adjust,FB 等数据统计SDK,需添加 ATT 权限,征得用户启用跟踪权限许可才能跟踪或访问其设备的广告标识符(即 IDFA)。 

1.调用 SDK 提供的如下接口申请 ATT 权限 

+ (void)requestTrackingAuthorization;


2.工程 info.plist 文件配置如下权限,右边的文案可自行定义 



3.5.配置SDK域名(特别重要!!!) 


找到 SDK内 SSBundle.bundle文件下 ColorStyle.plist新增/修改键值对(键为 mainurl值为请求的域名)。 


3.6.SDK初始化(必接) 


函数 : +(void)initSDKWithProductCode:(NSString*)productCode
callback:(id)initDelegate; 
功能:使用产品 id,初始化 SDK。 

参数:productCode,产品 id,必填,对接商务提供。 

初始化成功回调方法: 

// SDK 初始化成功回调
- (void)qgSDKInitDone
{
NSLog(@"初始化成功");
}

 


3.7.设置是否需要自动登录(选接) 



功能:是否启用自动登录上次登录的账号,需要在调用登录之前调用。默认开 启。 

 

3.8.登录(必接) 

 

函数 :  + (void)loginWithMenuShow
 :(BOOL)isDisplay;


功能:进入用户登录页面。需要在初始化成功之后调用,否则调用无效。游戏开始时可以调用此接口显示一个 用户登录界面。在收到用户注销回调后通常处理办法是回到游戏登录界面调用后调用此接口。


isDisplay : YES:登录自动显示浮标   NO:登录不自动显示浮标

 

3.9.快捷登录(静默登录)—按需选接 


函数 : + (void)fastlyStartGame; 

功能:不显示登录界面静默登录,如果本地没有账号将基于本设备创建一个新的游客 账号,可以在用户中心进行绑定和解绑操作、切换账号。如果调用此接口时 SDK 还没 有初始化成功,则 SDK 初始化成功时会自动调用此接口一次。快速进入游戏可以使用 此接口,用户注销后重新登录使用 login 接口。


3.10.设置登录和登出回调监听者(必接) 


函数 : + (void)setFunctionLoginCallback:(id)loginDelegate; 

功能:设置登录回调监听者然后监听者实现如下的回调方法就可以收到登录事 件: 

- (void)loginUid:(NSString *)uid userToken:(NSString *)token

{ 
NSLog(@"登录成功:n 用户 ID:%@,验证码:%@",uid,token);
} 
 
 
                               
// 用户从个人中心手动登出回调 - (void)userLogout
{ 
    NSLog(@"用户从个人中心手动登出"); 
} 
 

// 个人中心绑定回调

 - (void)bindUid:(NSString *)uid userToken:(NSString *)token type:(USERCENTER_TYPE)type;

//个人中心解绑回调

- (void)unBindUid:(NSString *)uid userToken:(NSString *)token type:(USERCENTER_TYPE)type; 

tips:  

type 解绑类型 

USERCENTER_TYPE_EMAIl = 1, //email

USERCENTER_TYPE_FB = 6, //FB 

USERCENTER_TYPE_GOOGLEPLUS = 8, //Google 

USERCENTER_TYPE_Line = 11, //Line 

USERCENTER_TYPE_GAMECENTER = 7, //

GameCenter USERCENTER_TYPE_Apple = 16, //Apple 


3.11.获取所有绑定信息—按需选接 


函数 : + (NSDictionary *)getUserBindInfo;


功能:获取用户中心的绑定信息


字典key
字典value类型
字典key注释
USERCENTER_TYPE_EMAIl
NSNumber
Email
USERCENTER_TYPE_FB
NSNumber
FaceBook
USERCENTER_TYPE_GOOGLEPLUS
NSNumber
Google 
USERCENTER_TYPE_Line
NSNumber
Line 
USERCENTER_TYPE_GAMECENTER
NSNumber
GameCenter
USERCENTER_TYPE_Apple
NSNumber
Apple

代码实例: 

 NSDICTIONARY *DIC = [REDELOGINKIT GETUSERBINDINFO];     

IF ([DIC[@"USERCENTER_TYPE_EMAIL"] BOOLVALUE]) {

         NSLOG(@""#$%&");

     } 


3.12.设置角色信息(必接) 


函数 : + (void)setGameRoleInfo:(REDeRoleInfo *)roleInfo; 

功能:设置角色信息,在选择角色进入游戏时调用。 


3.13.主动调用绑定账号—按需选接 


函数 : + (void)bindAccountType:(USERCENTER_TYPE)type; 

功能:在外部主动调用绑定账号。


3.14.获取用户ID—按需选接 


函数 : + (NSString *)userID; 

功能:获取当前登录用户的用户 ID。在用户登录成功后调用

返回值: